]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/essay/engraving.itely
Doc: ensure two spaces after end of sentence.
[lilypond.git] / Documentation / essay / engraving.itely
index f9fd3bfc4dbe8d29044d8d5ab8c41768ea160b14..61795e1a73ad3d949d34542602f7cffc6807d834 100644 (file)
@@ -31,7 +31,7 @@ such beautiful sheet music.
 @end menu
 
 @node The LilyPond story
-@unnumberedsec The LilyPond story
+@section The LilyPond story
 
 Long before LilyPond had been used to engrave beautiful performance
 scores, before it could create university course notes or even simple
@@ -83,9 +83,9 @@ and movement, and it feels like a living, breathing piece of music,
 while the newer edition seems cold and mechanical.
 
 It is hard to immediately see what makes the difference with the newer
-edition. Everything looks neat and tiny, possibly even @qq{better}
-because it looks more computerized and uniform. This really puzzled us
-for quite a while. We wanted to improve computer notation, but we first
+edition.  Everything looks neat and tiny, possibly even @qq{better}
+because it looks more computerized and uniform.  This really puzzled us
+for quite a while.  We wanted to improve computer notation, but we first
 had to figure out what was wrong with it.
 
 The answer lies in the precise, mathematical uniformity of the newer
@@ -112,9 +112,9 @@ into a rigid grid of musical markings.
 
 There are other differences as well: in the hand-engraved edition the
 vertical lines are all stronger, the slurs lie closer to the note heads,
-and there is more variety in the slopes of the beams. Although such
+and there is more variety in the slopes of the beams.  Although such
 details may seem like nitpicking, the result is a score that is easier
-to read. In the computer-generated output, each line is nearly identical
+to read.  In the computer-generated output, each line is nearly identical
 and if the musician looks away for a moment she will be lost on the
 page.
 
@@ -137,7 +137,7 @@ Henle no. 666, @copyright{}2000:
 @end iftex
 
 @node Engraving details
-@unnumberedsec Engraving details
+@section Engraving details
 
 @cindex engraving
 @cindex typography, music
@@ -192,11 +192,11 @@ LilyPond.
 @c mechanical look, which makes them unpleasant to play from.
 
 @menu
-* Music fonts::                 
-* Optical spacing::             
-* Ledger lines::                
-* Optical sizing::              
-* Why work so hard?::           
+* Music fonts::
+* Optical spacing::
+* Ledger lines::
+* Optical sizing::
+* Why work so hard?::
 @end menu
 
 @node Music fonts
@@ -305,7 +305,7 @@ corrections.  Which do you prefer?
 }
 
 music = {
-   c'4 e''4 e'4 b'4 |
+   c'4 e''4 e'4 b'4
    \stemDown
    b'8[ e'' a' e'']
    \stemNeutral
@@ -367,10 +367,10 @@ the upper two measures, however, form down-stem/@/up-stem clumps of
 notes.  A master engraver would adjust the spacing as needed to please
 the eye.
 
-The spacing algorthims in LilyPond even take the barlines into account,
+The spacing algorithms in LilyPond even take the barlines into account,
 which is why the final up-stem in the properly spaced example has been
 given a little more space before the barline to keep it from looking
-crowded. A down-stem would not need this adjustment.
+crowded.  A down-stem would not need this adjustment.
 
 @node Ledger lines
 @unnumberedsubsec Ledger lines
