From: Graham Percival <graham@percival-music.ca>
Date: Mon, 15 Oct 2007 04:14:39 +0000 (-0700)
Subject: Update policy with info about links.
X-Git-Tag: release/2.11.35-1~46^2~45
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=d02a940746c8fae096ce18f1dcbd0b76bb375036;p=lilypond.git

Update policy with info about links.
---

diff --git a/Documentation/user/policy.txt b/Documentation/user/policy.txt
index bb377d3921..a6a6c0e112 100644
--- 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.