The images below illustrate the difference between traditional
engraving and typical computer output, and the third picture shows how
LilyPond mimics the traditional look. The left picture shows a scan
-of a flat symbol from a Henle edition published in 2000. The center
+of a flat symbol from an edition published in 2000. The center
depicts a symbol from a hand-engraved B@"{a}renreiter edition of the
same music. The left scan illustrates typical flaws of computer
print: the staff lines are thin, the weight of the flat symbol matches
contrast, the B@"{a}renreiter flat has a bold, almost voluptuous
rounded look. Our flat symbol is designed after, among others, this
one. It is rounded, and its weight harmonizes with the thickness of
-our staff lines, which are also much thicker than Henle's lines.
+our staff lines, which are also much thicker than lines in the
+computer edition.
@multitable @columnfractions .05 .3 .3 .3 .05
@item @tab
spot which fragment is which?
@cindex optical spacing
-@lilypond[quote,noindent,fragment]
-{
- \override Staff.NoteSpacing #'stem-spacing-correction = #0.6
- c'4 e''4 e'4 b'4 |
- \stemDown b'4 e''4 a'4 e''4 | \bar "||"
- \override Staff.NoteSpacing #'stem-spacing-correction = #0.0
- \override Staff.StaffSpacing #'stem-spacing-correction = #0.0
- \stemNeutral c'4 e''4 e'4 b'4 |
- \stemDown b'4 e''4 a'4 e''4 |
-}
-@end lilypond
+@lilypondfile[quote,noindent]{spacing-optical.ly}
@cindex regular rhythms
@cindex regular spacing
have all directions down (or left). The second chord has all
directions up (right).
-@lilypond[quote,raggedright,relative=1]
+@lilypond[quote,raggedright]
\new Score \with {
\override SpacingSpanner #'spacing-increment = #3
\override TimeSignature #'transparent = ##t
-} {
+} \relative {
\stemDown <e g b>4_>-\arpeggio
\override Arpeggio #'direction = #RIGHT
\stemUp <e g b>4^>-\arpeggio
(if (and (memq 'note-head-interface interfaces)
(memq pos '(-2 -3 -5)))
(begin
- (ly:grob-set-property! grob 'print-function brew-new-markup-stencil)
+ (ly:grob-set-property! grob 'print-function Text_interface::print)
(ly:grob-set-property! grob 'font-family 'roman)
(ly:grob-set-property!
grob 'text
@ifhtml
The
@end ifhtml
-@emph{@ref{Notation manual}}
+@c @emph{@ref{Notation manual}} @c FIXME
+@emph{Notation manual}
discusses topics grouped by notation construct. Once you master the
basics, this is the place to look up details.
@item
@ifhtml
-The
+The chapter
@end ifhtml
-@emph{@ref{Integrating text and music}}
-explains the details behind creating documents with in-line music
-examples (like this manual).
+@emph{@ref{LilyPond-book}} explains the details behind creating
+documents with in-line music examples (like this manual).
@item
@ifhtml
and you cannot find it in the manual, that is considered a bug. In
that case, please file a bug report.}, but the document is also
available in
-@ifnothtml
+@iftex
a big HTML page,
-@end ifnothtml
+@end iftex
@ifhtml
-@uref{../lilypond.html, a big HTML page}
+@uref{source/Documentation/user/out-www/lilypond.html, one big page},
@end ifhtml
which can be searched easily using the search facility of a web
browser.
@c add/integrate glossary, put in list above
If you are not familiar with music notation or music terminology
(especially if you are a non-native English speaker), it is advisable
-to consult the glossary as well. The glossary explains musical terms,
-and includes translations to various languages. It is a
-@ifhtml
-@uref{../music-glossary.html,separate document}.
-@end ifhtml
-@ifnothtml
-separate document, available in HTML and PDF.
-@end ifnothtml
+to consult the glossary as well.
+@iftex
+The music glossary explains musical terms, and includes translations
+to various languages. It is a separate document, available in HTML
+and PDF.
+@end iftex
+@ifnottex
+The @ref{Top,Music glossary,,music-glossary}, explains musical terms and
+includes translations to various languages. It is also available in
+PDF.
+@end ifnottex
@cindex idiom
@cindex jargon
@cindex terminology
This manual is not complete without a number of other documents. They
are not available in print, but should be included with the
-documentation package for your platform:
+documentation package for your platform
@itemize @bullet
@item
+@iftex
Program reference
-@ifhtml
-(available @uref{../lilypond-internals/lilypond-internals.html,here})
-@end ifhtml
+@end iftex
+@ifnottex
+@ref{Top,Program reference,,lilypond-internals}.
+@end ifnottex
The program reference is a set of heavily cross linked HTML pages,
which document the nitty-gritty details of each and every LilyPond
generated documentation. In the HTML document, these subsections
have clickable links.
+@cindex snippets
@item
-Various input examples
+@ifnothtml
+Various input examples.
+@end ifnothtml
@ifhtml
-(available @uref{../../../../input/test/out-www/collated-files.html,here})
+@c Works, but link name is not so nice; so write-out macro
+@c @inputfileref{input/test,Various input examples}.
+@uref{source/input/test/out-www/collated-files.html,Various input examples}.
@end ifhtml
-@cindex snippets
This collection of files shows various tips and tricks, and is
available as a big HTML document, with pictures and explanatory texts
included.
@item
-The regression tests
+@ifnothtml
+The regression tests.
+@end ifnothtml
@ifhtml
-(available @uref{../../../../input/regression/out-www/collated-files.html,here})
+@c Works, but link name is not so nice; so write-out macro
+@c @inputfileref{input/regression,The regression tests}.
+@uref{source/input/regression/out-www/collated-files.html,The regression tests}.
@end ifhtml
This collection of files tests each notation and engraving feature of