After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 661292 - referencing the main page uses index with tree view enabled
referencing the main page uses index with tree view enabled
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: documentation
1.7.5.1
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2011-10-09 00:29 UTC by Stefan
Modified: 2012-01-09 09:48 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Stefan 2011-10-09 00:29:31 UTC 
According to the docs one should use main to reference the main page if the tree view is enabled.
This was the case till v1.7.4, but starting with v1.7.5.1 I had to change "/ref main" to "/ref index" even with "GENERATE_TREEVIEW = YES".

Must the docs be corrected or is this a bug?

quote from /mainpage topic:
<quote>
You can refer to the main page using \ref index (if the treeview is disabled, otherwise you should use \ref main).
</quote>

Personally I think it would be better to have only one way to reference the main page, so in any case one would need to use "/ref index", which seems to be the case now.

Thanks in advance,
Stefan
Comment 1 Dimitri van Heesch 2011-10-09 15:24:31 UTC 
Indeed. I'll correct the documentation.
Comment 2 Dimitri van Heesch 2011-12-03 18:22:57 UTC 
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.6. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant.
Comment 3 Stefan 2012-01-09 09:48:41 UTC 
Fix confirmed.