@@ -485,14 +485,16 @@ global = {
     \new Staff \relative c {
       \global
       \clef "bass"
-      << {
-        \once \override DynamicText #'X-offset = #-3
-        <ees g c>2.~->^\f
-        <ees g c>4.~ <ees g c>8
-      } \\ {
-        <c g c,>2.~
-        <c g c,>4.~ <c g c,>8
-      } >>
+      <<
+        {
+          \once \override DynamicText #'X-offset = #-3
+          <ees g c>2.~->^\f
+          <ees g c>4.~ <ees g c>8
+        } \\ {
+          <c g c,>2.~
+          <c g c,>4.~ <c g c,>8
+        }
+      >>
       r8 r16 <f, c' aes'>16
       <f c' aes'>4.-> <c' g'>8 r r
     }
@@ -535,7 +537,7 @@ to see and love to play from.
 
 
 @node Automated engraving
-@unnumberedsec Automated engraving
+@section Automated engraving
 
 @cindex engraving, automated
 @cindex automated engraving
@@ -545,9 +547,9 @@ layout of engraved scores: a method of describing good layouts to the
 computer and a lot of detailed comparisons with real engravings.
 
 @menu
-* Beauty contests::             
-* Improvement by benchmarking::  
-* Getting things right::        
+* Beauty contests::
+* Improvement by benchmarking::
+* Getting things right::
 @end menu
 
 @node Beauty contests
@@ -558,12 +560,12 @@ of the three configurations should we choose for the following slur?
 
 @lilypond
 \relative c {
-    \clef bass
-    \once \override Slur #'positions = #'(1.5 . 1)
-    e8[( f] g[ a b d,)] r4
-    \once \override Slur #'positions = #'(2 . 3)
-    e8[( f] g[ a b d,)] r4
-    e8[( f] g[ a b d,)] r4
+  \clef bass
+  \once \override Slur #'positions = #'(1.5 . 1)
+  e8[( f] g[ a b d,)] r4
+  \once \override Slur #'positions = #'(2 . 3)
+  e8[( f] g[ a b d,)] r4
+  e8[( f] g[ a b d,)] r4
 }
 @end lilypond
 
@@ -593,14 +595,14 @@ for each possible configuration we compute an ugliness score and we
 choose the least ugly configuration.
 
 For example, here are three possible slur configurations, and LilyPond
-has given each one a score in @q{ugly points}. The first example gets
+has given each one a score in @q{ugly points}.  The first example gets
 15.39 points for grazing one of the noteheads:
 
 @lilypond
 \relative c {
-    \clef bass
-    \once \override Slur #'positions = #'(1.5 . 1)
-    e8[(_"15.39" f] g[ a b d,)] r4
+  \clef bass
+  \once \override Slur #'positions = #'(1.5 . 1)
+  e8[(_"15.39" f] g[ a b d,)] r4
 }
 @end lilypond
 
@@ -612,9 +614,9 @@ descends for a total of 13.08 ugly points:
 
 @lilypond
 \relative c {
-    \clef bass
-    \once \override Slur #'positions = #'(2 . 3)
-    e8[(_"13.08" f] g[ a b d,)] r4
+  \clef bass
+  \once \override Slur #'positions = #'(2 . 3)
+  e8[(_"13.08" f] g[ a b d,)] r4
 }
 @end lilypond
 
@@ -625,8 +627,8 @@ selects this one:
 
 @lilypond
 \relative c {
-    \clef bass
-    e8[(_"12.04" f] g[ a b d,)] r4
+  \clef bass
+  e8[(_"12.04" f] g[ a b d,)] r4
 }
 @end lilypond
 
@@ -703,17 +705,21 @@ from the current version of LilyPond (@version{}):
   \key d \minor
   \time 3/4
   \mergeDifferentlyDottedOn
-  << {\slurDashed d8.-\flageolet( e16) e4.-\trill( d16 e)}
-     \\ {d4_2 a2}
+  <<
+    { \slurDashed d8.-\flageolet( e16) e4.-\trill( d16 e) }
+     \\
+    { d4_2 a2 }
   >>
   \slurDashed
   <f' a, d,>4. e8( d c)
   \slurSolid
-  bes g' f e16( f g_1 a_2 bes_3 d,_2)
+  bes8 g' f e16( f g_1 a_2 bes_3 d,_2)
   \slurDashed
   cis4.-\trill b8_3( a g)
-  << {\slurDashed d'8.( e16) e4.-\trill( d16 e)}
-     \\ {<f, a>4 a2}
+  <<
+    { \slurDashed d'8.( e16) e4.-\trill( d16 e) }
+     \\
+    { <f, a>4 a2 }
   >>
 }
 @end lilypond
@@ -751,10 +757,10 @@ We made our comparison by engraving the last seven measures of the piece
 the subject returns in a three-part stretto and leads into the closing
 section.  In the Finale version, we have resisted the temptation to make
 any adjustments to the default output because we are trying to show the
-things that each software package gets right without assistance. The
+things that each software package gets right without assistance.  The
 only major edits that we made were adjusting the page size to match this
 essay and forcing the music onto two systems to make the comparison
-easier. By default Finale would have engraved two systems of three
+easier.  By default Finale would have engraved two systems of three
 measures each and a final, full-width system containing a single
 measure.
 
@@ -769,7 +775,7 @@ measures 28--29, as shown here with Finale first and LilyPond second:
 @end ifnottex
 
 @lilypond[staffsize=19.5,line-width=14\cm]
-global = {\key g \minor}
+global = { \key g \minor }
 
 partI = \relative c' {
   \voiceOne
@@ -804,8 +810,8 @@ partIV = \relative c {
         \new Voice = "voiceI" { \partI }
         \new Voice = "voiceII" { \partII }
       >>
-
-      \new Staff = "LH" <<
+      \new Staff = "LH"
+      <<
         \clef "bass"
         \global
         \new Voice = "voiceIII" { \partIII }
@@ -844,8 +850,8 @@ collide = \once \override NoteColumn #'force-hshift = #0
   \new Voice = "sample" \relative c''{
     \key g \minor
     <<
-      {\voiceOne g4 \collide g4}
-      \new Voice {\voiceTwo bes \collide bes}
+      { \voiceOne g4 \collide g4 }
+      \new Voice { \voiceTwo bes \collide bes }
     >>
   }
   \new Lyrics \lyricsto "sample" \lyricmode { "good " " bad" }
@@ -863,8 +869,8 @@ collision than Finale does.
 @end itemize
 
 This example is not intended to suggest that Finale cannot be used to
-produce publication-quality output. On the contrary, in the hands of a
-skilled user it can and does, but it requires skill and time. One of the
+produce publication-quality output.  On the contrary, in the hands of a
+skilled user it can and does, but it requires skill and time.  One of the
 fundamental differences between LilyPond and commercial scorewriters is
 that LilyPond hopes to reduce the amount of human intervention to an
 absolute minimum, while other packages try to provide an attractive
@@ -892,11 +898,11 @@ engraving error.
 
 If you are interested in examining these examples in more detail, the
 full seven-measure excerpt can be found at the end of this essay along
-with four different published engravings. Close examination reveals that
-there is some acceptible variation among the hand-engravings, but that
-LilyPond compares reasonably well to that acceptible range. There are
+with four different published engravings.  Close examination reveals that
+there is some acceptable variation among the hand-engravings, but that
+LilyPond compares reasonably well to that acceptable range.  There are
 still some shortcomings in the LilyPond output, for example, it appears
-a bit too agressive in shortening some of the stems, so there is room
+a bit too aggressive in shortening some of the stems, so there is room
 for further development and fine-tuning.
 
 Of course, typography relies on human judgment of appearance, so people
@@ -909,7 +915,7 @@ manual adjustments are needed, LilyPond's structure has been designed
 with that flexibility in mind.
 
 @node Building software
-@unnumberedsec Building software
+@section Building software
 
 This section describes some of the programming decisions that we made
 when designing LilyPond.
@@ -1020,21 +1026,21 @@ components: parsing and representation take up less than 10% of
 the source code.
 
 When designing the structures used in LilyPond, we made some different
-decisions than are apparent in other software. Consider the heirarchical
+decisions than are apparent in other software.  Consider the hierarchical
 nature of music notation:
 
 @lilypond[quote,fragment]
 <<
-\new Staff \relative c'' {
-  \key g \major
-  \time 3/4
-  d4 g,8 a b c d4 g, g
-}
-\new Staff \relative c' {
-  \clef "bass"
-  \key g \major
-  <g b d>2 a4 b2.
-}
+  \new Staff \relative c'' {
+    \key g \major
+    \time 3/4
+    d4 g,8 a b c d4 g, g
+  }
+  \new Staff \relative c' {
+    \clef "bass"
+    \key g \major
+    <g b d>2 a4 b2.
+  }
 >>
 @end lilypond
 
@@ -1074,7 +1080,7 @@ consider a more complicated musical example:
     \new Voice = "I" \relative c''' {
       \time 3/4
       \voiceOne
-      \times 6/7 {g8 g g g g g g}
+      \times 6/7 { g8 g g g g g g }
       \oneVoice
       r4 <b,, fis' g bes> r4\fermata
     }
@@ -1104,10 +1110,10 @@ consider a more complicated musical example:
 
 In this example, staves start and stop at will, voices jump around
 between staves, and the staves have different time signatures.  Many
-software packages would struggle with reporducing this example because
+software packages would struggle with reproducing this example because
 they are built on the nested box structure.  With LilyPond, on the other
 hand, we have tried to keep the input format and the structure as
-flexbile as possible.
+flexible as possible.
 
 @node What symbols to engrave?
 @unnumberedsubsec What symbols to engrave?
@@ -1441,7 +1447,7 @@ note head symbol is changed during the music fragment.
 
 
 @node Putting LilyPond to work
-@unnumberedsec Putting LilyPond to work
+@section Putting LilyPond to work
 
 @cindex simple examples
 @cindex examples, simple
@@ -1563,12 +1569,12 @@ output files.  Another example is the third-party OOoLilyPond extension
 for OpenOffice.org, which makes it extremely easy to embed musical
 examples in documents.
 
-For more examples of LilyPond in action, full documentaion, and the
+For more examples of LilyPond in action, full documentation, and the
 software itself, see our main website: www.lilypond.org.
 
 @page
 @node Engraved examples (BWV 861)
-@unnumberedsec Engraved examples (BWV 861)
+@section Engraved examples (BWV 861)
 
 This section contains four reference engravings and two
 software-engraved versions of Bach's Fugue in G minor from the