Document the alternate format for :ref:.

rhettinger · rhettinger · commit cfee0e83ebd8 · 2010-12-21T20:52:12.000Z
diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
@@ -610,6 +610,8 @@ Example::
 
 The ``:ref:`` invocation is replaced with the section title.
 
+Alternatively, you can reference any label (not just section titles)
+if you provide the link text ``:ref:`link text`<reference-label>```.
 
 Paragraph-level markup
 ----------------------
