[Doxygen-users] Problem Report: Hyperlinks to Local References Create Additional Tree Controls

[Scott H. <sc...@ha...>]

Problem:
If you set "GENERATE_TREEVIEW=YES" and have a page with local references 
(\ref), when HTML is generated the links are relative to the index.html 
page rather than to the local page.  When you click on the resulting 
link, you get an extra tree control instead of jumping to that link.

Test Case:
Below, I've attached a simple file that reproduces the problem.  Save 
the contents as foo.txt.  Generate a default Doxyfile and alter the 
following settings:
   INPUT                  = test.txt
   GENERATE_TREEVIEW      = YES

Run Doxygen and launch html/index.html.  Click on either of the 
hyperlinks in section Two.  Every time you click on a link in section 
Two, an additional tree control will be displayed.

Analysis:
The index page is really a frameset containing a "treefrm" frame to 
display the tree control, and a "basefrm" frame to display the main.html 
page.  The hyperlinks in section Two are defined relative to index.html 
rather than to main.  (e.g. <a href="index.html#one">One</a>)  Clicking 
on this link causes a new index.html frameset to be nested within the 
"basefrm" frame.

Editing the main.html file and changing the links to be relative to the 
page displayed in the "basefrm" frame instead of the frameset fixes the 
problem (e.g. <a href="main.html#one">One</a>)

I'm guessing the problem is not in HtmlGenerator, but in the code that 
calls writeSectionRef() and writeSectionRefItem().  They must be passing 
in the name of the frameset ("index.html") rather than the name of the 
page currently displayed in the basefrm.

Fix:  To Be Determined...

---------------------test.txt-------------------------
/*!
\mainpage Tree Test

\section one One
This is section one.

\section two Two
This is section Two.  It has a reference to section \ref one, and a 
reference to section \ref three.

\section three Three.
This is section Three.
*/