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 125785 - gtkdoc doc
gtkdoc doc
Status: VERIFIED NOTABUG
Product: conglomerate
Classification: Other
Component: Documentation
unspecified
Other All
: Normal normal
: ---
Assigned To: conglomerate list
conglomerate list
Depends on:
Blocks: 123318 123360 125646 125736 125787
 
 
Reported: 2003-10-29 16:19 UTC by Geert Stappers
Modified: 2009-08-15 18:40 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
uss scripts "Stappers" style, safer, better (7.03 KB, patch)
2003-11-02 21:09 UTC, Varga Robert 		none Details | Review
doc/reference/ files generated using the previous patch. (308.98 KB, patch)
2003-11-02 21:10 UTC, Varga Robert 		none Details | Review

Description Geert Stappers 2003-10-29 16:19:22 UTC 
(This bug is registered as concentration point on serval gtkdoc problems.)

I can't find proper gtkdoc documentation.

Please hit me with a URL
Comment 1 Geert Stappers 2003-10-29 16:25:33 UTC 
This one blocks bug# 125787
Comment 2 Geert Stappers 2003-10-29 17:06:57 UTC 
Bugs #123318, #125360, #125646, #125702, #125787 were caused by
the missing documentation.
Comment 3 Geert Stappers 2003-11-02 08:21:09 UTC 
And recently bug 126019 also.
Comment 4 Varga Robert 2003-11-02 21:04:48 UTC 
As far as I can tell, there is no documentation for gtk-doc, other
than /usr/share/doc/gtk-doc-0.10 (RedHat 9.0) and the mailinglist
(http://mail.gnome.org/mailman/listinfo/gtk-doc-list).

The next 2 patches should fix the 'make'-related bugs.
Comment 5 Varga Robert 2003-11-02 21:09:20 UTC 
Created attachment 21137 [details] [review]
uss scripts "Stappers" style, safer, better
Comment 6 Varga Robert 2003-11-02 21:10:53 UTC 
Created attachment 21138 [details] [review]
doc/reference/ files generated using the previous patch.
Comment 7 Geert Stappers 2003-11-03 10:20:55 UTC 
( will send comments on the patches to conglomerate-developers ML )
Comment 8 Geert Stappers 2003-11-03 10:29:42 UTC 
Okay, file://usr/share/doc is a nice URL, thanks.
Comment 10 Paul Smith 2003-11-03 11:14:03 UTC 
Specifically, doc/gnome.txt in the above CVS repository looks good:

http://cvs.gnome.org/bonsai/cvsblame.cgi?file=gtk-doc%2Fdoc/gnome.txt&rev=&root=/cvs/gnome

Alarmingly, I also found this in doc/setting_up.txt:

That's it! If you now build the application or library you should get
a complete set of documentation. (Note that due to make being awkward
the build may fail the first time, but if you run make again it should
work.)
Comment 11 Geert Stappers 2003-11-03 21:48:27 UTC 
Found the line in doc/setting_up.txt:

   but if you run make again it should work



Alarming, really alarming. I want to use F-words.
Comment 12 Geert Stappers 2004-07-02 16:40:50 UTC 
We have the documentation: file://usr/share/doc/gtk-doc-tools
and bug 145292 allows me to close this old P.I.T.A.