Re: [Quilt-dev] Packages required to compile doc/main.tex

[Ondřej Lysoněk]

Jean Delvare <address@hidden> writes:

> Hi Ondřej,
>
> On Wed, 2020-05-13 at 19:08 +0200, Ondřej Lysoněk wrote:
>> just throwing this information out there in case someone (future me, for
>> example) finds it useful.
>> 
>> On Fedora, in order to compile doc/main.tex I needed to install the
>> following packages:
>> 
>> texlive-latex texlive-subfigure texlive-metafont texlive-mfware
>> texlive-cyrillic texlive-collection-langcyrillic texlive-cmap
>> texlive-cm-super
>
> Thank you very much for the information, that allowed me to rebuild the
> PDF documentation so that the version in the git repository is up-to-
> date.
>
>> It might be useful to document this somewhere.
>
> Agreed. What about:
>
> From: Jean Delvare <address@hidden>
> Subject: doc/quilt.pdf: Document the build process
>
> Document the list of latex packages that must be installed in order
> to build the PDF documentation.
>
> Suggested by Ondřej Lysoněk.
>
> Signed-off-by: Jean Delvare <address@hidden>
> ---
>  doc/Makefile |    7 +++++++
>  1 file changed, 7 insertions(+)
>
> --- a/doc/Makefile
> +++ b/doc/Makefile
> @@ -1,3 +1,10 @@
> +# In order to build the PDF documentation, you need the following packages
> +# to be installed:
> +#
> +# texlive-latex texlive-subfigure texlive-metafont texlive-mfware
> +# texlive-cyrillic texlive-collection-langcyrillic texlive-cmap
> +# texlive-cm-super
> +
>  all : quilt.pdf quilt-rus.pdf
>  
>  quilt.ps : quilt.dvi
>
>
> -- 

Excellent, thanks!

Another suggestion for the documentation build I have would be to run
'pdflatex --jobname=quilt -t letter $<' twice. Latex seems to require
two passes in order to generate section references.

If I run from the doc/ directory 'git clean -dfx' and 'make clean' and then
'make quilt.pdf', then section references such as "The location of patch
files (see Section 3)." don't get generated properly.

But it seems to have worked for you today, so I don't know. I'm not
really familiar with Latex.

Ondřej