Comments (3)
It is hard to tell, for me, what the original idea was behind the different kind
's and how they are linked together.
I see that in the index.xml there are members with tag name member that have the kind
as expected, wouldn't the idea be to link through that way?
I see that your (formatted) output snippets are not coming directly from the shown example code.
- Please adjust the output snippets so they are conform the shown code.
- Can you please attach a, small, self contained example (source+configuration file in a, compressed, tar or zip file!) that allows us to reproduce the problem? Please don't add external links as they might not be persistent (also references to GitHub repositories are considered non persistent).
from doxygen.
Attached minimal example.
See file _driver_events_8h.xml from programlisting which contains the wrong ref:
<codeline lineno="18" refid="namespace_i_o_driver_1a374da6d884eb61d75a619a86cb8c928ea7cd4e33a0c5653d01920c76fa625b097" refkind="member"><highlight class="normal"><sp/><sp/><sp/><sp/><sp/><sp/><sp/><sp/><ref refid="namespace_i_o_driver_1a374da6d884eb61d75a619a86cb8c928ea7cd4e33a0c5653d01920c76fa625b097" kindref="member">DRIVER_EVENT_NONE</ref><sp/>=<sp/>0,<sp/><sp/><sp/><sp/><sp/></highlight></codeline>
See file namespace_i_o_driver.xml containing the enum definition by that id:
<enumvalue id="namespace_i_o_driver_1a374da6d884eb61d75a619a86cb8c928ea7cd4e33a0c5653d01920c76fa625b097" prot="public">
<name>DRIVER_EVENT_NONE</name>
from doxygen.
IMHO "kindref=member" is set, one may expect to find that id under a memberdef, not a enum def.
So either
- add a "kindref=enumvalue" or
- let the ref really point to the id of the containing member (the whole enum definition).
IMHO the option 1) would be much cleaner, since it would link the enum literal in the source listing to the enum literal definition with its description.
from doxygen.
Related Issues (20)
- Failed to build "master" branch HOT 9
- Spurious links generated for C++ keywords and template parameters HOT 3
- Explicit C# event mistaken for property HOT 3
- Create ALIAS with argument for plantUML graph HOT 3
- Type alias definition in class template linked to name in incorrect scope
- Enumeration details are not added in html for all enumerations HOT 1
- Luals2dox: Filter for Lua files
- `param[dir]` doesn't work HOT 3
- Update libclang version in doxygen binaries HOT 1
- Absolute path names of markdown files leak into html output if they are outside of CWD HOT 4
- ! LaTex Error: File 'topics.text' not found HOT 3
- Flagging need for documentation of C++ deprecations through warnings HOT 1
- Use of text/xhtml content type is not standardized HOT 1
- Snippet in same file to share docs HOT 4
- [feature request] need @copyparam HOT 1
- Feature request: verbatim documentation comments in XML output HOT 2
- Inconsistencies on use of separating space before an [ or { in documentation and examples HOT 10
- Generating documentation for Qt-slots HOT 1
- member variable with type annotation and not used anywhere of python class is missed HOT 3
- Duplicate (double) documentation generated for friend function HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from doxygen.