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 598497 - Doxygen throws undesirable [read][write] attribute into output documentation
Doxygen throws undesirable [read][write] attribute into output documentation
Status: RESOLVED OBSOLETE
Product: doxygen
Classification: Other
Component: build
1.5.9
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2009-10-14 21:59 UTC by Lori Boyters
Modified: 2010-10-28 13:28 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Lori Boyters 2009-10-14 21:59:24 UTC
Sent problem to Dimitri, who determined that this is a bug (see email below). Although I was using Doxygen 1.6.1, it also occurs in Doxygen 1.5.9, which is the desired version we wish this fix to be in. Also, is there a way to install this as a patch to Doxygen 1.5.9 as we don't want to upgrade to the later versions of Doxygen.

Thanks,


Hi Lori,

On Mon, Sep 28, 2009 at 03:50:00PM -0700, Boyters, Lori wrote:
> Hey again Dimitri, I put together a small sample of what we are receiving in our output documentation (HTML) that is undesirable, to see if you have any suggestions on how to turn this off.
> 
> I'm using Doxygen 1.6.1 on Windows XP.
> The developer was able to run this using Doxygen 1.5.1 and does not receive the [read] [write] attributes, but I don't want to go back to that version as we need many of the new features and fixes in the later Doxygen versions.
> BTW I did find the [read] attribute in the LaTeX file as 
> \mbox{[}read\mbox{]} - which is why I couldn't find it before when I searched for "[read]"-thanks for the hint on that.
> As a Workaround, I'll need to strip out the string in the .tex files prior to running the PDF, but this goes against our goal to have a single source automated documentation process.
> 
> Look forward to your response.

You found a bug!

Can you file it in the bug tracker? That way you will be notified when it is fixed and I don't forget about it.

Regards,
  Dimitri
Comment 1 Dimitri van Heesch 2009-10-15 19:20:47 UTC
Confirmed. Should be fixed in the latest SVN snapshot already.
Comment 2 Dimitri van Heesch 2009-12-30 13:38:31 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.6.2. Please verify if this is indeed the case and reopen the
bug if you think it is not fixed (include any additional information that you
think can be relevant).
Comment 3 Lori Boyters 2010-05-24 22:46:00 UTC
Have the same issue with [static]. Refer to the attached header file and PDF, paragraph 8.2.2.1, page 21.
Comment 4 Lori Boyters 2010-05-24 22:54:45 UTC
Same issue with [private] and [virtual]
Comment 5 Dimitri van Heesch 2010-06-05 12:58:45 UTC
Hi Lori, the function in 8.2.2.1 is static, so the [static] qualifier is correct here. Probably the same holds for the others?

I get the idea that you do not want to see any qualifier at all.
There is no option to disable them however.

For C++ these are quite handy as the declaration alone is not enough to see what attributes (like [virtual], [private], [protected], [static]) a member has.
For C code it is less relevant, since there a static function is already marked as such. I just added the qualifiers there as well for consistency reasons.
Comment 6 Tobias Mueller 2010-10-28 13:21:35 UTC
Assuming this to be OBSOLETE based on comment #5. Please reopen if this is not the case. Thanks in advance.
Comment 7 Dimitri van Heesch 2010-10-28 13:28:04 UTC
Hi Tobias,

I'm not sure what you mean with your remark. 

If you think there is still a problem please attach a self-contained example and a clear description and I'll reopen the bug report (alternatively, you could also file a new one).