@@ -64,6 +64,8 @@ Usage:

   glregistry params-tree    [<group>]

   glregistry audit          [<path>]

   glregistry audit-tree     [<path>]

+  glregistry refs           <name>

+  glregistry refs-all       <name>

   glregistry -h|--help

 Commands:

@@ -115,6 +117,11 @@ Commands:

     Search files in <path> if given, or the current directory if omitted,

     recursively for OpenGL API names and print them sorted on support, name,

     and location, in a tree.

+  refs <name>

+    Print the URLs of all reference pages with name <name>.

+  refs-all <name>

+    Print the URLs of all reference pages that mention <name>, sorted on

+    support, in a tree.

 Environment variables:

   GLREGISTRY_CACHE

@@ -27,6 +27,8 @@ Usage:

   glregistry params-tree    [<group>]

   glregistry audit          [<path>]

   glregistry audit-tree     [<path>]

+  glregistry refs           <name>

+  glregistry refs-all       <name>

   glregistry -h|--help

 Commands:

@@ -78,6 +80,11 @@ Commands:

     Search files in <path> if given, or the current directory if omitted,

     recursively for OpenGL API names and print them sorted on support, name,

     and location, in a tree.

+  refs <name>

+    Print all URLs of all reference pages with name <name>.

+  refs-all <name>

+    Print all URLs of all reference pages that mention <name>, sorted on

+    support, in a tree.

 Environment variables:

   GLREGISTRY_CACHE

@@ -109,7 +116,9 @@ from lxml import etree

 ## Constants

+REFPAGES_URL  = 'https://registry.khronos.org/OpenGL-Refpages/'

 REGISTRY_URL  = 'https://registry.khronos.org/OpenGL/'

+REFPAGES_GIT  = 'https://github.com/KhronosGroup/OpenGL-Refpages'

 XML_PATH      = 'xml/gl.xml'

 REGEX         = r'\b(gl|GL_)[0-9A-Z][0-9A-Za-z_]+\b'

 EXCLUDE_DIRS  = ['.?*', '_*']

@@ -469,6 +478,49 @@ def audit_tree(xml, path=None):

                 ])

+### `refs_`

+def refs_(name):

+    local = os.path.join(CACHE, os.path.basename(REFPAGES_GIT))

+    if not os.path.exists(local):

+        os.makedirs(os.path.dirname(local), exist_ok=True)

+        subprocess.run(['git', 'clone', REFPAGES_GIT, local])

+    refs_ = collections.defaultdict(set)

+    for file, *_ in grep(local, rf'\b{name}\b', [], [], True):

+        file = removeprefix(f'{local}{os.path.sep}', file)

+        try:

+            support, *_, dir, base = os.path.normpath(file).split(os.path.sep)

+        except:

+            continue

+        if support.startswith('gl') and dir.endswith('html'):

+            support   = removeprefix('gl', support)

+            name, ext = os.path.splitext(base)

+            url       = urllib.parse.urljoin(REFPAGES_URL, file)

+            if ext in ['.xml', '.xhtml']:

+                refs_[support].add((name, url))

+    return refs_

+

+

+### `refs`

+def refs(name):

+    return sorted(

+        url

+        for support, locations in refs_(name).items()

+        for name_, url         in locations

+        if name_ == name

+    )

+

+

+### `refs_all`

+def refs_all(name):

+    for support, locations in sorted(refs_(name).items()):

+        yield indentjoin(0, ',', [support])

+        for name_, url in sorted(locations):

+            yield indentjoin(1, ':', [

+                name_,

+                url,

+            ])

+

+

 ## Main

 def main():

     args = docopt.docopt(__doc__)

@@ -491,6 +543,8 @@ def main():

     if args['params-tree']:   page(params_tree  (xml_(), args['<group>']))

     if args['audit']:         page(audit        (xml_(), args['<path>']))

     if args['audit-tree']:    page(audit_tree   (xml_(), args['<path>']))

+    if args['refs']:          page(refs         (args['<name>']))

+    if args['refs-all']:      page(refs_all     (args['<name>']))

 if __name__ == '__main__':