After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 640742 - combine.xslt indent attribute should probably be set to "no"
combine.xslt indent attribute should probably be set to "no"
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
unspecified
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2011-01-27 17:26 UTC by Ray Lefuel
Modified: 2012-11-18 11:12 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Ray Lefuel 2011-01-27 17:26:16 UTC
The Doxygen XML output is formatted so that indent="no" but, in combine.xslt, indent="yes".

If you were to use a tool that can interpret indent="yes" such as Saxon9 (Note: xsltproc automatically assumes indent="no"), the combined XML output is altered from the original Doxygen-generated XML output.

For example, I have the following sample code preformatted in the original Doxygen-generated XML output:

<preformatted>
 // Descriptive text.</preformatted></para><para><preformatted> <ref refid="interfacesample_1_1apiversion12_1_1NewConfig" kindref="compound">NewConfig</ref> nc;</preformatted></para><para><preformatted> nc = conn.prepareConfig();
 nc.run();</preformatted></para><para><preformatted> nc = conn.prepareConfig(sample.txt);
 nc.run();
 </preformatted>

If indent="no", the Doxygen-formatted text is preserved as-is.  If indent="yes" (and you don't use xsltproc), the text is altered to the following format in the combined XML file:

        <preformatted>
 // Descriptive text.</preformatted>
    </para>
    <para>
        <preformatted> 
            <ref refid="interfacesample_1_1apiversion12_1_1NewConfig" 
                kindref="compound">NewConfig</ref> nc;</preformatted>
    </para>
    <para>
        <preformatted> nc = conn.prepareConfig();
nc.run();</preformatted>
    </para>
    <para>
        <preformatted> nc = conn.prepareConfig(sample.txt);
nc.run();</preformatted>

I recently switched from xsltproc to Saxon9.  After running xsl transformations on the combined output, extra white-space and hard breaks were found in the final doc output.  I'm currently overwriting the Doxygen-created combine.xslt prior to running Saxon9 on it; I now get the same results as I did with xsltproc.
Comment 1 Dimitri van Heesch 2011-01-29 13:10:08 UTC
I'll set the indent to no.
Comment 2 Dimitri van Heesch 2011-03-28 14:19:28 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.4. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.