Sorted parameters are more difficult to read, as you normally expect
the parameters to be described in the order they are listed in the
function signature. This also breaks parameter grouping when adjacent
parameters are related (e.g. a pair of iterators).
Previously, class members and free functions in sectiondef with
kind="user-defined" would be stripped from HTML output, making function
grouping effectively non-functional. This commit fixes this by converting
such sectiondefs to either method-group or free-function-group in BoostBook
output, depending on whether the grouping is within a class or namespace.
Additionally, previously constructors, destructors and assignment operators
were not allowed to be inside method-groups, which were another reason for
these members to be stripped from the output. This commit allows these members
in member-groups and modifies DTD accordingly.
Also, this fixes duplicate constructors, destructors and assignment operators
generated after the sections for public, private and protected member
functions. This was due to applying XSL templates twice - once when generating
method-group, and then after the method-group.
This commit adds a new XSL parameter boost.sort.params, which allows
users to disable alphabetical sorting of the function and template
parameters in detailed descriptions of functions and classes. By
default, sorting is enabled, which maintains the previous behavior.
Sorting is disabled when the parameter is set to 0. In this case,
parameters are listed in the order they are listed in the BoostBook
documentation, which is normally the same as they are listed in the
function signature or template preamble.
This appears to have removed the computeroutput tags from function links in
the hash documentation. I'm not sure if the solution is to retain them in
annotation mode or to be smarted about syntax highlighting programlisting.
[SVN r86505]
class members.
function.xsl, type.xsl, utility.xsl: Added support for <access> elements to
allow nonpublic access specifiers for class member documentation.
boostbook.dtd: Updated to reflect new <access> element. Updated Peter Simons
email address. Added mention of boost license.
reference.dtdxml: Added reference documentation for new <access> element.
Removed some obsolete remarks from the description of inherit element.
reference.xml: The changes to this file were generated by applying
dtd2boostbook.xsl to the updated reference.dtdxml file.
[SVN r40555]
doxygen/doxygen2boostbook.xsl: If the string "detail::" is found in a
type or default argument, the type/argument is replaced with
"unspecified".
[SVN r20810]
(generated) <purpose> elements; just make them <simpara> elements.
annotation.xsl: Added a "purpose" mode that strips paragraph elements
for printing the purpose in a comment
function.xsl: Don't compact methods or overloaded methods.
[SVN r20499]
- Parameters can now have <description> elements
- Add function specifiers
xsl/function.xsl:
- When needed, place function return type on a separate line
- Format <description> element for parameters
- Use "spacing=boost" for variablelists used for function requirements
xsl/doxygen/doxygen2boostbook.xsl:
- Emit <description> elements for parameters when available
- Properly translate file descriptions
[SVN r18963]
- Use arabic numbering for semantic clauses
collect.xsl:
- Accept the input directory as a stylesheet parameter
doxygen2boostbook.xsl:
- Update for recent changes in the BoostBook XML format
[SVN r18242]
