summaryrefslogtreecommitdiffstats
path: root/Documentation/conf.py
diff options
context:
space:
mode:
authorMauro Carvalho Chehab2019-07-09 11:52:36 +0200
committerMauro Carvalho Chehab2019-07-17 11:57:51 +0200
commit9d42afbe6bd4ce6d424159715e4abf3ea3ddb789 (patch)
tree15e19797a384b293645562b9ddb009c2ed6cee41 /Documentation/conf.py
parentdocs: fix broken doc references due to renames (diff)
downloadkernel-qcow2-linux-9d42afbe6bd4ce6d424159715e4abf3ea3ddb789.tar.gz
kernel-qcow2-linux-9d42afbe6bd4ce6d424159715e4abf3ea3ddb789.tar.xz
kernel-qcow2-linux-9d42afbe6bd4ce6d424159715e4abf3ea3ddb789.zip
docs: pdf: add all Documentation/*/index.rst to PDF output
Currently, all index files should be manually added to the latex_documents array at conf.py. While this allows fine-tuning some LaTeX specific things, like the name of the output file and the name of the document, it is not uncommon to forget adding new documents there. So, add a logic that will seek for all Documentation/*/index.rst. If the index is not yet at latex_documents, it includes using a reasonable default. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Diffstat (limited to 'Documentation/conf.py')
-rw-r--r--Documentation/conf.py15
1 files changed, 15 insertions, 0 deletions
diff --git a/Documentation/conf.py b/Documentation/conf.py
index 3b2397bcb565..13b5f711bddf 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -410,6 +410,21 @@ latex_documents = [
'The kernel development community', 'manual'),
]
+# Add all other index files from Documentation/ subdirectories
+for fn in os.listdir('.'):
+ doc = os.path.join(fn, "index")
+ if os.path.exists(doc + ".rst"):
+ has = False
+ for l in latex_documents:
+ if l[0] == doc:
+ has = True
+ break
+ if not has:
+ latex_documents.append((doc, fn + '.tex',
+ 'Linux %s Documentation' % fn.capitalize(),
+ 'The kernel development community',
+ 'manual'))
+
# The name of an image file (relative to this directory) to place at the top of
# the title page.
#latex_logo = None