+@menu
+* Engraving::
+* Automated engraving::
+* What symbols to engrave?::
+* Music representation::
+* Example applications::
+@end menu
+
+
+@node Engraving
+@unnumberedsec Engraving
+
+@cindex engraving
+@cindex typography, music
+@cindex music typography
+@cindex plate engraving
+@cindex music engraving
+
+The art of music typography is called @emph{(plate) engraving}. The term
+derives from the traditional process of music printing. Just a few
+decades ago, sheet music was made by cutting and stamping the music into
+a zinc or pewter plate in mirror image. The plate would be inked, and
+the depressions caused by the cutting and stamping would hold ink. An
+image was formed by pressing paper to the plate. The stamping and
+cutting was done completely by hand. Making a correction was cumbersome,
+so the engraving had to be nearly perfect in one go. Engraving was a
+highly specialized skill; a craftsman had to complete around five years
+of training before earning the title of master engraver, and another
+five years of experience were necessary to become truly skilled.
+
+@quotation
+@iftex
+@image{pictures/hader-slaan,,7cm}
+@end iftex
+@ifnottex
+@sourceimage{hader-slaan,,,jpg}
+@end ifnottex
+@end quotation
+
+Nowadays, all newly printed music is produced with computers. This has
+obvious advantages: prints are cheaper to make, editorial work can be
+delivered by email, and the original data can be easily stored.
+Unfortunately, computer-generated scores rarely match the quality of
+hand-engraved scores. Instead, computer printouts have a bland,
+mechanical look, which makes them unpleasant to play from.
+
+From the beginning, we designed LilyPond to mimic the beauty of
+traditional music engraving. Along the way, we have learned a great deal
+about the work that goes into a well-engraved score. Below we describe
+several of those aspects that we have tried to imitate in LilyPond.
+
+@menu
+* Music Fonts::
+* Optical Spacing::
+* Ledger Lines::
+* Slurs::
+* Why work so hard?::
+@end menu
+
+@node Music Fonts
+@unnumberedsubsec Music Fonts
+
+The images below illustrate the difference between traditional engraving
+and typical computer output. The left picture shows a scan of a flat
+symbol from a hand-engraved Bärenreiter edition, while the right picture
+depicts a symbol from an edition of the same music published in 2000.
+Although both images are printed in the shame shade of ink, the earlier
+version looks darker: the staff lines are heavier, and the Bärenreiter
+flat has a bold, almost voluptuous rounded look. The right scan, on the
+other hand, has thinner lines and a straight layout with sharp corners.
+
+@multitable @columnfractions .25 .25 .25 .25
+@item @tab
+@ifnotinfo
+@iftex
+@image{pictures/baer-flat-gray,,4cm}
+@end iftex
+@ifnottex
+@image{pictures/baer-flat-gray,,,png}
+@end ifnottex
+
+@tab
+@iftex
+@image{pictures/henle-flat-gray,,4cm}
+@end iftex
+@ifnottex
+@image{pictures/henle-flat-gray,,,png}
+@end ifnottex
+
+@end ifnotinfo
+@ifinfo
+@image{lilypond/pictures/henle-flat-bw,,,,png}
+@image{lilypond/pictures/baer-flat-bw,,,,png}
+@image{lilypond/pictures/lily-flat-bw,,,,png}
+@end ifinfo
+
+
+@item @tab
+Bärenreiter (1950)
+@tab
+Henle (2000)
+
+@end multitable
+
+@cindex musical symbols
+@cindex font
+@cindex blackness
+@cindex balance
+
+When we wanted to write a computer program to create music typography,
+there were no musical fonts freely available that could match the
+elegance of our favorite scores. Not let down, we created a font of
+musical symbols, relying on nice printouts of hand-engraved music. The
+experience helped develop a typographical taste, and it made us
+appreciate subtle design details. Without that experience, we would not
+have realized how ugly the fonts were that we admired at first.
+
+Below is a sample of two music fonts: the upper set is the default font
+in the Sibelius software (the @emph{Opus} font), and the lower set is
+our own LilyPond font.
+
+@quotation
+@iftex
+@image{pictures/pdf/OpusAndFeta,,,}
+@end iftex
+@ifnottex
+@sourceimage{OpusAndFeta,,,png}
+@end ifnottex
+@end quotation
+
+The LilyPond symbols are heavier and their weight is more consistent,
+which makes them easier to read. Fine endings, such as the one on the
+bottom of the quarter rest, should not end in sharp points, but rather
+in rounded shapes. This is because sharp corners of the punching dies
+are fragile and quickly wear out when stamping in metal. Taken together,
+the blackness of the font must be carefully tuned together with the
+thickness of lines, beams and slurs to give a strong yet balanced
+overall impression.
+
+Also, notice that our half-notehead is not elliptic but slightly diamond
+shaped. The vertical stem of a flat symbol is slightly brushed, becoming
+wider at the top. The sharp and the natural are easier to distinguish
+from a distance because their angled lines have different slopes and the
+vertical strokes are heavier.
+
+@node Optical Spacing
+@unnumberedsubsec Optical Spacing
+
+In spacing, the distribution of space should reflect the durations
+between notes. However, many modern scores adhere to the
+durations with mathematical precision, which leads to poor
+results. In the next example a motive is printed twice: the first time
+using exact mathematical spacing, and the second with corrections.
+Which do you prefer?
+
+@cindex optical spacing
+
+@lilypond
+\paper {
+ ragged-right = ##t
+ indent = #0.0
+}
+
+music = {
+ c'4 e''4 e'4 b'4 |
+ \stemDown
+ b'8[ e'' a' e'']
+ \stemNeutral
+ e'8[ e'8 e'8 e'8]
+}
+\score
+{
+ \music
+ \layout {
+ \context {
+ \Staff
+ \override NoteSpacing #'stem-spacing-correction = #0.0
+ \override NoteSpacing #'same-direction-correction = #0.0
+ \override StaffSpacing #'stem-spacing-correction = #0.0
+ }
+ }
+}
+@end lilypond
+
+@lilypond
+\paper {
+ ragged-right = ##t
+ indent = #0.0
+}
+
+music = {
+ c'4 e''4 e'4 b'4 |
+ \stemDown
+ b'8[ e'' a' e'']
+ \stemNeutral
+ e'8[ e'8 e'8 e'8]
+}
+
+\score
+{
+ \music
+ \layout {
+ \context {
+ \Staff
+ \override NoteSpacing #'stem-spacing-correction = #0.6
+ }
+ }
+}
+@end lilypond
+
+@cindex regular rhythms
+@cindex regular spacing
+@cindex spacing, regular
+
+Each bar in the fragment only uses notes that are played in a
+constant rhythm. The spacing should reflect that. Unfortunately,
+the eye deceives us a little; not only does it notice the distance
+between note heads, it also takes into account the distance
+between consecutive stems. As a result, the notes of an
+up-stem/@/down-stem combination should be put farther apart, and
+the notes of a down-stem/@/up-stem combination should be put
+closer together, all depending on the combined vertical positions
+of the notes. The upper two measures are printed with this
+correction, the lower two measures, however, form down-stem/@/up-stem
+clumps of notes. A master engraver would adjust the spacing as needed to
+please the eye.
+
+Another example of optical spacing is the visual interplay between the
+stems and the bar lines. When an up-stem precedes the bar line, a little
+more space is needed to keep it from feeling crowded:
+
+@lilypond
+\paper {
+ ragged-right = ##t
+}
+
+\score {
+ {
+ c''8 c'' c'' c'' c'' c'' c'' c'' \break
+ a' a' a' a' a' a' a' a'
+ }
+ \layout {
+ \context {
+ \Staff
+ \remove "Time_signature_engraver"
+ \override NoteSpacing #'stem-spacing-correction = #0.7
+ }
+ }
+}
+@end lilypond
+
+@node Ledger Lines
+@unnumberedsubsec Ledger Lines
+
+@ifnotinfo
+@iftex
+@image{pictures/baer-ledger,4cm}
+@end iftex
+@ifnottex
+@image{pictures/baer-ledger,,,png}
+@end ifnottex
+@end ifnotinfo
+@ifinfo
+@image{lilypond/pictures/baer-ledger,,,,png}
+@end ifinfo
+
+@node Slurs
+@unnumberedsubsec Slurs
+
+@node Why work so hard?
+@unnumberedsubsec Why work so hard?
+
+Musicians are usually more absorbed with performing than with
+studying the looks of a piece of music, so nitpicking
+typographical details may seem academic. But it is not. In
+larger pieces with monotonous rhythms, spacing corrections lead to
+subtle variations in the layout of every line, giving each one a
+distinct visual signature. Without this signature all lines would
+look the same, and they become like a labyrinth. A distinct visual
+signature helps to keep musicians from losing their place on the
+page when they look away or have a lapse in concentration.
+
+Similarly, the strong visual look of bold symbols on heavy staff
+lines stands out better when the music is far away from the
+reader: for example, if it is on a music stand. A careful
+distribution of white space allows music to be set very tightly
+without crowding symbols together. The result minimizes the
+number of page turns, which is a great advantage.
+
+This is a common characteristic of typography. Layout should be
+pretty, not only for its own sake, but especially because it helps
+the reader in her task. For performance material like sheet
+music, this is of double importance: musicians have a limited
+amount of attention. The less attention they need for reading,
+the more they can focus on playing the music. In other words,
+better typography translates to better performances.
+
+These examples demonstrate that music typography is an art that is
+subtle and complex, and that producing it requires considerable
+expertise, which musicians usually do not have. LilyPond is our
+effort to bring the graphical excellence of hand-engraved music to
+the computer age, and make it available to normal musicians. We
+have tuned our algorithms, font-designs, and program settings to
+produce prints that match the quality of the old editions we love
+to see and love to play from.
+
+
+@node Automated engraving
+@unnumberedsec Automated engraving
+
+@cindex engraving, automated
+@cindex automated engraving
+
+@menu
+* Beauty contests::
+* Notation benchmarking::
+* Flexible architecture::
+@end menu
+
+@node Beauty contests
+@unnumberedsubsec Beauty contests
+
+@node Notation benchmarking
+@unnumberedsubsec Notation benchmarking
+
+Bärenreiter:
+
+@ifnotinfo
+@iftex
+@image{pictures/baer-sarabande,16cm}
+@end iftex
+@ifnottex
+@image{pictures/baer-sarabande,,,png}
+@end ifnottex
+@end ifnotinfo
+@ifinfo
+@image{lilypond/pictures/baer-sarabande,,,,png}
+@end ifinfo
+
+LilyPond 1.4:
+
+@ifnotinfo
+@iftex
+@image{pictures/lily14-sarabande,16cm}
+@end iftex
+@ifnottex
+@image{pictures/lily14-sarabande,,,png}
+@end ifnottex
+@end ifnotinfo
+@ifinfo
+@image{lilypond/pictures/lily14-sarabande,,,,png}
+@end ifinfo
+
+LilyPond @version{}:
+
+@lilypond[relative=0,staffsize=19,line-width=16\cm]
+{
+ \clef "bass"
+ \key d \minor
+ \time 3/4
+ \mergeDifferentlyDottedOn
+ << {d8. e16 e4. d16 e} \\ {d4 a2} >>
+ <f' a, d,>4. e8 d c
+ bes g' f e16( f g a bes d,)
+ cis4. b8 a g
+ << {d'8. e16 e4. d16 e} \\ {<f, a>4 a2} >>
+}
+@end lilypond
+
+[LilyPond snippet above not finished]
+
+[a few bars of LilyPond vs. Finale can go here]
+
+@node Flexible architecture
+@unnumberedsubsec Flexible architecture
+
+How do we go about implementing typography? If craftsmen need
+over ten years to become true masters, how could we simple hackers
+ever write a program to take over their jobs?
+
+The answer is: we cannot. Typography relies on human judgment of
+appearance, so people cannot be replaced completely. However,
+much of the dull work can be automated. If LilyPond solves most
+of the common situations correctly, this will be a huge
+improvement over existing software. The remaining cases can be
+tuned by hand. Over the course of years, the software can be
+refined to do more and more things automatically, so manual
+overrides are less and less necessary.
+
+When we started, we wrote the LilyPond program entirely in the C++
+programming language; the program's functionality was set in stone
+by the developers. That proved to be unsatisfactory for a number
+of reasons:
+
+@itemize
+
+@item When LilyPond makes mistakes, users need to override
+formatting decisions. Therefore, the user must have access to the
+formatting engine. Hence, rules and settings cannot be fixed by
+us at compile-time but must be accessible for users at run-time.
+
+@item Engraving is a matter of visual judgment, and therefore a
+matter of taste. As knowledgeable as we are, users can disagree
+with our personal decisions. Therefore, the definitions of
+typographical style must also be accessible to the user.
+
+@item Finally, we continually refine the formatting algorithms, so
+we need a flexible approach to rules. The C++ language forces a
+certain method of grouping rules that cannot readily be applied to
+formatting music notation.
+
+@end itemize
+
+@cindex Scheme programming language
+
+These problems have been addressed by integrating an interpreter
+for the Scheme programming language and rewriting parts of
+LilyPond in Scheme. The current formatting architecture is built
+around the notion of graphical objects, described by Scheme
+variables and functions. This architecture encompasses formatting
+rules, typographical style and individual formatting decisions.
+The user has direct access to most of these controls.
+
+Scheme variables control layout decisions. For example, many
+graphical objects have a direction variable that encodes the
+choice between up and down (or left and right). Here you see two
+chords, with accents and arpeggios. In the first chord, the
+graphical objects have all directions down (or left). The second
+chord has all directions up (right).
+
+@lilypond[quote,ragged-right]
+\new Score \with {
+ \override SpacingSpanner #'spacing-increment = #3
+ \override TimeSignature #'transparent = ##t
+} \relative c' {
+ \stemDown <e g b>4_>-\arpeggio
+ \override Arpeggio #'direction = #RIGHT
+ \stemUp <e g b>4^>-\arpeggio
+}
+@end lilypond