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 651850 - @defgroup generates manpage warning.
@defgroup generates manpage warning.
Status: RESOLVED OBSOLETE
Product: doxygen
Classification: Other
Component: general
1.7.4
Other Linux
: Normal major
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
[moved_to_github]
Depends on:
Blocks:
 
 
Reported: 2011-06-04 12:19 UTC by Mattias Ellert
Modified: 2018-07-30 10:04 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
An attempt at a patch that addresses the problem. (7.78 KB, patch)
2011-06-04 12:19 UTC, Mattias Ellert 		none Details | Review

Description Mattias Ellert 2011-06-04 12:19:53 UTC 
Created attachment 189210 [details] [review]
An attempt at a patch that addresses the problem.

A declaration like

@groupdef mygroup My Group

generates a man page that displays as

NAME
       My Group -

This is badly formed and causes manpage-has-bad-whatis-entry warnings from lintian.

See: http://lintian.debian.org/tags/manpage-has-bad-whatis-entry.html

A better and more compliant rendering would be:

NAME
       mygroup - My Group

An attempt at a patch that addresses the problem is attached.
Comment 1 Mattias Ellert 2014-08-31 17:31:04 UTC 
https://github.com/doxygen/doxygen/pull/213
Comment 2 André Klapper 2018-07-30 10:04:01 UTC 
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!