--- 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