John Snow <js...@redhat.com> writes: > For whatever reason, when these are stored as functions instead of > strings, it confuses sphinx-autodoc into believing them to be > docstrings, and it chokes on the syntax. > > Keeping them as dumb strings instead avoids the problem. > > Signed-off-by: John Snow <js...@redhat.com>
Quoting my review of the patch that added it: "This .format business is perhaps a bit too clever. But let's move on." doc.py is about to be replaced, obsoleting this patch. Regardless: Reviewed-by: Markus Armbruster <arm...@redhat.com>