sphinx-build failures

Aleksey Romanov aleksey at voltanet.io
Thu Feb 6 19:52:02 CET 2020


Hi,

I am trying to build documentation from .rst files I tried both binary
debian package and downloaded freeradius-server-3.0.20.tar.gz one from the
website.

1. conf.py file was missing, I added an empty one
2. Then I will get warnings about non-existing entries and finally missing
contents.rst
ar at xdebian:~/radius-work/freeradius-server/doc$ make -f Makefile.sphinx html
sphinx-build -b html -d _build/doctrees   . _build/html
Running Sphinx v1.8.4
making output directory...
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 17 source files that are out of date
updating environment: 17 added, 0 changed, 0 removed
reading sources... [100%] vendor/cisco


/home/ar/radius-work/freeradius-server/doc/developer/coding-methods.rst:35:
WARNING: Unexpected indentation.
/home/ar/radius-work/freeradius-server/doc/developer/coding-methods.rst:35:
WARNING: Inline emphasis start-string without end-string.
/home/ar/radius-work/freeradius-server/doc/developer/coding-methods.rst:36:
WARNING: Block quote ends without a blank line; unexpected unindent.
/home/ar/radius-work/freeradius-server/doc/developer/module_interface.rst:20:
WARNING: Bullet list ends without a blank line; unexpected unindent.
/home/ar/radius-work/freeradius-server/doc/developer/module_interface.rst:22:
WARNING: Block quote ends without a blank line; unexpected unindent.
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'aaa'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'ldap_howto'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'load-balance'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'coding-methods'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'DIFFS'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'release-method'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'cisco'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'configurable_failover'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'processing_users_file'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'proxy'
/home/ar/radius-work/freeradius-server/doc/index.rst:6: WARNING: toctree
contains reference to nonexisting document 'variables'
/home/ar/radius-work/freeradius-server/doc/modules/ldap_howto.rst:977:
WARNING: Literal block expected; none found.

Sphinx error:
master file /home/ar/radius-work/freeradius-server/doc/contents.rst not
found
make: *** [Makefile.sphinx:35: html] Error 2

Please, help

Thanks,

Aleksey


More information about the Freeradius-Users mailing list