From: Graham Percival <graham@percival-music.ca>
Date: Mon, 21 Apr 2008 22:29:52 +0000 (-0700)
Subject: Minor policy.
X-Git-Tag: release/2.11.45-1~23^2~1
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=5e235384781a846d6c768ce1db7f63045ef8bb19;p=lilypond.git

Minor policy.
---

diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely
index e1ad2ca5ca..0bf7fd51db 100644
--- a/Documentation/user/pitches.itely
+++ b/Documentation/user/pitches.itely
@@ -80,7 +80,7 @@ d,, d, d c
 @seealso
 
 Music Glossary:
-@rglos{Pitch names}.
+@rglos{Pitch names}
 
 Snippets:
 @lsrdir{Pitches,Pitches}.
@@ -966,9 +966,7 @@ concert pitch.
 Here are a few notes for violin and B-flat clarinet where the
 parts have been entered using the notes and key as they appear in
 each part of the conductor's score.  The two instruments are
-playing in unison.  Adding the @code{\transposition c'} to the
-violin part is not strictly necessary, but it is a useful
-reminder.
+playing in unison.
 
 @lilypond[verbatim,quote,ragged-right]
 \new GrandStaff <<
@@ -976,6 +974,7 @@ reminder.
     \relative c'' {
       \set Staff.instrumentName = "Vln"
       \set Staff.midiInstrument = "violin"
+      % not strictly necessary, but a good reminder
       \transposition c'
 
       \key c \major
diff --git a/Documentation/user/policy.txt b/Documentation/user/policy.txt
index aa49627184..8f3798d8a7 100644
--- a/Documentation/user/policy.txt
+++ b/Documentation/user/policy.txt
@@ -90,7 +90,7 @@ main docs
 
     Music Glossary:
     @rglos{foo},
-    @rglos{bar}.
+    @rglos{bar}
 
     Learning Manual:
     @rlearning{baz},
@@ -98,26 +98,26 @@ main docs
 
     Notation Reference:
     @ruser{faazle},
-    @ruser{boo}.
+    @ruser{boo}
 
     Application Usage:
-    @rprogram{blah}.
+    @rprogram{blah}
 
     Installed Files:
-    @file{path/to/dir/blahz}.
+    @file{path/to/dir/blahz}
 
     Snippets:
     @lsrdir{section},
-    @lsr{specific/example-name.ly}.
+    @lsr{specific/example-name.ly}
 
     Internals Reference:
     @internalsref{fazzle},
-    @internalsref{booar}.
+    @internalsref{booar}
 
       If there are multiple entries, separate them by commas
       but do not include an `and'.
 
-      Always end with a period.
+      Do not use use any periods.
 
       Place each link on a new line as above; this makes it much
       easier to add or remove links.  In the output, they
diff --git a/Documentation/user/writing-texinfo.txt b/Documentation/user/writing-texinfo.txt
index 4b10aebd0d..ca9668d375 100644
--- a/Documentation/user/writing-texinfo.txt
+++ b/Documentation/user/writing-texinfo.txt
@@ -72,6 +72,8 @@ commands.
 
 * Specify durations for at least the first note of every bar.
 
+* If possible, end with a complete bar.
+
 * If you only have one bar per line, omit bar checks.  If you
   put more than one bar per line (not recommended), then include
   bar checks.