Proofreading from Neil, thanks!

diff --git a/Documentation/user/editorial.itely b/Documentation/user/editorial.itely
index c6d15041a60593e3af74e8fae17019431a02b739..786aee769dcfcff8b8b69c724084520f1a6a37b8 100644 (file)
--- a/Documentation/user/editorial.itely
+++ b/Documentation/user/editorial.itely
@@ -64,12 +64,12 @@ c2
 
 @cindex font size scaling
 
-Internally, this sets the @code{fontSize} property.  This in turns
+Internally, this sets the @code{fontSize} property.  This in turn
 causes the @code{font-size} property to be set in all layout
 objects.  The value of @code{font-size} is a number indicating the
 size relative to the standard size for the current staff height.
 Each step up is an increase of approximately 12% of the font size.
-Six steps is exactly a factor two.  The Scheme function
+Six steps is exactly a factor of two.  The Scheme function
 @code{magstep} converts a @code{font-size} number to a scaling
 factor.  The @code{font-size} property can also be set directly,
 so that only certain layout objects are affected.
@@ -90,7 +90,7 @@ c4.-> d8---3
 
 Font size changes are achieved by scaling the design size that is
 closest to the desired size.  The standard font size (for
-@code{font-size} equals 0), depends on the standard staff height.
+@code{font-size = #0}), depends on the standard staff height.
 For a 20pt staff, a 10pt font is selected.
 
 The @code{font-size} property can only be set on layout objects
@@ -140,7 +140,7 @@ c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
 
 @cindex thumb-script
 
-You can use the thumb-script (e.g., in cello music)to indicate that a 
+You can use the thumb-script (e.g., in cello music) to indicate that a 
 note should be played with the thumb. 
 
 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
@@ -154,7 +154,7 @@ Fingerings for chords can also be added to individual notes of the
 chord by adding them after the pitches.
 
 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >2 < d-1 f-2 a-3 c-5 >
+<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 @end lilypond
 
 Fingering instructions may be manually placed above or below the
@@ -230,8 +230,8 @@ Internals Reference:
 @cindex coloring notes
 @cindex notes, colored
 
-Individual objects may be assigned colors.  You may use the color
-names listed in the @ref{List of colors}.
+Individual objects may be assigned colors.  Valid color names
+are listed in the @ref{List of colors}.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 \override NoteHead #'color = #red
@@ -272,7 +272,8 @@ gis a
 b2 cis
 @end lilypond
 
-You can get exact RGB colors by specifying the rgb-color number.
+Exact RGB colors can be specified using the Scheme function
+@code{rgb-color}.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
@@ -280,7 +281,7 @@ You can get exact RGB colors by specifying the rgb-color number.
   \with-color #(x11-color 'navy) "Clarinet"
 }
   
-%black
+% black
 \override Stem #'color = #(rgb-color 0 0 0)
 gis8 a
 % white
@@ -301,12 +302,13 @@ Snippets:
 @lsrdir{Editorial,Editorial-annotations}.
 
 @knownissues
-An x11 color is not necessarily exactly the same shade as a
+An X11 color is not necessarily exactly the same shade as a
 similarly named normal color.  
 
-Not all x11 colors are distinguishable in a web browser i.e. a web browser
-might not display a difference between 'LimeGreen and 'ForestGreen.  For 
-web use normal colors are recommended (i.e. #blue, #green, #red).
+Not all X11 colors are distinguishable in a web browser, i.e.,
+a web browser might not display a difference between @code{'LimeGreen}
+and @code{'ForestGreen}.  For web use normal colors are recommended
+(i.e., @code{#blue}, @code{#green}, @code{#red}).
 
 
 Notes in a chord cannot be colored with @code{\override}; use
@@ -414,15 +416,15 @@ notation.
 {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
   a8 
-  \balloonGrobText #'Rest #' (-4 . -4) \markup { "I'm a rest" }
+  \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
   r
   <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2. 
 }
 @end lilypond
 
 There are two music functions, @code{balloonGrobText} and
-@code{balloonText};  The former is used like @code{\once \override} to 
-attach text to any grob, and the latter is used like @code{ \tweak}, 
+@code{balloonText};  the former is used like @code{\once \override} to 
+attach text to any grob, and the latter is used like @code{\tweak}, 
 typically within chords, to attach text to an individual note.
 
 @cindex balloon
@@ -449,35 +451,33 @@ notes.
 \layout {
   \context {
     \Staff
-    % sets up grids
+    % set up grids
     \consists "Grid_point_engraver" 
-    % this sets the grid interval to 1 quarternote (crotchet)
+    % set the grid interval to one quarter note
     gridInterval = #(ly:make-moment 1 4)
-      }
-}
-
-\new Score \with {
-  % by default this centers grid lines horizontally below and to the 
-  % left side of the notehead, the grid lines extend from 
-  % the middle lines of each staff
-  \consists "Grid_line_span_engraver"
   }
+  \context {
+    \Score
+    % by default this centers grid lines horizontally below
+    % and to the left side of the note head, the grid lines
+    % extending from the middle lines of each staff
+    \consists "Grid_line_span_engraver"
+  }
+}
 
-\new ChoirStaff <<
-  \new Staff {
-    \relative c'' {
+\score {
+  \new ChoirStaff <<
+    \new Staff \relative c'' {
       \stemUp
       c4. d8 e8 f g4
     }
-  }
-  \new Staff {
-    \clef bass
-    \relative c {
+    \new Staff \relative c {
+      \clef bass
       \stemDown
-      c4  g'  f  e
+      c4 g' f e
     }
-  }
->>
+  >>
+}
 @end lilypond
 
 @snippets
@@ -509,12 +509,13 @@ Internals Reference:
 @cindex note grouping bracket
 
 Brackets are used in musical analysis to indicate structure in musical
-pieces.  LilyPond supports a simple form of horizontal brackets.
+pieces.  Simple horizontal brackets are supported.
 
 @lilypond[quote,verbatim,ragged-right]
 \layout {
   \context {
-    \Staff \consists "Horizontal_bracket_engraver"
+    \Staff
+    \consists "Horizontal_bracket_engraver"
   }
 }
 \relative c'' {
@@ -528,7 +529,8 @@ Analysis brackets may be nested.
 @lilypond[quote,verbatim,ragged-right]
 \layout {
   \context {
-    \Staff \consists "Horizontal_bracket_engraver"
+    \Staff
+    \consists "Horizontal_bracket_engraver"
   }
 }
 \relative c'' {