Eyolf's update for Pitches.

diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely
index 19e4cfd4635f18e0d9ee6f44ea1d2296daa95e35..2a2fdf0e6dd718377ae71840ec97f6428662c91e 100644 (file)
--- a/Documentation/user/pitches.itely
+++ b/Documentation/user/pitches.itely
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+   Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -61,8 +61,6 @@ is more fundamental and will be presented first.
 @cindex Absolute
 @cindex Absolute octave specification
 
-@c don't use @samp here because that might get confused with
-@c octave marks
 In absolute mode, every note is placed explicitly in a certain
 octave.  The note names @code{c} to @code{b} are engraved in the
 octave below middle C, as in the previous example.
@@ -313,7 +311,7 @@ Micro tones are also exported to the MIDI file.
 
 In accordance with standard typesetting rules, a natural sign is
 printed before a sharp or flat if a previous accidental needs to
-be cancelled.  To change this behavior, use
+be canceled.  To change this behavior, use
 
 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
 ceses4 ces cis c
@@ -1459,30 +1457,19 @@ problematic notes.
 @unnumberedsubsubsec Ambitus
 @cindex ambitus
 
-The term @emph{ambitus} denotes a range of pitches for a given
-voice in a part of music.  It may also denote the pitch range that
-a musical instrument is capable of playing.  Ambits are printed on
-vocal parts, so performers can easily determine it meets their
-capabilities.
+The term @notation{ambitus} or @notation{ambit} denotes a range of pitches
+for a given voice in a part of music.  It may also denote the
+pitch range that a musical instrument is capable of playing.
+Ambits are printed on vocal parts, so performers can easily
+determine if it meets their capabilities.
 
 Ambits are denoted at the beginning of a piece near the initial
 clef.  The range is graphically specified by two note heads that
 represent the minimum and maximum pitch.  To print such ambits,
 add the @internalsref{Ambitus_engraver} to the
-@internalsref{Voice} context, for example,
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-This results in the following output
+@internalsref{Voice} context, for example:
 
-@lilypond[quote,ragged-right]
+@lilypond[quote,verbatim,ragged-right]
 \layout {
   \context {
     \Staff
@@ -1496,10 +1483,9 @@ This results in the following output
 @end lilypond
 
 If you have multiple voices in a single staff and you want a
-single ambitus per staff rather than per each voice, add the
+single ambitus per staff rather than per voice, add the
 @internalsref{Ambitus_engraver} to the @internalsref{Staff}
-context rather than to the @internalsref{Voice} context.  Here is
-an example,
+context rather than to the @internalsref{Voice} context:
 
 @lilypond[verbatim,ragged-right,quote]
 \new Staff \with {
@@ -1598,7 +1584,7 @@ Snippets: @lsrdir{pitches},
 
 In shape note head notation, the shape of the note head
 corresponds to the harmonic function of a note in the scale.  This
-notation was popular in the 19th century American song books.
+notation was popular in nineteenth-century American song books.
 
 Shape note heads can be produced by setting @code{\aikenHeads} or
 @code{\sacredHarpHeads}, depending on the style desired.
@@ -1607,11 +1593,11 @@ Shape note heads can be produced by setting @code{\aikenHeads} or
   \aikenHeads
   c8 d4 e8 a2 g1
   \sacredHarpHeads
-  c8 d4. e8 a2 g1
+  c,8 d4. e8 a2 g1
 @end lilypond
 
-Shapes are determined on the step in the scale, where the base of
-the scale is determined by  the @code{\key} command
+Shapes are typeset according to the step in the scale, where
+the base of the scale is determined by the @code{\key} command.
 
 @funindex \key
 @funindex shapeNoteStyles
@@ -1621,7 +1607,7 @@ the scale is determined by  the @code{\key} command
 Shape note heads are implemented through the
 @code{shapeNoteStyles} property.  Its value is a vector of
 symbols.  The k-th element indicates the style to use for the k-th
-step of the scale.  Arbitrary combinations are possible, e.g.
+step of the scale.  Arbitrary combinations are possible, e.g.:
 
 @lilypond[verbatim,relative=1,fragment]
 \set shapeNoteStyles =
@@ -1667,6 +1653,7 @@ used in the following example
 
 @seealso
 
+
 Snippets: @lsrdir{pitches},
 
 
@@ -1680,7 +1667,7 @@ meanings -- crosses are used for @q{parlato} with vocalists,
 stopped notes on guitar; diamonds are used for harmonics on string
 instruments, etc.  There is a shorthand (@code{\harmonic}) for
 diamond shapes; the other notehead styles are produced by tweaking
-the property
+the property 
 
 @lilypond[ragged-right,relative=1,fragment,verbatim,quote]
 c4 d