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

Reply via email to