Minor policy.

diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely
index e1ad2ca5ca050d626bcbade3ef0ccffa51c0054e..0bf7fd51db1125518ebb2935eb4acdf435b6a046 100644 (file)
--- 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 aa496271841baf71837efca0c89f7ee71b07be88..8f3798d8a77a59bf37d04239413281cb4a013111 100644 (file)
--- 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 4b10aebd0d691adf6344002f7e30ae68c7ac7cae..ca9668d375abb900bc94807672580177534c8929 100644 (file)
--- 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.