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 506243 - multi-line '///' comment incorrectly parsed in presence of '*/'
multi-line '///' comment incorrectly parsed in presence of '*/'
Status: RESOLVED OBSOLETE
Product: doxygen
Classification: Other
Component: general
1.5.4
Other All
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
[moved_to_github]
Depends on:
Blocks:
 
 
Reported: 2007-12-29 13:06 UTC by Konstantin Serebryany
Modified: 2018-07-30 10:25 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Mixing /// with */ makes doxygen ignore the file (21.86 KB, application/gzip)
2012-11-23 12:55 UTC, Michel D'HOOGE
Details

Description Konstantin Serebryany 2007-12-29 13:06:51 UTC
Please describe the problem:
If I have a two-line '///' comment which has '*/' in the second line, it is interpreted as comment terminator.

% ls
Doxyfile  b.h
% head *
==> Doxyfile <==
INPUT=b.h
PROJECT_NAME=FOO
GENERATE_HTML=YES
GENERATE_LATEX=NO

==> b.h <==
  /// @file b.h

  /// Two-line comment,
  /// second line has misleading */ comment terminator.
  void AAAAA();
% doxygen > /dev/null 2>&1
% lynx -dump html/b_8h.html
...
Functions

   comment terminator *void  [4]AAAAA ()
...
Function Documentation

   comment terminator* void AAAAA (  )

   Two-line comment, second line has misleading

Steps to reproduce:


Actual results:


Expected results:


Does this happen every time?


Other information:
Comment 1 Michel D'HOOGE 2012-11-23 12:54:06 UTC
I have a similar problem... with version 1.8.1.2

If the following line is present in a PHP file, the file is parsed but completely ignored. After removing the end-of-comment, doxygen works as expected.

  /// \name Test name */

See attached sample.
Comment 2 Michel D'HOOGE 2012-11-23 12:55:02 UTC
Created attachment 229723 [details]
Mixing /// with */ makes doxygen ignore the file
Comment 3 André Klapper 2018-07-30 10:25:27 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!