[gnutls-dev] How to properly generate gnutls.pdf?

[Andreas Metzler]

On 2007-05-28 Simon Josefsson <simon at josefsson.org> wrote:
> Andreas Metzler <ametzler at downhill.at.eu.org> writes:

>> How is gnutls.pdf as included in the distribution generated? I have
>> tried to re-generate it after make clean but have stumbled upon a
>> couple of issues.

>> "make pdf" does not work for me, since @image is looking for .pdf:

>> | This is `epsf.tex' v2.7.3 <23 July 2005>
>> | ) localization, and turning on texinfo input format.) (./gnutls.aux)
>> | (./version.texi) (./my-bib-macros.texi)
>> | !pdfTeX error: pdfetex (file gnutls-logo.pdf): cannot find image file
>> | ==> Fatal error occurred, no output PDF file produced!

> This was fixed in 1.7.9, gnutls-logo.pdf is in CVS but wasn't
> distributed.  I suspect 'make distcheck' doesn't check this because
> gnutls.pdf is already available.  Are you using 1.6.x?  That version
> might not have the same fix yet.

1.7.9 contains gnutls-logo.pdf but it does not contain the other
images in pdf format (doc/layers.png doc/x509-1.png doc/internals.png
doc/pgp1.png)

Generating them from the png input with convert (instead of using
ps2pdf on the eps figures) seems to produce satisfying results.

>> I can regenerate them manually with ps2pdf. After doing this I realize
>> that I need to run (La)TeX twice to get the references right
>> | [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2] [-1] Chapter 1
>> | l.1: Undefined cross reference `Bibliography-snt'.
>> [1300 similar messages snipped]

>> So all in all it looks like I need to do this:
>> cd doc
>> make clean
>> for i in *eps ; do ps2pdf $i ; done
>> make pdf
>> rm gnutls.pdf
>> make pdf

>> The resulting file is more or less ok, the images are scaled wrongly
>> though. So, how do you do it?

> 'make gnutls.pdf' in doc/, which is triggered by top-level 'make dist'.
> Generally, if that doesn't work, something is wrong and should be fixed.

Ok. So it is broken due to the missing pdf-converted images.

I am not able to reproduce the "Undefined cross reference" messages with
1.7.9, so I guess I did something stupid yesterday.
cu andreas
-- 
`What a good friend you are to him, Dr. Maturin. His other friends are
so grateful to you.'
`I sew his ears on from time to time, sure'