You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
/**
* Doxygen does not preserve the type attribute of ordered lists:
*
* <ol type="a">
* <li>an item</li>
* <li>another item</li>
* <li>yet another item</li>
* </ol>
*/
public class Test {}
It is now impossible to know that the author intended alphabetical numbering. This can become an issue if the text references list items by their letter rather than by number.
Expected behavior
I expect the xml output to preserve the type attribute of html's ol tag, e.g. like this
To Reproduce
Find a Java file and doxygen config attached. The issue is demonstrated like mentioned above.
After running doxygen on the example, the files in the subfolder xml contain the snippet shown above. issue_javadoc_ol_type.zip
Version
Tested with doxygen clone from 2021-04-11:
LSB Version: core-9.20160110ubuntu0.2-amd64:core-9.20160110ubuntu0.2-noarch:security-9.20160110ubuntu0.2-amd64:security-9.20160110ubuntu0.2-noarch
Distributor ID: LinuxMint
Description: Linux Mint 18 Sarah
Release: 18
Codename: sarah
Additional context
A situation where this issue is relevant occurs in the Java standard library in java.util.ServiceLoader:
...
* <pre>{@code
* ServiceLoader<CodecFactory> loader = ServiceLoader.load(CodecFactory.class);
* Set<CodecFactory> pngFactories = loader
* .stream() // Note a below
* .filter(p -> p.type().isAnnotationPresent(PNG.class)) // Note b
* .map(Provider::get) // Note c
* .collect(Collectors.toSet());
* }</pre>
* <ol type="a">
* <li> A stream of {@code Provider<CodecFactory>} objects </li>
* <li> {@code p.type()} yields a {@code Class<CodecFactory>} </li>
* <li> {@code get()} yields an instance of {@code CodecFactory} </li>
* </ol>
...
The text was updated successfully, but these errors were encountered:
…rved (in xml)
The problem was a bit deeper, it was also valid for other output formats.
Implemented the `type` and `start` attribute for all relevant output types.
This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.9.2.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).
Describe the bug
Processing Java code
results in the following xml:
It is now impossible to know that the author intended alphabetical numbering. This can become an issue if the text references list items by their letter rather than by number.
Expected behavior
I expect the xml output to preserve the type attribute of html's
ol
tag, e.g. like thisTo Reproduce
Find a Java file and doxygen config attached. The issue is demonstrated like mentioned above.
After running doxygen on the example, the files in the subfolder
xml
contain the snippet shown above.issue_javadoc_ol_type.zip
Version
Tested with doxygen clone from 2021-04-11:
lsb_release -a
:Additional context
A situation where this issue is relevant occurs in the Java standard library in
java.util.ServiceLoader
:The text was updated successfully, but these errors were encountered: