Document the alternate format for :ref:.

diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
index 60c783655b9d1d728c679d965428e5f32ee6bd21..69a6f125516793c660c368e65f562457812eb158 100644 (file)
--- 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
 ----------------------