--- a/src/doc/user/xmlmake.sh
+++ b/src/doc/user/xmlmake.sh
@@ -1,16 +1,21 @@
#!/bin/sh
# A script to produce the Recoll manual with an xml toolchain.
+# Tools used:
+# - xsltproc
+# - The docbook-xsl styleets
+# - dblatex for producing the PDF.
+#
# Limitations:
# - Does not produce the links to the whole/chunked versions at the top
# of the document
-# - The anchor names from the source text are converted to uppercase by
-# the sgml toolchain. This does not happen with the xml toolchain,
-# which means that external links like
-# usermanual.html#RCL.CONFIG.INDEXING won't work because fragments are
-# case-sensitive. This could be solved by converting all ids inside the
-# source file to upper-case.
-# - No simple way to produce pdf
+# - The anchor names from the source text are converted to uppercase
+# by the sgml toolchain. This does not happen with the xml
+# toolchain, which means that external links like
+# usermanual.html#RCL.CONFIG.INDEXING won't work because fragments
+# are case-sensitive. This has been solved by converting all ids
+# inside the source file to upper-case. DON'T REINTRODUCE
+# lower-case IDS
# Wherever docbook.xsl and chunk.xsl live
# Fbsd
@@ -23,14 +28,15 @@
dochunky=1
test $# -eq 1 && dochunky=0
-# Remove the SGML header and uncomment the XML one + convert from iso-8859-1
-# to utf-8
+# Remove the SGML header and uncomment the XML one. Also used to iconv
+# from iso-8859-1 to UTF-8, but the SGML manual is now UTF-8 ? Would
+# that work with the sgml toolchain ??
+echo '<?xml version="1.0" encoding="UTF-8"?>' > usermanual.xml
sed -e '\!//FreeBSD//DTD!d' \
-e '\!DTD DocBook XML!s/<!--//' \
-e '\!/docbookx.dtd!s/-->//' \
< usermanual.sgml \
- | iconv -f iso-8859-1 -t utf-8 \
- > usermanual.xml
+ >> usermanual.xml
# Options common to the single-file and chunked versions
commonoptions="--stringparam section.autolabel 1 \
@@ -59,3 +65,6 @@
tidy -indent usermanual-xml.html > tmpfile
mv -f tmpfile usermanual-xml.html
+
+# And the pdf with dblatex
+dblatex usermanual.xml