This is the mail archive of the
cygwin-patches
mailing list for the Cygwin project.
Re: doc: use xmlto pdf
On Fri, 2010-06-25 at 23:14 +0200, Corinna Vinschen wrote:
> The reason that I changed that to docbook2pdf at one point was that
> creating a PDF from the docs never worked for me before.
>
> And with your patch it also doesn't work for me on two different Linux
> systems with different xmlto versions (0.0.18 and 0.0.23). Here's what
> happens on Fedora 13, the result is practically the same on the older
> system. Maybe you know a solution?
I was able to duplicate this on a linux VM; it appears to be a problem
with the passivetex backend. If I force the dblatex backend, then it
works, but requires xmlto >= 0.0.21[1]. Could you try the attached
patch instead?
Yaakov
[1] 0.0.21 is shipped in F-10, Debian squeeze, Ubuntu 9.10, and newer.
2010-06-25 Yaakov Selkowitz <yselkowitz@users.sourceforge.net>
* Makefile.in: Use "xmlto pdf" instead of docbook2pdf.
Force the dblatex backend, as the default passivetex does not work.
* README: Remove docbook-utils and update docbook-xml deps.
* faq-programming.xml: Ditto.
Index: Makefile.in
===================================================================
RCS file: /cvs/src/src/winsup/doc/Makefile.in,v
retrieving revision 1.26
diff -u -r1.26 Makefile.in
--- Makefile.in 26 Jan 2010 16:16:19 -0000 1.26
+++ Makefile.in 25 Jun 2010 19:24:52 -0000
@@ -17,7 +17,7 @@
CC_FOR_TARGET:=@CC@
exeext:=@build_exeext@
-XMLTO:=xmlto --skip-validation
+XMLTO:=xmlto --skip-validation --with-dblatex
include $(srcdir)/../Makefile.common
@@ -56,7 +56,7 @@
# Some versions of jw hang with the -o option
cygwin-ug-net/cygwin-ug-net.pdf : cygwin-ug-net.sgml
- -cd cygwin-ug-net && docbook2pdf ../$<
+ -${XMLTO} pdf -o cygwin-ug-net/ $<
cygwin-ug-net.sgml : cygwin-ug-net.in.sgml ./doctool Makefile
-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
@@ -65,7 +65,7 @@
-${XMLTO} html -o cygwin-api/ -m $(srcdir)/cygwin.dsl $<
cygwin-api/cygwin-api.pdf : cygwin-api.sgml
- -cd cygwin-api && docbook2pdf ../$<
+ -${XMLTO} pdf -o cygwin-api/ $<
cygwin-api.sgml : cygwin-api.in.sgml ./doctool Makefile
-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
Index: README
===================================================================
RCS file: /cvs/src/src/winsup/doc/README,v
retrieving revision 1.2
diff -u -r1.2 README
--- README 2 Feb 2010 01:02:49 -0000 1.2
+++ README 25 Jun 2010 19:24:52 -0000
@@ -7,8 +7,7 @@
bzip2
coreutils
cygwin
-docbook-utils
-docbook-xml42
+docbook-xml45
docbook-xsl
gzip
make
Index: faq-programming.xml
===================================================================
RCS file: /cvs/src/src/winsup/doc/faq-programming.xml,v
retrieving revision 1.15
diff -u -r1.15 faq-programming.xml
--- faq-programming.xml 2 Feb 2010 01:18:03 -0000 1.15
+++ faq-programming.xml 25 Jun 2010 19:24:53 -0000
@@ -420,7 +420,7 @@
<literal>perl</literal>, and <literal>cocom</literal>. If you want to run
the tests, <literal>dejagnu</literal> is also required.
Normally, building ignores any errors in building the documentation,
-which requires the <literal>docbook-utils</literal>, <literal>docbook-xml42</literal>, <literal>docbook-xsl</literal>, and
+which requires the <literal>docbook-xml45</literal>, <literal>docbook-xsl</literal>, and
<literal>xmlto</literal> packages. For more information on building the
documentation, see the README included in the <literal>cygwin-doc</literal> package.
</para>