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 153379 - recognizing end-of-line comments
recognizing end-of-line comments
Status: RESOLVED NOTABUG
Product: doxygen
Classification: Other
Component: general
1.3.x
Other Linux
: Low minor
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2004-09-22 05:29 UTC by Matthias Klose
Modified: 2008-11-08 16:13 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Matthias Klose 2004-09-22 05:29:50 UTC
[forwarded from http://bugs.debian.org/195991]

Package: doxygen
Version: 1.3-rc3-1
Severity: wishlist

I noticed that doxygen doesn't recognize the intention of comments like

struct foo
{

private:
	int m_var;	/// Member variable

	typedef int foo_t;
};

Okay, so far so good.  The member variable is private and I don't really
need it to be in the generated documentation.  What I found more annoying 
was that in the example above, I did get something like this in the
output HTML:

	Typedefs

		typedef int foo_t;
			Member variable

Perhaps it would make more sense to either:

1. Recognize end-of-line comments, or
2. Ignore comments separated by one or more lines from the following
declaration.
Comment 1 Matthijs Kooijman 2008-11-04 20:07:19 UTC
Considering that doxygen supports ///< exactly for this case, is this really a bug?

(I'm also adding the original reporter of the Debian bug to the CC)
Comment 2 Dimitri van Heesch 2008-11-08 16:13:21 UTC
I agree that this is not a bug.