sphinx-build failures

classic Classic list List threaded Threaded
2 messages Options
| Threaded
Open this post in threaded view
|

sphinx-build failures

Aleksey Romanov
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
-
List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html
| Threaded
Open this post in threaded view
|

Re: sphinx-build failures

Alan DeKok-2
On Feb 6, 2020, at 1:52 PM, Aleksey Romanov <[hidden email]> 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.


-
List info/subscribe/unsubscribe? See http://www.freeradius.org/list/users.html