Comparing formatted XML files makes the comparison less sensitive
to whitespace and newline differences between XML documents, and
also makes the subsequent diff more informative, if any differences
are found.
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.
Doxygen 1.9.1 generates enum <initializer> tags with text starting with
an equal sign ('=') followed by the enum value initializer. This sign
was copied under the BoostBook <default> tag, and BoostBook styleseets
add an equal sign of their own when converting this tag to HTML. This
resulted in duplicate equal signs in the HTML output.
This commit strips the leading equal sign from the initializer before
putting it into the <default> tag.
This should have been an established process, but for some reason it was
edited manually after initial generation.
After the change `reference.xml` can be removed from the repository, but
I left it to show that the things are working fine and the difference from
an auto-generated one are simple divergences due to manual changing
(not updated `reference.xml` with added `<purpose>` elements in 38017203f69cec3aa5f402fe8306eb1deff67b9a). Also removed the date numbers
from `dtdxml` as they were never in `xml` and seems to have no actual use,
but brings a lot of noise to `xml` differences after added auto-generation.
In the last commit I changed it to store in fast-elements with the wrong id.
Unfortunately this can't be picked up in testing, as the fallback still works
correctly. Although it didn't make any notable difference to the build time,
so maybe the fast-elements mechanism isn't needed?
