[Doxygen-users] External Documentation Linking Questions?

[Mark <dox...@er...>]

1. How to reference external documentation from a user tab?

I am attempting to use a tag file to reference an external doxygen-generated doc. References within Doxygen generated pages are working. E.g., my @mainpage content includes "@ref history". This link correctly links to the document listed in TAGFILES, i.e., it has

    href="../../ktxtools/html/toktx.html#history”. 

On the other hand I have a custom DoxygenLayout.xml with a user tab

        <tab type="user" url="@ref synopsis" title="KTX Tools”/>

where synopsis is another anchor in the same tag file as history. However in this case the relative path to the external document is missing. navtreedata.js contains 
   
    [ "KTX Tools", "toktx.html#synopsis", null ],

which becomes the value of the href in the generated treeview pane.

How can I get this reference to properly include the relative path? I do not want to have to manually add it to my user tabs. It’s too error prone with multiple files to change if the document paths are ever changed.

2. How to disambiguate tags with the same name?

I’m actually referencing 2 external documents. Some of the section names appear in both documents. Is there some way in the @ref command to use the name of the document (project) as part of the anchor identification to disambiguate these?

Regards

    -Mark