Misc updates, thanks Mark Knoop.

[lilypond.git] / Documentation / user / writing-texinfo.txt

diff --git a/Documentation/user/writing-texinfo.txt b/Documentation/user/writing-texinfo.txt
index 90230cf02a64678da80b352e2f11693338ec157e..11f49990c59221dfe1f27ad9d172ddcdac421d15 100644 (file)
--- a/Documentation/user/writing-texinfo.txt
+++ b/Documentation/user/writing-texinfo.txt
@@ -37,7 +37,7 @@ commands.
     \override textscript #'padding = #3
     c1^"hi"
 
-* LilyPond input should be produce via
+* LilyPond input should be produced via
     @lilypond[verbatim,quote,ragged-right]
   with `fragment' and `relative=2' optional.
 
@@ -46,9 +46,13 @@ commands.
   circumstances.
 
 * Inspirational headwords are produced with
-  @lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+  @lilypondfile[quote,ragged-right,line-width=16\cm,staffsize=16]
   {pitches-headword.ly}
 
+* LSR snippets are linked with
+  @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+  {filename.ly}
+
 * Avoid long stretches of input code.  Noone is going to read them
   in print.  Please create a smaller example.  (the smaller
   example does not need to be minimal, however)
@@ -153,9 +157,12 @@ commands.
 %%%%% SYNTAX SURVEY
 
 @c - single line comments
+  "@c NOTE:" is a comment which should remain in the final
+  version.  (gp only command ;)
 @ignore ... @end ignore - multi-line comment
 
-@cindex - General index. Please add as many as you can.
+@cindex - General index. Please add as many as you can.  Don't
+  capitalize the first word.
 @funindex - is for a \lilycommand.
 
 @example ... @end ignore - example text that should be set as a