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 615935 - [RFC] how to present protected symbols
[RFC] how to present protected symbols
Status: RESOLVED OBSOLETE
Product: gtk-doc
Classification: Platform
Component: general
unspecified
Other Linux
: Normal enhancement
: ---
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2010-04-16 08:34 UTC by Stefan Sauer (gstreamer, gtkdoc dev)
Modified: 2018-05-22 13:03 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
make protected fileds visible (2.22 KB, patch)
2010-04-16 08:46 UTC, Stefan Sauer (gstreamer, gtkdoc dev)
none Details | Review

Description Stefan Sauer (gstreamer, gtkdoc dev) 2010-04-16 08:34:09 UTC
In compond types (structs, enums, ..) one can use scope markers as
/*< public >*/
/*< protected >*/
/*< private >*/

Right now we strip all non public ones from the docs. That leads to warnings about unused documentation, if people have documented them.
If we show the protected ones in the docs as well, do we need a special presentation for them or is the presence of the marker in the verbative copy of the declaration enough?
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2010-04-16 08:46:59 UTC
Created attachment 158875 [details] [review]
make protected fileds visible

Unfortunately the scope comments are not part declaration code block in the docs. So we need some indication of the scope.
Comment 2 GNOME Infrastructure Team 2018-05-22 13:03:41 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/gtk-doc/issues/11.