Re: [RFC PATCH 3/3] Documentation: exclude media documentation from pdf generation

From: Luis R. Rodriguez
Date: Wed Aug 10 2016 - 16:05:47 EST


On Wed, Aug 10, 2016 at 06:54:09PM +0300, Jani Nikula wrote:
> Although pdflatex is more robust than rst2pdf, building media
> documentation pdf still fails. Exclude media documentation from pdf
> generation for now.
>
> Signed-off-by: Jani Nikula <jani.nikula@xxxxxxxxx>
> ---
> Documentation/conf.py | 4 +++-
> 1 file changed, 3 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/conf.py b/Documentation/conf.py
> index 96b7aa66c89c..827dafc515b1 100644
> --- a/Documentation/conf.py
> +++ b/Documentation/conf.py
> @@ -268,7 +268,9 @@ latex_elements = {
> # (source start file, target name, title,
> # author, documentclass [howto, manual, or own class]).
> latex_documents = [
> - (master_doc, 'TheLinuxKernel.tex', 'The Linux Kernel Documentation',
> + ('kernel-documentation', 'kernel-documentation.tex', 'The Linux Kernel Documentation',
> + 'The kernel development community', 'manual'),
> + ('gpu/index', 'gpu.tex', 'Linux GPU Driver Developer\'s Guide',
> 'The kernel development community', 'manual'),

Ah so other than expanding Documentation/index.rst we also have to
edit this file. It would be good to expand the new documentation
to reflect this as this was not clear.

With these changes I confirm I get my documentation in PDF format
for the new sections I am adding!

Thanks!

Luis