sphinx-build failures
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@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
On Feb 6, 2020, at 1:52 PM, Aleksey Romanov <aleksey@voltanet.io> wrote:
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.
I think that hasn't been updated in 7 years. I don't think it ever completely worked. Alan DeKok.
participants (2)
-
Alan DeKok -
Aleksey Romanov