On Sat, 6 Jul 2019 13:28:42 -0300
Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote:
> 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.
Interesting. I'd like to understand better why the HTML builder doesn't do
this...it seems like a bug in the latex builder somehow.
> 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+sams...@kernel.org>
> ---
> Documentation/sphinx/automarkup.py | 9 +++++++--
> 1 file changed, 7 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/sphinx/automarkup.py
> b/Documentation/sphinx/automarkup.py
> index b300cf129869..dba14374f269 100644
> --- a/Documentation/sphinx/automarkup.py
> +++ b/Documentation/sphinx/automarkup.py
> @@ -55,8 +55,13 @@ 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)
> +
> + # When building pdf documents, this may raise a NoUri exception
> + try:
> + xref = cdom.resolve_xref(app.env, docname, app.builder,
> + 'function', target, pxref, lit_text)
> + except:
> + xref = None
So this absolutely needs to be "except sphinx.environment.NoUri". I have
seen catch-all "except" clauses paper over or otherwise hide too many
problems over the years; I really try to avoid ever using them.
I want to look at this problem and understand it a bit better; then I'll
probably end up applying this patch with the above tweak.
Thanks,
jon
