Re: .pdf generation error using the "newer" tools

[Eric Bischoff <ebisch at cybercable dot tm dot fr>]

Bill Brooks wrote:
> 
> Okay,
> 
> I'm using the rpm's of the docbook tools. I did a clean install of RedHat
> 6.2, and followed the recommendation of the page at
> http://i18n.kde.org/doc/install.html by de-installing the RPM's that ship
> with RedHat and installing the following:
> 
>    docbook-dtd30-sgml-1.0-6.noarch.rpm
>    docbook-dtd31-sgml-1.0-6.noarch.rpm
>    docbook-dtd40-sgml-1.0-6.noarch.rpm
>    docbook-dtd41-sgml-1.0-6.noarch.rpm
>    docbook-style-dsssl-1.57-2.noarch.rpm
>    docbook-utils-0.5.5-1.noarch.rpm
>    jade-1.2.1-6.i386.rpm
>    jadetex-2.20-2.noarch.rpm
>    perl-SGMLSpm-1.03ii-3.noarch.rpm
>    sgml-common-0.3-1.noarch.rpm
> 
> I copied the simple "Hello World" example from
> http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/get-going.html#HELLO-WORLD
> into a file called "helloworld.docbook".

You can find an updated and completed version of this tutorial at

	http://www.caldera.de/~eric/crash-course/HTML/index.html

It also has updated "hello world" examples in it.

> As people have mailed this list pointing out, the documentation on the
> sources site is outdated, so I had to guess as to what flags would work
> with the docbook utilities. Here's what I tried:
> 
>    docbook2pdf \
>    ?  -c /usr/share/sgml/docbook/sgml-dtd-3.1/catalog \
>    ?  -d /usr/share/sgml/docbook/dsssl-stylesheets-1.57/print/docbook.dsl
>    helloworld.docbook

The two -c and -d flags should not be necessary. But they ensure you use
"bare bones" Norman Walsh's stuff, and not our default stylesheet.

> Is this right? I'd be happy to mail Mark Galassi a patch to the
> http://sources.redhat.com/docbook-tools/ web page that documents how to
> use the flags with the file locations where the RPM's put things if
> someone can get me started on the right path.

If you volunteer to update the web pages, to me you're welcome ;-).
Mark?

> Also, it seems like there is a problem actually producing a .pdf, here's
> what I get:
> 
>    Using catalogs: /etc/sgml/sgml-docbook-3.0.cat,
>    /usr/share/sgml/docbook/sgml-dtd-3.1/catalog

The 3.0 catalog has been auto-detected by the docbook-utils because
you're trying to render a 3.0 (outdated) document.
The 3.1 catalog is used because you specified it on the command line.
This tells you you should remove the "-c" argument that forces here to
use a wrong catalog.

>    Using stylesheet:
>    /usr/share/sgml/docbook/dsssl-stylesheets-1.57/print/docbook.dsl
>    Working on: /home/wbrooks/box/work/foo/helloworld.docbook
>    This is pdfTeX, Version 3.14159-13d (Web2C 7.3.1)
>    (Fatal format file error; I'm stymied)

TeX classical problem. The default configuration files do not allow
enough resources for docbook.

I think we have a corrected version on the web site. Attached is also a
patch we use at KDE.


-- 
Éric Bischoff  -  Documentation and Localization
Caldera (Deutschland) GmbH - Linux for eBusiness
Tel: +49 9131 7192 300 -  Fax: +49 9131 7192 399
http://www.caldera.de/
--- texmf.cnf.orig       Thu Sep 24 21:40:14 1998
+++ texmf.cnf    Tue Oct  6 01:45:12 1998
@@ -371,6 +371,7 @@

 % Extra space for the hash table of control sequences (which allows 10K
 % names as distributed).
+hash_extra.jadetex = 15000
 hash_extra.context = 15000
 hash_extra.cont-en = 15000
 hash_extra.cont-nl = 15000
@@ -379,6 +380,7 @@

 % Max number of characters in all strings, including all error messages,
 % help texts, font names, control sequences.  These values apply to TeX and MP.
+pool_size.jadetex = 200000
 pool_size.context = 500000
 pool_size.cont-en = 500000
 pool_size.cont-nl = 500000
@@ -391,6 +393,7 @@
 string_vacancies.cont-nl = 45000
 string_vacancies.cont-de = 45000
 string_vacancies = 25000
+max_strings.jadetex = 50000
 max_strings.context = 55000
 max_strings.cont-en = 55000
 max_strings.cont-nl = 55000
@@ -434,6 +437,7 @@
 param_size.cont-nl = 1500
 param_size.cont-de = 1500
 param_size = 500        % simultaneous macro parameters
+save_size.jadetex = 15000
 save_size.context = 5000
 save_size.cont-en = 5000
 save_size.cont-nl = 5000