Commit 102caec1 authored by Jonathan Corbet's avatar Jonathan Corbet
Browse files

docs: Take a little noise out of the build process 



Sphinx 3.0 works at this point (albeit slowly) so stop scaring people
with a loud warning.  We also don't need to babble about CJK support in the
LaTeX build.

Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 257e6524

Documentation/conf.py

+0 −9
Original line number Diff line number Diff line
@@ -41,15 +41,7 @@ extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include', 
              'maintainers_include', 'sphinx.ext.autosectionlabel',

              'kernel_abi', 'kernel_feat']



#

# cdomain is badly broken in Sphinx 3+.  Leaving it out generates *most*

# of the docs correctly, but not all.  Scream bloody murder but allow

# the process to proceed; hopefully somebody will fix this properly soon.

#

if major >= 3:

    sys.stderr.write('''WARNING: The kernel documentation build process

        support for Sphinx v3.0 and above is brand new. Be prepared for

        possible issues in the generated output.\n''')

    if (major > 3) or (minor > 0 or patch >= 2):

        # Sphinx c function parser is more pedantic with regards to type

        # checking. Due to that, having macros at c:function cause problems.
@@ -368,7 +360,6 @@ latex_elements = { 


cjk_cmd = check_output(['fc-list', '--format="%{family[0]}\n"']).decode('utf-8', 'ignore')

if cjk_cmd.find("Noto Sans CJK SC") >= 0:

    print ("enabling CJK for LaTeX builder")

    latex_elements['preamble']  += '''

	% This is needed for translations

        \\usepackage{xeCJK}