translations-status.py: produce .texi that compiles. Use it.

[lilypond.git] / Documentation / notation / pitches.itely

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index 2959a7986d69b4f41786598aa2b29ed3afee938b..31af761a7e8f38a5950a697d58c9dba3a35803de 100644 (file)
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -892,9 +892,6 @@ This section discusses how to alter the output of pitches.
 @cindex baritone clef
 @cindex varbaritone clef
 @cindex subbass clef
-@cindex tab clef
-@cindex moderntab clef
-@cindex percussion clef
 @cindex clef
 @cindex ancient clef
 @cindex clef, ancient
@@ -911,14 +908,14 @@ This section discusses how to alter the output of pitches.
 @cindex clef, mezzosoprano
 @cindex clef, baritone
 @cindex clef, varbaritone
-@cindex subbass clef, subbass
+@cindex clef, subbass
 
 
 @funindex \clef
 @funindex clef
 
 The clef may be altered.  Middle C is shown in every example. The
-following clef names can be (but don't have to be) enclosed in quotes.
+following clef names can (but do not need to) be enclosed in quotes.
 
 @lilypond[verbatim,quote,relative=1]
 \clef treble
@@ -931,9 +928,7 @@ c2 c
 c2 c
 @end lilypond
 
-Three of these clef names can be abbreviated: You can use @code{“G”}
-instead of @code{“treble”}, @code{“C”} instead of @code{“alto”} and
-@code{“F”} instead of @code{“bass”}. Other clefs include:
+Other clefs include:
 
 @lilypond[verbatim,quote,relative=1]
 \clef french
@@ -953,12 +948,18 @@ c2 c
 c2 c
 \clef percussion
 c2 c
-\clef tab
-c2 c
 
+\break
+
+\clef G   % synonym for treble
+c2 c
+\clef F   % synonym for bass
+c2 c
+\clef C   % synonym for alto
+c2 c
 @end lilypond
 
-@cindex transposing clefs
+@cindex transposing clef
 @cindex clef, transposing
 @cindex octave transposition
 @cindex choral tenor clef
@@ -967,21 +968,25 @@ c2 c
 By adding@tie{}@code{_8} or@tie{}@code{^8} to the clef name, the
 clef is transposed one octave down or up, respectively,
 and@tie{}@code{_15} and@tie{}@code{^15} transpose by two octaves.
-The clef name must be enclosed in quotes when it contains
-either underscores or circumflexes and digits.
+Clef names containing non-alphabetic characters must be enclosed
+in quotes.
 
 @lilypond[verbatim,quote,relative=1]
 \clef treble
 c2 c
 \clef "treble_8"
 c2 c
+\clef "G_8"
+c2 c
 \clef "bass^15"
 c2 c
+\clef "F^15"
+c2 c
 @end lilypond
 
-The abbreviated clef names mentioned above can also be used as a
-shortened notation for transposing clefs, e.g. @code{“G_8”} instead of @code{“treble_8”} and@tie{}@code{“F^15”} instead of@tie{}@code{“bass^15”}.  Further supported clefs are described under @ref{Mensural clefs},
-@ref{Gregorian clefs} and @ref{Custom tablatures}.
+Some special purpose clefs are described in @ref{Mensural clefs},
+@ref{Gregorian clefs}, @ref{Default tablatures}, and @ref{Custom
+tablatures}.
 
 @snippets
 
@@ -993,6 +998,7 @@ shortened notation for transposing clefs, e.g. @code{“G_8”} instead of @code
 Notation Reference:
 @ref{Mensural clefs},
 @ref{Gregorian clefs},
+@ref{Default tablatures},
 @ref{Custom tablatures}.
 
 Snippets:
@@ -1123,17 +1129,19 @@ Internals Reference:
 octave for the staff:
 
 @lilypond[verbatim,quote,relative=2]
-a'2 b
-\ottava #1
-a b
+a2 b
+\ottava #-2
+a2 b
+\ottava #-1
+a2 b
 \ottava #0
-a b
+a2 b
+\ottava #1
+a2 b
+\ottava #2
+a2 b
 @end lilypond
 
-The @code{ottava} function also takes -1 (for 8va bassa),
-2@tie{}(for 15ma), and -2 (for 15ma bassa) as arguments.
-
-
 @snippets
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
@@ -2566,6 +2574,10 @@ c4 b
 c b < g \xNote c f > b
 @end lilypond
 
+As synonyms for @code{\xNote}, @code{\xNotesOn} and @code{\xNotesOff},
+@code{\deadNote}, @code{\deadNotesOn} and @code{\deadNotesOff} can
+be used.  The term @notation{dead note} is commonly used by guitarists.
+
 There is also a shorthand for diamond shapes which can be used
 only inside chords:
 
@@ -2586,7 +2598,8 @@ Snippets:
 
 Notation Reference:
 @ref{Note head styles},
-@ref{Chorded notes}.
+@ref{Chorded notes},
+@ref{Indicating harmonics and dampened notes}.
 
 Internals Reference:
 @rinternals{note-event},