Fix links to commands in API specification (#1179)

Links were not created for commands defined by extensions. With this
changes all uses of e.g. {clCreateSemaphoreWithPropertiesKHR} link
to the definition of the command which makes navigating the specification
much easier.


Change-Id: I4a9458609f4ba3229b66e3d169a68cb4564e2538

Signed-off-by: Kevin Petit <kevin.petit@arm.com>

scripts/gen_dictionaries.py

@@ -99,7 +99,7 @@ def GetFooter():
 
             numberOfFuncs = numberOfFuncs + 1
 
-    # Add extension API functions without links:
+    # Add extension API functions with and without links:
     for extension in spec.findall('extensions/extension/require'):
         for api in extension.findall('command'):
             name = api.get('name')
@@ -110,7 +110,8 @@ def GetFooter():
             # // clGetGLObjectInfo
             # :clGetGLObjectInfo: pass:q[*clGetGLObjectInfo*]
             apiLinkFile.write('// ' + name + '\n')
-            apiLinkFile.write(':' + name + ': pass:q[*' + name + '*]\n')
+            apiLinkFile.write(':' + name + '_label: pass:q[*' + name + '*]\n')
+            apiLinkFile.write(':' + name + ': <<' + name + ',{' + name + '_label}>>\n')
             apiLinkFile.write('\n')
 
             apiNoLinkFile.write('// ' + name + '\n')