GNOME Bugzilla – Bug 759275
Stray hyphen in man-page output with BRIEF_MEMBER_DESC=no
Last modified: 2018-07-30 10:32:35 UTC
With: HIDE_UNDOC_MEMBERS = no BRIEF_MEMBER_DESC = no GENERATE_MAN = yes The man page output starts with: NAME ns::foo - from the source: .SH NAME ns::foo \- When the BRIEF_MEMBER_DESC is not shown the hyphen should probably not be present.
After trying some different options and thinking about this further, I think the NAME at the top of the man page should always include the brief descrption for the class, so should completely ignore the value of BRIEF_MEMBER_DESC. Man pages are supposed to start with: NAME foo - a brief description and the description for the class is not a MEMBER desc anyway, because it's not a member, so should not be affected by BRIEF_MEMBER_DESC.
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!