The 2.1.28 release is blocked by the fact that Cyrus-SASL was switched to
using Sphinx for building out the man pages and other documentation. This
switch has generated numerous issues in github and continues to be a
significant pain point as every release of Sphinx seems to require a
significant number of changes to get the documentation buildable again. As
this switch was done by the Fastmail team, I generally expect that this
group will continue to maintain this portion of the software. Can someone
from Fastmail please dig into the current documentation build failures.
make[2]: Entering directory '/home/build/git/cyrus-sasl'
/usr/bin/sphinx-build -d docsrc/.doctrees -n -q -b cyrman ./docsrc ./man
Exception occurred:
File "/usr/lib/python3/dist-packages/docutils/writers/manpage.py", line
171, in __init__
self.settings = settings = document.settings
AttributeError: 'CyrusManualPageBuilder' object has no attribute 'settings'
The full traceback has been saved in /tmp/sphinx-err-099bk_9r.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at
<https://github.com/sphinx-doc/sphinx/issues>.
more /tmp/sphinx-err-099bk_9r.log
# Sphinx version: 1.8.5
# Python version: 3.8.10 (CPython)
# Docutils version: 0.16 release
# Jinja2 version: 2.10.1
# Last messages:
# reading sources... [ 98%] sasl/windows
# reading sources... [ 99%] setup
# reading sources... [100%] support
#
# looking for now-outdated files...
# none found
# pickling environment...
# done
# checking consistency...
# done
# Loaded extensions:
# sphinx.ext.mathjax (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/mathjax.py
# alabaster (0.7.8) from
/usr/lib/python3/dist-packages/alabaster/__init__.py
# sphinx.ext.coverage (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/coverage.py
# sphinx.ext.extlinks (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/extlinks.py
# sphinx.ext.graphviz (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/graphviz.py
# sphinx.ext.ifconfig (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/ifconfig.py
# sphinx.ext.todo (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/todo.py
# sphinx.ext.intersphinx (1.8.5) from
/usr/lib/python3/dist-packages/sphinx/ext/intersphinx.py
# sphinxlocal.builders.manpage (0.1) from
/home/build/git/cyrus-sasl/docsrc/exts/sphinxlocal/builders/manpage.py
# sphinxlocal.roles.saslman (unknown version) from
/home/build/git/cyrus-sasl/docsrc/exts/sphinxlocal/roles/saslman.py
Traceback (most recent call last):
File "/usr/lib/python3/dist-packages/sphinx/cmd/build.py", line 304, in
build_main
app.build(args.force_all, filenames)
File "/usr/lib/python3/dist-packages/sphinx/application.py", line 341, in
build
self.builder.build_update()
File "/usr/lib/python3/dist-packages/sphinx/builders/__init__.py", line
342, in build_update
self.build(['__all__'], to_build)
File "/usr/lib/python3/dist-packages/sphinx/builders/__init__.py", line
412, in build
self.write(docnames, list(updated_docnames), method)
File
"/home/build/git/cyrus-sasl/docsrc/exts/sphinxlocal/builders/manpage.py",
line 86, in write
docwriter.write(largetree, destination)
File "/usr/lib/python3/dist-packages/docutils/writers/__init__.py", line
78, in write
self.translate()
File
"/home/build/git/cyrus-sasl/docsrc/exts/sphinxlocal/writers/manpage.py",
line 37, in translate
visitor = CyrusManualPageTranslator(self.document, self.builder)
File
"/home/build/git/cyrus-sasl/docsrc/exts/sphinxlocal/writers/manpage.py",
line 49, in __init__
BaseTranslator.__init__(self, document, builder, *args, **kwds)
File "/usr/lib/python3/dist-packages/sphinx/writers/manpage.py", line 89,
in __init__
BaseTranslator.__init__(self, *args, **kwds)
File "/usr/lib/python3/dist-packages/docutils/writers/manpage.py", line
171, in __init__
self.settings = settings = document.settings
AttributeError: 'CyrusManualPageBuilder' object has no attribute 'settings'
Thanks.
--Quanah
------------------------------------------
Cyrus: Devel
Permalink:
https://cyrus.topicbox.com/groups/devel/Tfc2ee4b5e9c57980-M6ddd3d54e2ac72925b173905
Delivery options: https://cyrus.topicbox.com/groups/devel/subscription
