make htmldocs时出错

[Yuanye Ma]

各位前辈：

你们好，

         我最近在编译内核文档时候一直报错，尝试了很多方案都没办法解决，请各位前辈赐教，在此拜谢了。

         祝大家编码愉快，学习进步，工作顺利。

-----------------------------------------

         运行环境如下

                       Ubuntu 20.04.1 LTS

                       Sphinx : 2.4.4

                       Kernel verison :  主线版本  commit hash : eda809aef53426

------------------------------------------ 

make htmldocs输出如下：

/home/myye/linux/Documentation/virt/kvm/api.rst:4531: WARNING: Unexpected indentation.

/home/myye/linux/Documentation/virt/kvm/api.rst:4533: WARNING: Block quote ends without a blank line; unexpected unindent.

/home/myye/linux/Documentation/ABI/testing/sysfs-firmware-sgi_uv:2: WARNING: Unexpected indentation.

/home/myye/linux/Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst:169: WARNING: Unexpected indentation.

/home/myye/linux/Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst:171: WARNING: Block quote ends without a blank line; unexpected unindent.

/home/myye/linux/Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst:183: WARNING: Unexpected indentation.

/home/myye/linux/Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst:189: WARNING: Block quote ends without a blank line; unexpected unindent.

/home/myye/linux/Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst:199: WARNING: Unexpected indentation.

/home/myye/linux/Documentation/networking/device_drivers/ethernet/marvell/octeontx2.rst:202: WARNING: Block quote ends without a blank line; unexpected unindent.

/home/myye/linux/Documentation/hwmon/sbtsi_temp.rst:4: WARNING: Title underline too short.

Kernel driver sbtsi_temp

==================

/home/myye/linux/Documentation/core-api/index.rst:53: WARNING: toctree contains reference to nonexisting document 'core-api/atomic_ops'

抛出异常：

  File "/usr/lib/python3.8/multiprocessing/connection.py", line 383, in _recv

    raise EOFError

EOFError

如果你想向开发者报告问题，可以查阅已经保存在 /tmp/sphinx-err-pdoymqhg.log 的完整 Traceback 信息 。

如果此处抛出了用户的错误，也请向我们报告，这样以后可以显示更友好、更详细的错误信息。

请向 Bug 追踪系统 <https://github.com/sphinx-doc/sphinx/issues> 投递 Bug 报告。谢谢！

make[1]: *** [Documentation/Makefile:91：htmldocs] 错误 2

make: *** [Makefile:1669：htmldocs] 错误 2

--------------------------------------------------------------------------

 出错的log信息如下： /tmp/sphinx-err-pdoymqhg.log  

# Sphinx version: 2.4.4

# Python version: 3.8.5 (CPython)

# Docutils version: 0.16 release

# Jinja2 version: 2.11.2

# Last messages:

#   写入输出... [ 27%] driver-api/fpga/intro .. driver-api/media/v4l2-subdev

#   写入输出... [ 31%] driver-api/media/v4l2-tuner .. driver-api/thermal/intel_powerclamp

#   写入输出... [ 34%] driver-api/thermal/nouveau_thermal .. filesystems/cramfs

#   写入输出... [ 37%] filesystems/debugfs .. filesystems/virtiofs

#   写入输出... [ 41%] filesystems/xfs-delayed-logging-design .. hwmon/bel-pfe

#   写入输出... [ 44%] hwmon/bt1-pvt .. hwmon/nct6683

#   写入输出... [ 48%] hwmon/nct6775 .. i2c/dma-considerations

#   写入输出... [ 51%] i2c/fault-codes .. kbuild/modules

#   写入输出... [ 55%] kbuild/reproducible-builds .. networking/batman-adv

#   写入输出... [ 58%] networking/bonding .. networking/devlink/index

# Loaded extensions:

#   sphinx.ext.mathjax (2.4.4) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/ext/mathjax.py

#   sphinxcontrib.applehelp (1.0.2) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinxcontrib/applehelp/__init__.py

#   sphinxcontrib.devhelp (1.0.2) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinxcontrib/devhelp/__init__.py

#   sphinxcontrib.htmlhelp (1.0.3) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinxcontrib/htmlhelp/__init__.py

#   sphinxcontrib.serializinghtml (1.1.4) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinxcontrib/serializinghtml/__init__.py

#   sphinxcontrib.qthelp (1.0.3) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinxcontrib/qthelp/__init__.py

#   alabaster (0.7.12) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/alabaster/__init__.py

#   kerneldoc (1.0) from /home/myye/linux/Documentation/sphinx/kerneldoc.py

#   rstFlatTable (1.0) from /home/myye/linux/Documentation/sphinx/rstFlatTable.py

#   kernel_include (1.0) from /home/myye/linux/Documentation/sphinx/kernel_include.py

#   kfigure (1.0.0) from /home/myye/linux/Documentation/sphinx/kfigure.py

#   sphinx.ext.ifconfig (2.4.4) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/ext/ifconfig.py

#   automarkup (unknown version) from /home/myye/linux/Documentation/sphinx/automarkup.py

#   maintainers_include (1.0) from /home/myye/linux/Documentation/sphinx/maintainers_include.py

#   kernel_abi (1.0) from /home/myye/linux/Documentation/sphinx/kernel_abi.py

#   kernel_feat (1.0) from /home/myye/linux/Documentation/sphinx/kernel_feat.py

#   cdomain (1.1) from /home/myye/linux/Documentation/sphinx/cdomain.py

#   sphinx.ext.imgmath (2.4.4) from /home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/ext/imgmath.py

Traceback (most recent call last):

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/cmd/build.py", line 276, in build_main

    app.build(args.force_all, filenames)

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/application.py", line 349, in build

    self.builder.build_update()

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 297, in build_update

    self.build(to_build,

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 361, in build

    self.write(docnames, list(updated_docnames), method)

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 532, in write

    self._write_parallel(sorted(docnames),

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 572, in _write_parallel

    tasks.add_task(write_process, arg)

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/util/parallel.py", line 103, in add_task

    self._join_one()

  File "/home/myye/linux/sphinx_2.4.4/lib/python3.8/site-packages/sphinx/util/parallel.py", line 112, in _join_one

    exc, logs, result = pipe.recv()

  File "/usr/lib/python3.8/multiprocessing/connection.py", line 250, in recv

    buf = self._recv_bytes()

  File "/usr/lib/python3.8/multiprocessing/connection.py", line 414, in _recv_bytes

    buf = self._recv(4)

  File "/usr/lib/python3.8/multiprocessing/connection.py", line 383, in _recv

    raise EOFError

EOFError