Update policy with info about links.

diff --git a/Documentation/user/policy.txt b/Documentation/user/policy.txt
index bb377d392147511373a37572c7c489733ef3554a..a6a6c0e11299c18cb4eb0fc0869de8a3de9d57d4 100644 (file)
--- a/Documentation/user/policy.txt
+++ b/Documentation/user/policy.txt
@@ -63,7 +63,7 @@ main docs
 * You _must_ include a @seealso.  The order of items inside the
   @seealso section is
 
-    Music glossary: @rgloss{foo}, @rgloss{bar}.
+    Music glossary: @rglos{foo}, @rglos{bar}.
 
     User manual: @ref{baz}, @ref{foozle}.
 
@@ -73,6 +73,15 @@ main docs
 
   ("Snippets" is REQUIRED; the others are optional)
 
+* To create links, use @ref{} if the link is within the same
+  manual.  If you are linking to another manual (say,
+  learning->glossary or user->program usage), then use:
+    @rlearning{}
+    @ruser{}
+    @rprogram{}
+    @rglos{}
+    @internalsref{}
+
 * @commonprop and @refbugs are optional.