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 448637 - Convert comment in gtkmenushell.c into docs
Convert comment in gtkmenushell.c into docs
Status: RESOLVED FIXED
Product: gtk+
Classification: Platform
Component: Documentation
unspecified
Other Linux
: Normal normal
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks:
 
 
Reported: 2007-06-18 00:59 UTC by Matthias Clasen
Modified: 2013-08-14 08:55 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
convert comment to gtk-doc comment (6.65 KB, patch)
2012-11-15 20:10 UTC, David King 		committed Details | Review

Description Matthias Clasen 2007-06-18 00:59:51 UTC 
gtkmenushell.c contains a long comment explaining concepts and signals 
in the menu system. It would be nice to turn that into api docs. The
concepts part should probably go into the long description of one of the
menu classes, e.g GtkMenuShell, and the signal docs should be moved to the 
individual signals.
Comment 1 David King 2012-11-15 20:10:47 UTC 
Created attachment 229089 [details] [review]
convert comment to gtk-doc comment

I moved the terminology comment to the GtkMenuShell description, under a new "Terminology" section. I shuffled most of the other comments to the respective places (functions) in the implementation, as that seemed to be where they belonged.
Comment 2 Matthias Clasen 2013-08-13 22:32:47 UTC 
Review of attachment 229089 [details] [review]:

looks good to me
Comment 3 David King 2013-08-14 08:55:15 UTC 
Comment on attachment 229089 [details] [review]
convert comment to gtk-doc comment

Thanks, pushed to master as commit 1e3e123c17c37055c097fbf8448c9a883cfc37a0.