GNOME Bugzilla – Bug 784032
Generated man pages "NAME" section is wrong in 1.8.13
Last modified: 2018-07-30 10:34:23 UTC
For this piece of code: --- /** \page foo brief description \section description DESCRIPTION Full description. */ --- Doxygen 1.8.13 generates a wrong man page (the NAME section is wrong): --- NAME foobrief description - --- Using Doxygen 1.8.12 the result was correct: --- NAME foo - brief description ---
Interestingly the page definition treats the title a bit differently than, for example, a group. In the man page, for a page definition, the title is appended with a - after the name. For a group the title is ignored. If the definition has a title and a \brief, then both are concatenated after the -, which is a bit weird. Either way this is my fault for overlooking the title print for a page definition. Will try to see if I can come up with a logical solution to the title + brief combination.
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!