Fixes #1909: Add "doc" references to Intersphinx inventories.

CHANGES

@@ -9,11 +9,8 @@ Features added
 
 * #1962: when adding directives, roles or nodes from an extension, warn if such
   an element is already present (built-in or added by another extension).
-
-Features added
---------------
-
 * #1935: Make "numfig_format" overridable in latex_elements.
+* #1909: Add "doc" references to Intersphinx inventories.
 
 Bugs fixed
 ----------

sphinx/domains/std.py

@@ -713,6 +713,9 @@ class StandardDomain(Domain):
         return results
 
     def get_objects(self):
+        # handle the special 'doc' reference here
+        for doc in self.env.all_docs:
+            yield (doc, clean_astext(self.env.titles[doc]), 'doc', doc, '', -1)
         for (prog, option), info in iteritems(self.data['progoptions']):
             yield (option, option, 'option', info[0], info[1], 1)
         for (type, name), info in iteritems(self.data['objects']):

sphinx/ext/intersphinx.py

@@ -228,6 +228,9 @@ def missing_reference(app, env, node, contnode):
         objtypes = ['%s:%s' % (domain.name, objtype)
                     for domain in env.domains.values()
                     for objtype in domain.object_types]
+    elif node['reftype'] == 'doc':
+        domain = 'std'  # special case
+        objtypes = ['std:doc']
     else:
         domain = node.get('refdomain')
         if not domain:

sphinx/roles.py

@@ -329,7 +329,7 @@ specific_docroles = {
     # links to download references
     'download': XRefRole(nodeclass=addnodes.download_reference),
     # links to documents
-    'doc': XRefRole(warn_dangling=True),
+    'doc': XRefRole(warn_dangling=True, innernodeclass=nodes.inline),
     # links to anything
     'any': AnyXRefRole(warn_dangling=True),