I am not an experienced latex user. I tried simple "make html" in the "docs" directory, as recommended by README, and error messages led me to get packages: latex2html-2002.2.1_pre20041025
tetex-2.0.2-r5
tex4ht-20050406_p1623-r1

With these packages installed, make halts on errors like: ! LaTeX Error: Lonely \item--perhaps a missing list environment. l.1302 ... "arg1" does not seem to be initialized]

Behavior was similar for dvi, txt, pdf, and ps.

Can someone suggest what's missing or required? The gzipped user.log is attached.

Thanks,

Bob Barry

This problem is fixed at my place, but I haven't committed it yet. I'll try to commit it tonight.

Michael.

Michael:

you wrote

This problem is fixed at my place, but I haven't committed it yet. I'll try to commit it tonight.

Thanks - you fixed html, which was what I really wanted. But ps and pdf still don't compile.

The resulting html looks good, but the compiler breezes past hundreds of warnings along the way. Is that normal?

Thanks,

Bob

Strange, because I did a 'make alldist' yesterday and uploaded all docs for the 2.0 release. All is committed and tagged.

The resulting html looks good, but the compiler breezes past hundreds of warnings along the way. Is that normal?

It is.
You can remove many of the warnings by removing the --warn-no-node option in the Makefile. (I need it for updating, as you can imagine...)

Michael.

Michael -

you wrote

> But ps and pdf still don't compile. Strange, because I did a 'make alldist' yesterday and uploaded all docs for the 2.0 release. All is committed and tagged.

Compilation of pdf and ps fail for me, but it looks like the fault is in using out-of-the-box setup of tetex.. It might be a good idea to test the relevant parameter at start of compilation, and if value is inadequate then exit with a message suggesting what to do about it.

Pdf compilation fails with:
LaTeX Warning: Reference `rtl:x86:readportw' on page 1283 undefined on input li ne 79730.

) [1283] (./rtl.aux
! TeX capacity exceeded, sorry [save size=5000].
@bel ...dafter \ifx \csname
\else
l.8883 ...213}{Types\relax }{subsection.31.2.2}{}}

! ==> Fatal error occurred, the output PDF file is not finished! Transcript written on rtl.log.
make: *** [rtl.pdf] Error 1
make: Leaving directory `/home/bobb/freepascal/cvs/fpc/docs'

Similarly, compilation of ps fails with:
LaTeX Warning: Reference `rtl:x86:readportw' on page 1292 undefined on input li ne 79730.

) [1292] (./rtl.aux
! TeX capacity exceeded, sorry [save size=5000].
@bel ...dafter \ifx \csname
\else
l.8883 ...222}{Types\relax }{subsection.31.2.2}{}}

Output written on rtl.dvi (1293 pages, 7460520 bytes). Transcript written on rtl.log.
make: *** [rtl.dvi] Error 1
make: Leaving directory `/home/bobb/freepascal/cvs/fpc/docs'

Thanks,

Bob

If you know how :_)

Anyway, in texmf.conf you need to up some of the limits. The default values are too tight.

Exactly.

set

save_size=10000

in texmf.conf

Normally, you can also do it via an environment variable.

export save_size=10000
pdflatex rtl.tex

I have received a fix for the makefiles, which I received from the Debian devels. I'll see about applying it tonight.

Michael.

The problem is that the fpc docs are huge and that the default values of some TeX distribtions are too small. I don't know if these values can be tested inside a TeX file.

Added to

http://www.freepascal.org/wiki/index.php/Release_engineering