Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
Merge tag 'docs-6.8-fixes3' of git://git.lwn.net/linux
Pull two documentation build fixes from Jonathan Corbet:
- The XFS online fsck documentation uses incredibly deeply nested
subsection and list nesting; that broke the PDF docs build. Tweak a
parameter to tell LaTeX to allow the deeper nesting.
- Fix a 6.8 PDF-build regression
* tag 'docs-6.8-fixes3' of git://git.lwn.net/linux:
docs: translations: use attribute to store current language
docs: Instruct LaTeX to cope with deeper nesting
+10
-6
+6
Documentation/conf.py
+6
Documentation/conf.py
···
388
388
verbatimhintsturnover=false,
389
389
''',
390
390
391
+
#
392
+
# Some of our authors are fond of deep nesting; tell latex to
393
+
# cope.
394
+
#
395
+
'maxlistdepth': '10',
396
+
391
397
# For CJK One-half spacing, need to be in front of hyperref
392
398
'extrapackages': r'\usepackage{setspace}',
393
399
+4
-6
Documentation/sphinx/translations.py
+4
-6
Documentation/sphinx/translations.py
···
29
29
}
30
30
31
31
class LanguagesNode(nodes.Element):
32
-
def __init__(self, current_language, *args, **kwargs):
33
-
super().__init__(*args, **kwargs)
34
-
35
-
self.current_language = current_language
32
+
pass
36
33
37
34
class TranslationsTransform(Transform):
38
35
default_priority = 900
···
46
49
# normalize docname to be the untranslated one
47
50
docname = os.path.join(*components[2:])
48
51
49
-
new_nodes = LanguagesNode(all_languages[this_lang_code])
52
+
new_nodes = LanguagesNode()
53
+
new_nodes['current_language'] = all_languages[this_lang_code]
50
54
51
55
for lang_code, lang_name in all_languages.items():
52
56
if lang_code == this_lang_code:
···
82
84
83
85
html_content = app.builder.templates.render('translations.html',
84
86
context={
85
-
'current_language': node.current_language,
87
+
'current_language': node['current_language'],
86
88
'languages': languages,
87
89
})
88
90