docs: automarkup: do not look up symbols twice

The automarkup code tries to look up symbols once as a function, and once
as a macro.  The Sphinx C domain code, though, totally ignores that
distinction and will return the same results either way.  So just look
things up once and be done with it; the resulting output does not change,
but htmldocs build time drops by about 5%.

Tested-by: Akira Yokosawa <akiyks@gmail.com>
Link: https://lore.kernel.org/r/20220630163630.714673-3-corbet@lwn.net
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

Documentation/sphinx/automarkup.py

@@ -125,19 +125,16 @@ def markup_refs(docname, app, node):
 # do them again.
 #
 failed_lookups = { }
-def failure_seen(target, reftype):
+def failure_seen(target):
-    return (target + '::' + reftype) in failed_lookups
+    return (target) in failed_lookups
-def note_failure(target, reftype):
+def note_failure(target):
-    failed_lookups[target + '::' + reftype] = True
+    failed_lookups[target] = True
 
 #
 # In sphinx3 we can cross-reference to C macro and function, each one with its
 # own C role, but both match the same regex, so we try both.
 #
 def markup_func_ref_sphinx3(docname, app, match):
-    class_str = ['c-func', 'c-macro']
-    reftype_str = ['function', 'macro']
-
     cdom = app.env.domains['c']
     #
     # Go through the dance of getting an xref out of the C domain
@@ -153,30 +150,28 @@ def markup_func_ref_sphinx3(docname, app, match):
 
     if base_target not in Skipnames:
         for target in possible_targets:
-            if target not in Skipfuncs:
+            if (target not in Skipfuncs) and not failure_seen(target):
-                for class_s, reftype_s in zip(class_str, reftype_str):
+                lit_text = nodes.literal(classes=['xref', 'c', 'c-func'])
-                    if failure_seen(target, reftype_s):
+                lit_text += target_text
-                        continue
+                pxref = addnodes.pending_xref('', refdomain = 'c',
-                    lit_text = nodes.literal(classes=['xref', 'c', class_s])
+                                              reftype = 'function',
-                    lit_text += target_text
+                                              reftarget = target,
-                    pxref = addnodes.pending_xref('', refdomain = 'c',
+                                              modname = None,
-                                                  reftype = reftype_s,
+                                              classname = None)
-                                                  reftarget = target, modname = None,
+                #
-                                                  classname = None)
+                # XXX The Latex builder will throw NoUri exceptions here,
-                    #
+                # work around that by ignoring them.
-                    # 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,
-                    try:
+                                             'function', target, pxref,
-                        xref = cdom.resolve_xref(app.env, docname, app.builder,
+                                             lit_text)
-                                                 reftype_s, target, pxref,
+                except NoUri:
-                                                 lit_text)
+                    xref = None
-                    except NoUri:
-                        xref = None
 
-                    if xref:
+                if xref:
-                        return xref
+                    return xref
-                    note_failure(target, reftype_s)
+                note_failure(target)
 
     return target_text