* lily/include/my-lily-parser.hh: rename My_lily -> Lily

[lilypond.git] / Documentation / user / lilypond.tely

diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely
index 7ba191a38a261e9c91dd6431458e18be86e7cef7..bdad180430fa831607e91c1357f20f9eeffd2f7b 100644 (file)
--- a/Documentation/user/lilypond.tely
+++ b/Documentation/user/lilypond.tely
@@ -42,6 +42,8 @@ Distributions will want to install lilypond.info in postinstall, doing:
 
 HINTS FOR STYLE
 
+* Do not forget to create @cindex entries for new sections of text.
+
 * Try not to use punctuation between introductocing sentence and
 display material (verbatim, music, example code).
 
@@ -63,6 +65,16 @@ are clickable in HTML.
 
 * Abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
 
+* Colon usage
+  0. Do not use a colon to introduce examples, sentences just continue
+
+      in the display material.
+
+  1. To introduce lists
+  2. When beginning a quote: "So, he said,..."
+     This usage is rarer.  Americans often just use a comma.
+  3. When adding a defining example at the end of a sentence.
+
 @end ignore
 
 @ifhtml
@@ -92,10 +104,11 @@ Copyright @copyright{} 1999--2004 by the authors
 
 @vskip 20pt
 
-  
+@c Not yet debugged or reported.  This crashes gs-8.01:
+@c compiling gs-8.01 right now... -- jcn
 @lilypond[raggedright]
 \score {
-    \context Lyrics \notes {
+    \context Lyrics {
         \override Score.RehearsalMark   #'self-alignment-X = #LEFT
         \mark #(ly:export (string-append
              "(For LilyPond version " (lilypond-version) ")"))
@@ -107,7 +120,6 @@ Copyright @copyright{} 1999--2004 by the authors
      }
 }
 @end lilypond
-  
 
 @end titlepage
 
@@ -132,7 +144,7 @@ Copyright 1999--2004 by the authors
 @top GNU LilyPond --- The music typesetter
 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
 
-This is the user manual for GNU LilyPond 2.1.x series.
+This is the user manual for GNU LilyPond 2.3.x series.
 @ifhtml
 (See the bottom of this page for the exact version number).
 @end ifhtml
@@ -149,16 +161,17 @@ this and other documentation.
 * Preface::                        Preface.
 * Introduction::                   What, Why, How.
 * Tutorial::                       A tutorial introduction.
+* Example templates::              Larger examples
 * Notation manual::                All notation supported, and how to
                                    produce it.
-* Changing defaults::              Tuning output
+* Changing defaults::              Tuning output.
+* Interfaces for programmers::
 * Invoking LilyPond::              Operation.
 * Converting from other formats::  Converting to lilypond source format.
 * lilypond-book manual::           Integrating text and music with lilypond-book.
 * Unified index::                  
 * Notation manual details::
 * Literature list::
-* Interfaces for programmers::
 * Cheat sheet::     
 * GNU Free Documentation License:: FDL.
 @end menu
@@ -171,9 +184,11 @@ this and other documentation.
 @include preface.itely
 @include introduction.itely 
 @include tutorial.itely
+@include examples.itely
+@include invoking.itexi
 @include notation.itely
 @include changing-defaults.itely
-@include invoking.itexi
+@include programming-interface.itely
 @include lilypond-book.itely
 @include converters.itely
 
@@ -188,8 +203,6 @@ this and other documentation.
 
 @include literature.itely
 
-@include programming-interface.itely
-
 @include cheatsheet.itely
 
 @include fdl.itexi