Add support for $ref'ing namespaces to server2.

chrome/common/extensions/docs/server2/reference_resolver.py

Index: chrome/common/extensions/docs/server2/reference_resolver.py
diff --git a/chrome/common/extensions/docs/server2/reference_resolver.py b/chrome/common/extensions/docs/server2/reference_resolver.py
index a9d6184bca394a9270cfb967fc313a63a3dfe0af..cc86eaee1739abefc8a6607cbddf32a9e0989087 100644
--- a/chrome/common/extensions/docs/server2/reference_resolver.py
+++ b/chrome/common/extensions/docs/server2/reference_resolver.py
@@ -67,6 +67,15 @@ class ReferenceResolver(object):
     self._object_store = object_store
 
   def _GetRefLink(self, ref, api_list, namespace, title):
+    # Easy: maybe it's just a ref to an API.
+    if ref in api_list:

[Jeffrey Yasskin, 2013/01/18 18:27:31]

Are the elements of api_list like "tabs" or "chrome.tabs"? Do you intend
$ref:tabs or $ref:chrome.tabs to work?

[not at google - send to devlin, 2013/01/18 18:30:25]

They're just like "tabs". There's no need for "chrome.tabs" to work.

Though I just realised that it may be better for this block to move below the
resolve-within-namespaces logic - say that the tabs API has a function called
windows. We probably want $ref:windows within the tabs API to resolve to the
windows function, not the windows namespace.

+      return {
+        'href': '%s.html' % ref,
+        'text': title if title else ref,
+        'name': ref
+      }
+
+    # Harder: maybe it's a ref to a node within an API.
     parts = ref.split('.')
     for i, part in enumerate(parts):
       api_name = '.'.join(parts[:i])