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 782373 - Unclear how to suppress periods from ending brief description (JAVADOC_AUTOBRIEF)
Unclear how to suppress periods from ending brief description (JAVADOC_AUTOBR...
Status: RESOLVED OBSOLETE
Product: doxygen
Classification: Other
Component: documentation
1.8.9.1
Other Linux
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
[moved_to_github]
Depends on:
Blocks:
 
 
Reported: 2017-05-09 09:15 UTC by morinim
Modified: 2018-07-30 10:01 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description morinim 2017-05-09 09:15:59 UTC
According to Doxygen manual:

1.
> To enable this behavior you should set JAVADOC_AUTOBRIEF to YES in the
> configuration file. If you enable this option and **want to put a dot in the
> middle of a sentence without ending it, you should put a backslash and a space
> after it**. Here is an example:
>
>  /** Brief description (e.g.\ using only a few words). Details follow. */

(Doxygen Manual - Documenting the code - Examples: http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html#docexamples)

2.
> This command writes a dot (.) to the output. **This can be useful to prevent
> ending a brief description when JAVADOC_AUTOBRIEF is enabled** or to prevent
> starting a numbered list when the dot follows a number at the start of a line.

(Doxygen Manual - Special Commands - \. : https://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdchardot)

The second method doesn't seem to work (the first one is ok).

Also take a look at: http://stackoverflow.com/q/29178465/3235496
Comment 1 André Klapper 2018-07-30 10:01:54 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!