Hi John, 2015-01-30 18:13, John McNamara: > This patch adds support for creating PDF versions of the user guides. > > Specifically: > > * The Programmer's Guide > * The Linux Getting Started Guide > * The FreeBSD Getting Started Guide > * The Sample Applications User Guide > * The TestPMD User Guide > * The Release Notes > > The local and online Html documentation is very useful but we have had > internal and external requests from people who also liked the PDF > documentation in older releases. > > The PDF generation is fully automated and uses the same Sphinx build system > and RST files used for the Html docs but uses the 'latexpdf' target. In > addition to the standard Sphinx Python modules it requires the Tex/LaTeX > toolchain. For best results it requires a TexLive 'Full' installation. > > The PDF documents are generated as follows: > > make pdf > # or > make doc-pdf > > The PDFs aren't generated as part of the 'make doc' rule since they can take > some 1-3 minutes to build and since they have a large toolchain dependency. > > V2 Changes: > > * Removes config file duplication > * Converts SVG files to PNG on the fly > * Splits the patch into distinct mk/doc parts > * Fixes issues in the RST docs that prevent PDF generation
It seems a lot better. I still have some comments but I feel we are not far of the simplest code ;) -- Thomas
