Fix some bugs in the dynamic engraver and PostScript backend

[lilypond.git] / Documentation / user / README.txt

diff --git a/Documentation/user/README.txt b/Documentation/user/README.txt
index a99ad3f0de122c0e2337f29395859d67c5c3042a..48e01fa5602e132387d4e252201a785ddd383c5b 100644 (file)
--- a/Documentation/user/README.txt
+++ b/Documentation/user/README.txt
@@ -21,8 +21,15 @@ may be used here.
 
 * Notation Reference is a (hopefully complete) description of
 LilyPond input notation.  Some material from here may be
-duplicated in the Learning Manual (for teaching).  This
-section is written in formal technical writing style.
+duplicated in the Learning Manual (for teaching).  The
+material is presented in an approximate order of increasing
+difficulty, but the goal is _not_ to provide a step-by-step
+learning environment.  For example, all material under
+"Notes" should remain in that section, even though microtonal
+accidentals may seem more advanced than info about clefs or
+time signatures -- "Notes" should be a one-stop reference
+about, well, notes.  This section is written in formal
+technical writing style.
 
 * Technical Details contains information about using
 the program lilypond with other programs (lilypond-book,
@@ -34,6 +41,10 @@ is writtin in formal technical writing style.
 GENERAL GUIDELINES
 
 * Do not forget to create @cindex entries for new sections of text.
+Enter commands with @funindex, i.e.
+@funindex \relative
+do not bother with the @code{} (they are added automatically).  These
+items are added to both the command index and the unified index.
 
 * The use of the word `illegal' is inappropriate in most cases.  Say
   `invalid' instead.