diff options
author | Mauro Carvalho Chehab <mchehab+samsung@kernel.org> | 2019-07-06 13:28:42 -0300 |
---|---|---|
committer | Jonathan Corbet <corbet@lwn.net> | 2019-07-08 14:35:47 -0600 |
commit | 454f96f2b738374da4b0a703b1e2e7aed82c4486 (patch) | |
tree | 4932225e4d947710afc27cbeb530abf58d4c15a8 | |
parent | 66f2a122c68d8f13e5db978b6b7571aaf0e53a19 (diff) | |
download | lwn-454f96f2b738374da4b0a703b1e2e7aed82c4486.tar.gz lwn-454f96f2b738374da4b0a703b1e2e7aed82c4486.zip |
docs: automarkup.py: ignore exceptions when seeking for xrefsdocs-5.3
When using the automarkup extension with:
make pdfdocs
without passing an specific book, the code will raise an exception:
File "/devel/v4l/docs/Documentation/sphinx/automarkup.py", line 86, in auto_markup
node.parent.replace(node, markup_funcs(name, app, node))
File "/devel/v4l/docs/Documentation/sphinx/automarkup.py", line 59, in markup_funcs
'function', target, pxref, lit_text)
File "/devel/v4l/docs/sphinx_2.0/lib/python3.7/site-packages/sphinx/domains/c.py", line 308, in resolve_xref
contnode, target)
File "/devel/v4l/docs/sphinx_2.0/lib/python3.7/site-packages/sphinx/util/nodes.py", line 450, in make_refnode
'#' + targetid)
File "/devel/v4l/docs/sphinx_2.0/lib/python3.7/site-packages/sphinx/builders/latex/__init__.py", line 159, in get_relative_uri
return self.get_target_uri(to, typ)
File "/devel/v4l/docs/sphinx_2.0/lib/python3.7/site-packages/sphinx/builders/latex/__init__.py", line 152, in get_target_uri
raise NoUri
sphinx.environment.NoUri
This happens because not all references will belong to a single
PDF/LaTeX document.
Better to just ignore those than breaking Sphinx build.
Fixes: d74b0d31ddde ("Docs: An initial automarkup extension for sphinx")
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
[jc: Narrowed the "except" and tweaked the comment]
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
-rw-r--r-- | Documentation/sphinx/automarkup.py | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/Documentation/sphinx/automarkup.py b/Documentation/sphinx/automarkup.py index b300cf129869..77e89c1956d7 100644 --- a/Documentation/sphinx/automarkup.py +++ b/Documentation/sphinx/automarkup.py @@ -6,6 +6,7 @@ # from docutils import nodes from sphinx import addnodes +from sphinx.environment import NoUri import re # @@ -55,8 +56,15 @@ def markup_funcs(docname, app, node): reftype = 'function', reftarget = target, modname = None, classname = None) - xref = cdom.resolve_xref(app.env, docname, app.builder, - 'function', target, pxref, lit_text) + # + # XXX The Latex builder will throw NoUri exceptions here, + # work around that by ignoring them. + # + try: + xref = cdom.resolve_xref(app.env, docname, app.builder, + 'function', target, pxref, lit_text) + except NoUri: + xref = None # # Toss the xref into the list if we got it; otherwise just put # the function text. |