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 466535 - generate documentation as pdf
generate documentation as pdf
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
unspecified
Other All
: Normal enhancement
: 1.12
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2007-08-14 08:49 UTC by Stefan Sauer (gstreamer, gtkdoc dev)
Modified: 2009-11-26 09:37 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Stefan Sauer (gstreamer, gtkdoc dev) 2007-08-14 08:49:03 UTC 
add rules to gtkdoc.make to produce pdf files.
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2007-08-17 12:48:55 UTC 
Some pointers:

http://sagehill.net/docbookxsl/ToolsSetup.html

xmlto --skip-validation pdf tester-docs.sgml
fails :/

xsltproc --output tester-docs.fo --nonet --xinclude --stringparam gtkdoc.bookname tester --stringparam gtkdoc.version "1.9" /usr/share/xml/docbook/stylesheet/nwalsh/fo/docbook.xsl ./tester-docs.sgml

xmlto pdf tester-docs.fo

also fails :/

both create an intermediate tex document that has errors.
Comment 2 Philip Withnall 2008-03-11 23:02:37 UTC 
Running dblatex on the SGML file works for me, as per http://tecnocode.co.uk/2008/02/25/building-pdfs-of-documentation/. A custom LaTeX style file would probably have to be created, though.
Comment 3 Stefan Sauer (gstreamer, gtkdoc dev) 2009-02-23 09:52:44 UTC 
svn trunk has gtkdoc-mkpdf, the makefile changes and configure options to selected the wanted formats. pdf generation is still way far from perfect due to limmitations in the used tools.
Comment 4 Stefan Sauer (gstreamer, gtkdoc dev) 2009-11-26 09:37:23 UTC 
I'll close this as fixed. Making pdfs using dblatext is kind of okay for most docs and new versions of dblatex.