From: Graham Percival <graham@percival-music.ca>
Date: Sat, 3 Nov 2007 08:05:47 +0000 (-0700)
Subject: Misc cleanups.
X-Git-Tag: release/2.11.35-1~46^2~2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=4b1552ed7eec9e384b06ec9f85323dd24b9d0dd9;p=lilypond.git

Misc cleanups.
---

diff --git a/Documentation/user/introduction.itely b/Documentation/user/introduction.itely
index 97bf001134..71fe0f3b01 100644
--- a/Documentation/user/introduction.itely
+++ b/Documentation/user/introduction.itely
@@ -690,21 +690,19 @@ to mix music and text in documents.
 @node About this manual
 @section About this manual
 
-There are two manuals about LilyPond: the @emph{user manual} (this
-document), and @emph{program usage}.
+FIXME: needs almost-complete rewrite.  -gp
 
+There are four manuals about LilyPond: the @emph{Learning Manual},
+the @emph{Notation Reference}, the @emph{Program Usage}, and the
+@emph{Program Reference}.
 
-@subheading User manual
 
-The manual is divided into three books.
-
-@subsubheading Learning manual
+@subheading Learning Manual (LM)
 
 This book explains how to begin learning LilyPond, as well as explaining
 some key concepts in easy terms.  It is recommended to read these
 chapters in a linear fashion.
 
-
 @itemize
 
 @item
@@ -715,10 +713,10 @@ The
 gives a gentle introduction to typesetting music.  First time
 users should start here.
 
-@c @item
-@c @emph{@ref{Putting it all together}},
-@c explains some general concepts about the lilypond file format.  If
-@c you are not certain where to place a command, read this chapter!
+@item
+@emph{@ref{Fundamental concepts}},
+explains some general concepts about the lilypond file format.  If
+you are not certain where to place a command, read this chapter!
 
 @item
 @emph{@ref{Working on LilyPond projects}},
@@ -733,7 +731,7 @@ produces.
 @end itemize
 
 
-@subsubheading Notation reference
+@subheading Notation Reference (NR)
 
 This book explains all the LilyPond commands which produce notation.  It
 assumes that readers are familiar with the concepts in the Learning
diff --git a/Documentation/user/percussion.itely b/Documentation/user/percussion.itely
index 29aff239bc..dc94f41d94 100644
--- a/Documentation/user/percussion.itely
+++ b/Documentation/user/percussion.itely
@@ -289,7 +289,7 @@ Because general MIDI does not contain rim shots, the sidestick is used
 for this purpose instead.
 
 
-@c FIXME: check name -gp
+@c TODO: check name -gp
 @node Ghost notes
 @unnumberedsubsubsec Ghost notes
 
diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely
index 639960adc9..e33182425b 100644
--- a/Documentation/user/spacing.itely
+++ b/Documentation/user/spacing.itely
@@ -535,6 +535,7 @@ be altered for page formatting, set @code{annotate-spacing} in the
 @code{\paper} block, like this
 
 
+@c need to have \book{} otherwise we get  the separate systems. -hwn
 @lilypond[verbatim]
 #(set-default-paper-size "a6" 'landscape)
 
@@ -544,10 +545,9 @@ be altered for page formatting, set @code{annotate-spacing} in the
 }
 @end lilypond
 
-@c need to have \book{} otherwise we get  the separate systems. -hwn
 
+@c  TODO: really bad vagueness due to bug in annotate-spacing.  -gp
 @noindent
-@c  FIXME: really bad vagueness due to bug in annotate-spacing.  -gp
 Some unit dimensions are measured in staff spaces, while others
 are measured in millimeters.
 The pairs
diff --git a/Documentation/user/vocal.itely b/Documentation/user/vocal.itely
index 8241fd6b81..6830cf42d2 100644
--- a/Documentation/user/vocal.itely
+++ b/Documentation/user/vocal.itely
@@ -615,7 +615,7 @@ There is one tricky aspect: the setting for @code{ignoreMelismata}
 must be set one syllable @emph{before} the non-melismatic syllable
 in the text, as shown here,
 
-@c  FIXME: breaks compile
+@c  TODO: breaks compile
 @lilypond[verbatim,ragged-right,quote]
 %{
 <<