Coder Social home page Coder Social logo

Comments (3)

albert-github avatar albert-github commented on June 10, 2024

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.

hcw70 avatar hcw70 commented on June 10, 2024

doxyg-bug-10756.zip

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.

hcw70 avatar hcw70 commented on June 10, 2024

IMHO "kindref=member" is set, one may expect to find that id under a memberdef, not a enum def.

So either

  1. add a "kindref=enumvalue" or
  2. 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)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.