Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1459427 > unrolled thread

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

Back to article view | Back to linux.kernel

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.

Contents

  [RFC PATCH 3/3] Documentation: exclude media documentation from pdf generation Jani Nikula <jani.nikula@intel.com> - 2016-08-10 20:30 +0200
    Re: [RFC PATCH 3/3] Documentation: exclude media documentation from pdf generation Markus Heiser <markus.heiser@darmarit.de> - 2016-08-10 21:30 +0200
    Re: [RFC PATCH 3/3] Documentation: exclude media documentation from  pdf generation "Luis R. Rodriguez" <mcgrof@kernel.org> - 2016-08-10 22:10 +0200
    Re: [RFC PATCH 3/3] Documentation: exclude media documentation from  pdf generation Mauro Carvalho Chehab <mchehab@infradead.org> - 2016-08-10 22:10 +0200

#1459427 — [RFC PATCH 3/3] Documentation: exclude media documentation from pdf generation

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@intel.com>
---
 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'),
 ]
 
-- 
2.1.4

[toc] | [next] | [standalone]

#1459650

Am 10.08.2016 um 18:16 schrieb Mauro Carvalho Chehab <mchehab@infradead.org>:

> Hi Jani,
> 
> Em Wed, 10 Aug 2016 18:54:09 +0300
> Jani Nikula <jani.nikula@intel.com> escreveu:
> 
>> Although pdflatex is more robust than rst2pdf, building media
>> documentation pdf still fails. Exclude media documentation from pdf
>> generation for now.
> 
> Again, didn't test, but do you think the issues with pdflatex and
> media are solvable?

Not all, we have to test book by book and see what fails and what 
the reasons. Large tables will never format propper on paper sizes.

But first lets ack and merge all this together.

-- Markus --

> 
>> 
>> Signed-off-by: Jani Nikula <jani.nikula@intel.com>
>> ---
>> 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'),
>> ]
>> 
> 
> 
> 
> 
> Cheers,
> Mauro

[toc] | [prev] | [next] | [standalone]

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

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@intel.com>
> ---
>  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

[toc] | [prev] | [next] | [standalone]

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

Hi Jani,

Em Wed, 10 Aug 2016 18:54:09 +0300
Jani Nikula <jani.nikula@intel.com> escreveu:

> Although pdflatex is more robust than rst2pdf, building media
> documentation pdf still fails. Exclude media documentation from pdf
> generation for now.

Again, didn't test, but do you think the issues with pdflatex and
media are solvable?

> 
> Signed-off-by: Jani Nikula <jani.nikula@intel.com>
> ---
>  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'),
>  ]
>  




Cheers,
Mauro

[toc] | [prev] | [standalone]

Back to top | Article view | linux.kernel

csiph-web