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 612504 - Convert GTK+ Tutorial to gnome-doc-utils
Convert GTK+ Tutorial to gnome-doc-utils
Status: RESOLVED OBSOLETE
Product: gtk+
Classification: Platform
Component: Documentation
unspecified
Other All
: Normal enhancement
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on: 605333
Blocks:
 
 
Reported: 2010-03-10 21:29 UTC by Claude Paroz
Modified: 2011-01-04 16:11 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
GTK+ Tutorial in XML DocBook (536.85 KB, text/plain)
2010-03-10 21:29 UTC, Claude Paroz 		Details
Possible omf.in file (289 bytes, text/plain)
2010-03-10 21:31 UTC, Claude Paroz 		Details

Description Claude Paroz 2010-03-10 21:29:34 UTC 
Created attachment 155785 [details]
GTK+ Tutorial in XML DocBook

Currently, the GTK+ tutorial is in sgml format. It would be nice if it were in DocBook XML, also to be able to easily translate it. Attached is the XML version of the current sgml file.
Comment 1 Claude Paroz 2010-03-10 21:31:45 UTC 
Created attachment 155787 [details]
Possible omf.in file
Comment 2 Christian Dywan 2010-03-11 09:21:41 UTC 
Please wait until bug 605333 is resolved, since it contains a number of patches against the tutorial.
Comment 3 Claude Paroz 2010-04-22 18:22:57 UTC 
My patch is now in master.
http://git.gnome.org/browse/gtk+/commit/?id=4d1cf25080c2208936580667df544e14638db06f
I'm keeping the bug open until someone can verify that the document can be properly built with gnome-doc-utils.
Comment 4 Claude Paroz 2010-04-22 19:14:48 UTC 
Patch reverted, waiting for approval of gnome-doc-utils dependency.
Comment 5 Stefan Sauer (gstreamer, gtkdoc dev) 2010-04-22 20:10:56 UTC 
hmm, I would merge that tutorial to gtk's api docs (like is has been done for gobject tutorial some years ago).

The benefit is that it would then be xref'ed with the api docs and there is no gnome-doc-utils dependency. Also developers would find it in devhelp. Not sure how many people look in yelp for developer guides.
Comment 6 Claude Paroz 2010-04-22 20:32:39 UTC 
My interest with the g-d-u toolchain is the ability to translate it. I'm afraid it might be difficult to do it if it is in the api docs, right?
Comment 7 Stefan Sauer (gstreamer, gtkdoc dev) 2010-04-23 15:48:57 UTC 
Yes. Gtk-doc documents are just docbook xml documents as well. So far noone has tried to translate them.
Comment 8 Matthias Clasen 2011-01-04 16:11:12 UTC 
the tutorial has been dropped from gtk3