]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/expressive.itely
projects / lilypond.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Doc Index expressive.itely part 1
[lilypond.git] / Documentation / user / expressive.itely
diff --git a/Documentation/user/expressive.itely b/Documentation/user/expressive.itely
index 5fd3da490ef0c19ecf9a575f3e6fad93137ea708..70e896321aa72c316e9fc3f328ad6c24e022adf9 100644 (file)
--- a/Documentation/user/expressive.itely
+++ b/Documentation/user/expressive.itely
@@ -6,13 +6,16 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c \version "2.11.38"
+@c \version "2.11.57"
 
 @node Expressive marks
 @section Expressive marks
 
 @lilypondfile[quote]{expressive-headword.ly}
 
 
 @node Expressive marks
 @section Expressive marks
 
 @lilypondfile[quote]{expressive-headword.ly}
 
+This section lists various expressive marks that can be
+created in a score.
+
 @menu
 * Attached to notes::           
 * Curves::                      
 @menu
 * Attached to notes::           
 * Curves::                      
@@ -23,6 +26,10 @@
 @node Attached to notes
 @subsection Attached to notes
 
 @node Attached to notes
 @subsection Attached to notes
 
+This section explains how to create expressive marks that are
+attached to notes: articulations, ornamentations, and dynamics.
+Methods to create new dynamic markings are also discussed.
+
 @menu
 * Articulations and ornamentations::  
 * Dynamics::                    
 @menu
 * Articulations and ornamentations::  
 * Dynamics::                    
@@ -30,9 +37,10 @@
 @end menu
 
 @node Articulations and ornamentations
 @end menu
 
 @node Articulations and ornamentations
-@subsubsection Articulations and ornamentations
+@unnumberedsubsubsec Articulations and ornamentations
 
 @cindex articulations
 
 @cindex articulations
+@cindex ornamentation
 @cindex scripts
 @cindex ornaments
 @cindex espressivo
 @cindex scripts
 @cindex ornaments
 @cindex espressivo
@@ -41,6 +49,7 @@
 @cindex downbow
 @cindex foot marks
 @cindex organ pedal marks
 @cindex downbow
 @cindex foot marks
 @cindex organ pedal marks
+@cindex pedal marks, organ
 @cindex turn
 @cindex open
 @cindex stopped
 @cindex turn
 @cindex open
 @cindex stopped
@@ -58,6 +67,8 @@
 @cindex coda
 @cindex varcoda
 
 @cindex coda
 @cindex varcoda
 
+@funindex -
+
 A variety of symbols that denote articulations, ornamentations,
 and other performance indications can be attached to a note using
 this syntax:
 A variety of symbols that denote articulations, ornamentations,
 and other performance indications can be attached to a note using
 this syntax:
@@ -75,7 +86,6 @@ c1\fermata
 @end lilypond
 
 @cindex marcato
 @end lilypond
 
 @cindex marcato
-@cindex stopped
 @cindex tenuto
 @cindex staccatissimo
 @cindex accent
 @cindex tenuto
 @cindex staccatissimo
 @cindex accent
@@ -84,16 +94,15 @@ c1\fermata
 
 Some of these articulations have shorthands for easier entry.
 Shorthands are appended to the note name, and their syntax
 
 Some of these articulations have shorthands for easier entry.
 Shorthands are appended to the note name, and their syntax
-consists of a dash (@tie{}@code{-}) followed by a symbol
-signifying the articulation.  Predefined shorthands exist for
-@notation{marcato}, @notation{stopped}, @notation{tenuto},
-@notation{staccatissimo}, @notation{accent}, @notation{staccato},
-and @notation{portato}.  Their corresponding output appears as
-follows:
+consists of a dash @code{-} followed by a symbol signifying the
+articulation.  Predefined shorthands exist for @notation{marcato},
+@notation{stopped}, @notation{tenuto}, @notation{staccatissimo},
+@notation{accent}, @notation{staccato}, and @notation{portato}.
+Their corresponding output appears as follows:
 
 @lilypond[verbatim,quote,relative=2]
 c4-^  c-+  c--  c-|
 
 @lilypond[verbatim,quote,relative=2]
 c4-^  c-+  c--  c-|
-c->   c-.  c-_
+c4->  c-.  c2-_
 @end lilypond
 
 The rules for the default placement of articulations are defined
 @end lilypond
 
 The rules for the default placement of articulations are defined
@@ -120,7 +129,8 @@ Music Glossary:
 @rglos{portato}.
 
 Notation Reference:
 @rglos{portato}.
 
 Notation Reference:
-@ref{Direction and placement}.
+@ref{Direction and placement},
+@ref{List of articulations}.
 
 Installed Files:
 @file{scm/@/script@/.scm}.
 
 Installed Files:
 @file{scm/@/script@/.scm}.
@@ -133,36 +143,49 @@ Internals Reference:
 @rinternals{TextScript}.
 
 
 @rinternals{TextScript}.
 
 
-@knownissues
-
-These signs appear in the printed output but have no effect on the
-MIDI rendering of the music.
-
-
 @node Dynamics
 @node Dynamics
-@subsubsection Dynamics
+@unnumberedsubsubsec Dynamics
 
 @cindex absolute dynamics
 @cindex dynamics
 @cindex dynamics, absolute
 
 @cindex absolute dynamics
 @cindex dynamics
 @cindex dynamics, absolute
+
 @funindex \ppppp
 @funindex \ppppp
+@funindex ppppp
 @funindex \pppp
 @funindex \pppp
+@funindex pppp
 @funindex \ppp
 @funindex \ppp
+@funindex ppp
 @funindex \pp
 @funindex \pp
+@funindex pp
 @funindex \p
 @funindex \p
+@funindex p
 @funindex \mp
 @funindex \mp
+@funindex mp
 @funindex \mf
 @funindex \mf
+@funindex mf
 @funindex \f
 @funindex \f
+@funindex f
 @funindex \ff
 @funindex \ff
+@funindex ff
 @funindex \fff
 @funindex \fff
+@funindex fff
 @funindex \ffff
 @funindex \ffff
+@funindex ffff
 @funindex \fp
 @funindex \fp
+@funindex fp
 @funindex \sf
 @funindex \sf
+@funindex sf
 @funindex \sff
 @funindex \sff
+@funindex sff
 @funindex \sp
 @funindex \sp
+@funindex sp
 @funindex \spp
 @funindex \spp
+@funindex spp
 @funindex \sfz
 @funindex \sfz
+@funindex sfz
 @funindex \rfz
 @funindex \rfz
+@funindex rfz
 
 Absolute dynamic marks are specified using a command after a note,
 such as @code{c4\ff}.  The available dynamic marks are
 
 Absolute dynamic marks are specified using a command after a note,
 such as @code{c4\ff}.  The available dynamic marks are
@@ -170,30 +193,36 @@ such as @code{c4\ff}.  The available dynamic marks are
 @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
 @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
 @code{\spp}, @code{\sfz}, and @code{\rfz}.  The dynamic marks may
 @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
 @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
 @code{\spp}, @code{\sfz}, and @code{\rfz}.  The dynamic marks may
-be manually placed above or below the staff, see 
+be manually placed above or below the staff, see
 @ref{Direction and placement}.
 
 @lilypond[verbatim,quote,relative=2]
 c2\ppp c\mp
 @ref{Direction and placement}.
 
 @lilypond[verbatim,quote,relative=2]
 c2\ppp c\mp
-c\rfz c^\mf
-c_\spp c^\ff
+c2\rfz c^\mf
+c2_\spp c^\ff
 @end lilypond
 
 @cindex hairpin
 @end lilypond
 
 @cindex hairpin
+@cindex crescendo
+@cindex decrescendo
+@cindex diminuendo
+
 @funindex \<
 @funindex \>
 @funindex \!
 @funindex \cr
 @funindex \<
 @funindex \>
 @funindex \!
 @funindex \cr
+@funindex cr
 @funindex \decr
 @funindex \decr
+@funindex decr
 
 A @notation{crescendo} mark is started with @code{\<} and
 terminated with @code{\!}, an absolute dynamic, or an additional
 
 A @notation{crescendo} mark is started with @code{\<} and
 terminated with @code{\!}, an absolute dynamic, or an additional
-@notation{crescendo} or @notation{decrescendo} mark.  A
-@notation{decrescendo} mark is started with @code{\>} and is also
-terminated with @code{\!}, an absolute dynamic, or another
-@notation{crescendo} or @notation{decrescendo} mark.  @code{\cr}
-and @code{\decr} may be used instead of @code{\<} and @code{\>}.
-@notation{Hairpins} are engraved by default using this notation.
+crescendo or decrescendo mark.  A @notation{decrescendo} mark is
+started with @code{\>} and is also terminated with @code{\!}, an
+absolute dynamic, or another crescendo or decrescendo mark.
+@code{\cr} and @code{\decr} may be used instead of @code{\<} and
+@code{\>}.  @notation{Hairpins} are engraved by default using this
+notation.
 
 @lilypond[verbatim,quote,relative=2]
 c2\< c\!
 
 @lilypond[verbatim,quote,relative=2]
 c2\< c\!
@@ -205,7 +234,10 @@ d2\> d\>
 c1\!
 @end lilypond
 
 c1\!
 @end lilypond
 
-Spacer notes are needed to engrave multiple marks on one note.
+Spacer rests are needed to engrave multiple marks on one note.
+
+@cindex multiple dynamic marks on one note
+@cindex dynamic marks, multiple on one note
 
 @lilypond[verbatim,quote,relative=2]
 c4\< c\! d\> e\!
 
 @lilypond[verbatim,quote,relative=2]
 c4\< c\! d\> e\!
@@ -214,48 +246,60 @@ c4\< c\! d\> e\!
 
 @cindex espressivo articulation
 
 
 @cindex espressivo articulation
 
+@funindex \espressivo
+@funindex espressivo
+
 In some situations the @code{\espressivo} articulation mark may be
 In some situations the @code{\espressivo} articulation mark may be
-the appropriate choice to indicate a @notation{crescendo} and
-@notation{decrescendo} on one note:
+the appropriate choice to indicate a crescendo and decrescendo on
+one note:
 
 @lilypond[verbatim,quote,relative=2]
 c2 b4 a
 g1\espressivo
 @end lilypond
 
 
 @lilypond[verbatim,quote,relative=2]
 c2 b4 a
 g1\espressivo
 @end lilypond
 
-@cindex crescendo
-@cindex decrescendo
-@cindex diminuendo
-@funindex \setTextCresc
-@funindex \setTextDim
-@funindex \setTextDecr
-@funindex \setTextDecresc
-@funindex \setHairpinCresc
-@funindex \setHairpinDim
-@funindex \setHairpinDecresc
-
-@notation{Crescendos} and @notation{decrescendos} can be engraved
-as textual markings instead of hairpins.  The built-in commands
-that enable these text modes are @code{\setTextCresc},
-@code{\setTextDecresc}, @code{\setTextDecr}, and
-@code{\setTextDim}.  The corresponding @code{\setHairpinCresc},
-@code{\setHairpinDim}, and @code{\setHairpinDecresc} commands will
-revert to hairpins again:
+
+@funindex \crescTextCresc
+@funindex crescTextCresc
+@funindex \dimTextDecresc
+@funindex dimTextDecresc
+@funindex \dimTextDecr
+@funindex dimTextDecr
+@funindex \dimTextDim
+@funindex dimTextDim
+@funindex \crescHairpin
+@funindex crescHairpin
+@funindex \dimHairpin
+@funindex dimHairpin
+
+Crescendos and decrescendos can be engraved as textual markings
+instead of hairpins.  Dashed lines are printed to indicate their
+extent.  The built-in commands that enable these text modes are
+@code{\crescTextCresc}, @code{\dimTextDecresc},
+@code{\dimTextDecr}, and @code{\dimTextDim}.  The corresponding
+@code{\crescHairpin} and @code{\dimHairpin} commands will revert
+to hairpins again:
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
-c\< d e f\!
-e\> d c b\!
-\setTextCresc
-c\< d e f\!
-\setTextDecresc
-e\> d c b\!
-\setHairpinCresc
-c\< d e f\!
+\crescTextCresc
+c2\< d | e f\!
+\dimTextDecresc
+e2\> d | c b\!
+\crescHairpin
+c2\< d | e f\!
+\dimHairpin
+e2\> d\!
 @end lilypond
 
 @end lilypond
 
+
 To create new absolute dynamic marks or text that should be
 aligned with dynamics, see @ref{New dynamic marks}.
 
 To create new absolute dynamic marks or text that should be
 aligned with dynamics, see @ref{New dynamic marks}.
 
+@cindex dynamics, vertical positioning
+@cindex vertical positioning of dynamics
+
+@funindex DynamicLineSpanner
+
 Vertical positioning of dynamics is handled by
 @rinternals{DynamicLineSpanner}.
 
 Vertical positioning of dynamics is handled by
 @rinternals{DynamicLineSpanner}.
 
@@ -263,11 +307,20 @@ Vertical positioning of dynamics is handled by
 @predefined
 
 @funindex \dynamicUp
 @predefined
 
 @funindex \dynamicUp
+@funindex dynamicUp
 @code{\dynamicUp},
 @funindex \dynamicDown
 @code{\dynamicUp},
 @funindex \dynamicDown
+@funindex dynamicDown
 @code{\dynamicDown},
 @funindex \dynamicNeutral
 @code{\dynamicDown},
 @funindex \dynamicNeutral
-@code{\dynamicNeutral}.
+@funindex dynamicNeutral
+@code{\dynamicNeutral},
+@code{\crescTextCresc},
+@code{\dimTextDim},
+@code{\dimTextDecr},
+@code{\dimTextDecresc},
+@code{\crescHairpin},
+@code{\dimHairpin}.
 
 
 @snippets
 
 
 @snippets
@@ -285,43 +338,13 @@ Vertical positioning of dynamics is handled by
 {printing-hairpins-using-al-niente-notation.ly}
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {printing-hairpins-using-al-niente-notation.ly}
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{vertically-aligning-dynamics-across-multiple-notes.ly}
-
-@c I can't figure this one out.  Consider removing this.  -pm
-
-@notation{Crescendi} and @notation{decrescendi} that cross a line
-break will be continued on the second line.  If they end on the
-first note of a new line, nothing will be printed on that line.
-To change this behavior, use
-
-@example
-\override Score.Hairpin #'after-line-breaking = ##t
-@end example
+{vertically-aligned-dynamics-and-textscripts.ly}
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {hiding-the-extender-line-for-text-dynamics.ly}
 
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {hiding-the-extender-line-for-text-dynamics.ly}
 
-@c The following snippet goes in input/new/
-@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-@c {changing-text-and-spanner-styles-for-text-dynamics.ly}
-
-The text used for @notation{crescendos} and
-@notation{decrescendos} can be changed by modifying the context
-properties @code{crescendoText} and @code{decrescendoText}.  The
-style of the spanner line can be changed by modifying the
-@code{'style} property of @code{DynamicTextSpanner}.  The default
-value is @code{'hairpin}, and other possible values include
-@code{'line}, @code{'dashed-line}, and @code{'dotted-line}:
-
-@lilypond[verbatim,quote,relative=2]
-\set crescendoText = \markup { \italic "cresc. poco" }
-\set crescendoSpanner = #'text
-\override DynamicTextSpanner #'style = #'dotted-line
-a2\< a
-a2 a
-a2 a
-a2 a\mf
-@end lilypond
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing-text-and-spanner-styles-for-text-dynamics.ly}
 
 
 @seealso
 
 
 @seealso
@@ -336,7 +359,10 @@ Learning Manual:
 @rlearning{Articulation and dynamics}.
 
 Notation Reference:
 @rlearning{Articulation and dynamics}.
 
 Notation Reference:
-@ref{Direction and placement}.
+@ref{Direction and placement},
+@ref{New dynamic marks},
+@ref{What goes into the MIDI output?},
+@ref{Controlling MIDI dynamics}.
 
 Snippets:
 @rlsr{Expressive marks}.
 
 Snippets:
 @rlsr{Expressive marks}.
@@ -348,7 +374,7 @@ Internals Reference:
 
 
 @node New dynamic marks
 
 
 @node New dynamic marks
-@subsubsection New dynamic marks
+@unnumberedsubsubsec New dynamic marks
 
 @cindex new dynamic marks
 @cindex dynamic marks, new
 
 @cindex new dynamic marks
 @cindex dynamic marks, new
@@ -360,33 +386,39 @@ The easiest way to create dynamic indications is to use
 moltoF = \markup { molto \dynamic f }
 
 \relative c' {
 moltoF = \markup { molto \dynamic f }
 
 \relative c' {
-  <d e>16 <d e>
-  <d e>2.._\moltoF
+  <d e>16_\moltoF <d e>
+  <d e>2..
 }
 @end lilypond
 
 @cindex dynamics, editorial
 @cindex dynamics, parenthesis
 }
 @end lilypond
 
 @cindex dynamics, editorial
 @cindex dynamics, parenthesis
+@cindex editorial dynamics
+@funindex \bracket
+@funindex bracket
+@funindex \dynamic
+@funindex dynamic
 
 
-Markup mode makes possible, for instance, to add
-editorial dynamics, printed in round parenthesis or square
-brackets.  Its syntax is described in @ref{Formatting text}.
+In markup mode, editorial dynamics (within parentheses or square
+brackets) can be created.  The syntax for markup mode is described
+in @ref{Formatting text}.
 
 @lilypond[verbatim,quote]
 
 @lilypond[verbatim,quote]
-rndf = \markup { \center-align { \line { \bold { \italic ( }
-         \dynamic f \bold { \italic ) } } } }
-boxf = \markup { \bracket { \dynamic f } }
+roundF = \markup { \center-align \concat { \bold { \italic ( }
+           \dynamic f \bold { \italic ) } } }
+boxF = \markup { \bracket { \dynamic f } }
 \relative c' {
 \relative c' {
-  c1_\rndf
-  c1_\boxf
+  c1_\roundF
+  c1_\boxF
 }
 @end lilypond
 
 }
 @end lilypond
 
-Markup objects are treated differently from authentic dynamic marks.
-Defining dynamic objects that will be entered and printed exactly like
-standard dynamic marks is also possible, using the following function:
-
 @cindex make-dynamic-script
 @cindex make-dynamic-script
+@funindex make-dynamic-script
+
+Simple, centered dynamic marks are easily created with the
+@code{make-dynamic-script} function.  The dynamic font only
+contains the characters @code{f,m,p,r,s} and @code{z}.
 
 @lilypond[verbatim,quote]
 sfzp = #(make-dynamic-script "sfzp")
 
 @lilypond[verbatim,quote]
 sfzp = #(make-dynamic-script "sfzp")
@@ -395,33 +427,51 @@ sfzp = #(make-dynamic-script "sfzp")
 }
 @end lilypond
 
 }
 @end lilypond
 
-@noindent
-Note that the dynamic font only contains the characters 
-@code{f,m,p,r,s} and @code{z}.  To switch to other font families,
-it is necessary to use markup mode in its Scheme form, as
+In general, @code{make-dynamic-script} takes any markup object as
+its argument.  In the following example, using
+@code{make-dynamic-script} ensures the vertical alignment of
+markup objects and hairpins that are attached to the same note
+head.
+
+@lilypond[verbatim,quote]
+roundF = \markup { \center-align \concat {
+           \normal-text { \bold { \italic ( } }
+           \dynamic f
+           \normal-text { \bold { \italic ) } } } }
+boxF = \markup { \bracket { \dynamic f } }
+roundFdynamic = #(make-dynamic-script roundF)
+boxFdynamic = #(make-dynamic-script boxF)
+\relative c' {
+  c4_\roundFdynamic\< d e f
+  g,1_\boxFdynamic
+}
+@end lilypond
+
+The Scheme form of markup mode may be used instead.  Its syntax is
 explained in @ref{Markup construction in Scheme}.
 
 @lilypond[verbatim,quote]
 explained in @ref{Markup construction in Scheme}.
 
 @lilypond[verbatim,quote]
-moltoF = #(make-dynamic-script (markup 
-                      #:normal-text "molto"
-                      #:dynamic "f"))
+moltoF = #(make-dynamic-script
+            (markup #:normal-text "molto"
+                    #:dynamic "f"))
 \relative c' {
   <d e>16 <d e>
   <d e>2..\moltoF
 }
 @end lilypond
 
 \relative c' {
   <d e>16 <d e>
   <d e>2..\moltoF
 }
 @end lilypond
 
-@noindent
 Font settings in markup mode are described in
 Font settings in markup mode are described in
-@ref{Common markup commands}.
+@ref{Selecting font and font size}.
 
 
 @seealso
 
 Notation Reference:
 @ref{Formatting text},
 
 
 @seealso
 
 Notation Reference:
 @ref{Formatting text},
-@ref{Common markup commands},
-@ref{Markup construction in Scheme}.
+@ref{Selecting font and font size},
+@ref{Markup construction in Scheme},
+@ref{What goes into the MIDI output?},
+@ref{Controlling MIDI dynamics}.
 
 Snippets:
 @rlsr{Expressive marks}.
 
 Snippets:
 @rlsr{Expressive marks}.
@@ -430,6 +480,10 @@ Snippets:
 @node Curves
 @subsection Curves
 
 @node Curves
 @subsection Curves
 
+This section explains how to create various expressive marks that
+are curved: normal slurs, phrasing slurs, breath marks, falls, and
+doits.
+
 @menu
 * Slurs::                       
 * Phrasing slurs::              
 @menu
 * Slurs::                       
 * Phrasing slurs::              
@@ -438,30 +492,74 @@ Snippets:
 @end menu
 
 @node Slurs
 @end menu
 
 @node Slurs
-@subsubsection Slurs
+@unnumberedsubsubsec Slurs
 
 @cindex slurs
 
 
 @cindex slurs
 
-A @notation{slur} indicates that notes are to be played bound or
-@emph{legato}.  They are entered using parentheses:
+@notation{Slurs} are entered using parentheses:
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
-f( g a) a8 b( a4 g2 f4)
+f4( g a) a8 b(
+a4 g2 f4)
 <c e>2( <b d>2)
 @end lilypond
 
 <c e>2( <b d>2)
 @end lilypond
 
-Just as with ties, the direction of a slur can be specified with
-@code{\slur@emph{DIR}}, where @code{@emph{DIR}} is either
-@code{Up}, @code{Down}, or @code{Neutral} (@code{Neutral} is the
-default).  Slurs may be manually placed above or below the staff,
-see @ref{Direction and placement}.
+@cindex slurs, manual placement
+@cindex slurs, below notes
+@cindex slurs, above notes
+@funindex \slurDown
+@funindex slurDown
+@funindex \slurNeutral
+@funindex slurNeutral
+
+Slurs may be manually placed above or below the notes, see
+@ref{Direction and placement}.
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
-c4_( c) c^( c)
+c2( d)
+\slurDown
+c2( d)
+\slurNeutral
+c2( d)
 @end lilypond
 
 @end lilypond
 
-Using this method, only one slur can be printed at once.  To print
-a long slur over a few small slurs, see @ref{Phrasing slurs}.
+@cindex phrasing slur
+@cindex multiple slurs
+@cindex simultaneous slurs
+@cindex slur, phrasing
+@cindex slurs, multiple
+@cindex slurs, simultaneous
+
+Phrasing slurs must be used to print more than one slur at once.
+For details, see @ref{Phrasing slurs}.
+
+@cindex slur style
+@cindex slur, solid
+@cindex slur, dotted
+@cindex slur, dashed
+@cindex solid slur
+@cindex dotted slur
+@cindex dashed slur
+@cindex sytle, slur
+@funindex \slurDashed
+@funindex slurDashed
+@funindex \slurDotted
+@funindex slurDotted
+@funindex \slurSolid
+@funindex slurSolid
+
+Slurs can be solid, dotted, or dashed.  Solid is the default slur
+style:
+
+@lilypond[verbatim,quote,relative=1]
+c4( e g2)
+\slurDashed
+g4( e c2)
+\slurDotted
+c4( e g2)
+\slurSolid
+g4( e c2)
+@end lilypond
 
 
 @predefined
 
 
 @predefined
@@ -491,8 +589,12 @@ a long slur over a few small slurs, see @ref{Phrasing slurs}.
 Music Glossary:
 @rglos{slur}.
 
 Music Glossary:
 @rglos{slur}.
 
+Learning Manual:
+@rlearning{On the un-nestedness of brackets and ties}.
+
 Notation Reference:
 Notation Reference:
-@ref{Direction and placement}.
+@ref{Direction and placement},
+@ref{Phrasing slurs}.
 
 Snippets:
 @rlsr{Expressive marks}.
 
 Snippets:
 @rlsr{Expressive marks}.
@@ -502,44 +604,65 @@ Internals Reference:
 
 
 @node Phrasing slurs
 
 
 @node Phrasing slurs
-@subsubsection Phrasing slurs
+@unnumberedsubsubsec Phrasing slurs
 
 @cindex phrasing slurs
 @cindex phrasing marks
 
 @cindex phrasing slurs
 @cindex phrasing marks
+@cindex slur, phrasing
+@cindex mark, phrasing
 @funindex \(
 @funindex \)
 
 @funindex \(
 @funindex \)
 
-A phrasing slur (or phrasing mark) connects notes and is used to
-indicate a musical sentence.  It is written using @code{\(} and
+@notation{Phrasing slurs} (or phrasing marks) that indicate a
+musical sentence are written using the commands @code{\(} and
 @code{\)} respectively:
 
 @lilypond[verbatim,quote,relative=2]
 @code{\)} respectively:
 
 @lilypond[verbatim,quote,relative=2]
-\time 6/4 c\( d( e) f( e) d\)
+c4\( d( e) f(
+e2) d\)
 @end lilypond
 
 @end lilypond
 
-Typographically, the phrasing slur behaves almost exactly like a
-normal slur.  However, they are treated as different objects.  A
-@code{\slurUp} will have no effect on a phrasing slur; instead,
-use @code{\phrasingSlurUp}, @code{\phrasingSlurDown}, and
-@code{\phrasingSlurNeutral}.  Phrasing slurs may be manually
-placed above or below the staff, see @ref{Direction
-and placement}.
+@funindex \phrasingSlurUp
+@funindex phrasingSlurUp
+@funindex \phrasingSlurDown
+@funindex phrasingSlurDown
+@funindex \phrasingSlurNeutral
+@funindex phrasingSlurNeutral
+
+Typographically, a phrasing slur behaves almost exactly like a
+normal slur.  However, they are treated as different objects; a
+@code{\slurUp} will have no effect on a phrasing slur.  Phrasing
+slurs may be manually placed above or below the notes, see
+@ref{Direction and placement}.
+
+@lilypond[verbatim,quote,relative=1]
+c4\( g' c,( b) | c1\)
+\phrasingSlurUp
+c4\( g' c,( b) | c1\)
+@end lilypond
 
 
-You cannot have simultaneous phrasing slurs.
+@cindex simultaneous phrasing slurs
+@cindex multiple phrasing slurs
+@cindex slurs, simultaneous phrasing
+@cindex slurs, multiple phrasing
+@cindex phrasing slurs, simultaneous
+@cindex phrasing slurs, multiple
+
+Simultaneous phrasing slurs are not permitted.
 
 
 @predefined
 
 
 
 @predefined
 
-@funindex \phrasingSlurUp
 @code{\phrasingSlurUp},
 @code{\phrasingSlurUp},
-@funindex \phrasingSlurDown
 @code{\phrasingSlurDown},
 @code{\phrasingSlurDown},
-@funindex \phrasingSlurNeutral
 @code{\phrasingSlurNeutral}.
 
 
 @seealso
 
 @code{\phrasingSlurNeutral}.
 
 
 @seealso
 
+Learning Manual:
+@rlearning{On the un-nestedness of brackets and ties}.
+
 Notation Reference:
 @ref{Direction and placement}.
 
 Notation Reference:
 @ref{Direction and placement}.
 
@@ -551,26 +674,39 @@ Internals Reference:
 
 
 @node Breath marks
 
 
 @node Breath marks
-@subsubsection Breath marks
+@unnumberedsubsubsec Breath marks
 
 @cindex breath marks
 @funindex \breathe
 
 @cindex breath marks
 @funindex \breathe
+@funindex breathe
 
 Breath marks are entered using @code{\breathe}:
 
 @lilypond[verbatim,quote,relative=2]
 
 Breath marks are entered using @code{\breathe}:
 
 @lilypond[verbatim,quote,relative=2]
-c4 \breathe d4
+c2. \breathe d4
 @end lilypond
 
 @end lilypond
 
+Musical indicators for breath marks in ancient notation,
+divisiones, are supported.  For details, see @ref{Divisiones}.
+
 
 @snippets
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {changing-the-breath-mark-symbol.ly}
 
 
 @snippets
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {changing-the-breath-mark-symbol.ly}
 
+@cindex caesura
+@cindex railroad tracks
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{inserting-a-caesura.ly}
+
 
 @seealso
 
 
 @seealso
 
+Notation Reference:
+@ref{Divisiones}.
+
 Snippets:
 @rlsr{Expressive marks}.
 @c @lsr{expressive,breathing-sign.ly}.
 Snippets:
 @rlsr{Expressive marks}.
 @c @lsr{expressive,breathing-sign.ly}.
@@ -580,24 +716,28 @@ Internals Reference:
 
 
 @node Falls and doits
 
 
 @node Falls and doits
-@subsubsection Falls and doits
+@unnumberedsubsubsec Falls and doits
 
 @cindex falls
 @cindex doits
 @funindex \bendAfter
 
 @cindex falls
 @cindex doits
 @funindex \bendAfter
+@funindex bendAfter
 
 @notation{Falls} and @notation{doits} can be added to notes using
 
 @notation{Falls} and @notation{doits} can be added to notes using
-the @code{\bendAfter} command:
+the @code{\bendAfter} command.  The direction of the fall or doit
+is indicated with a plus or minus (up or down).  The number
+indicates the pitch interval that the fall or doit will extend
+@emph{beyond} the main note.
 
 @lilypond[verbatim,quote,relative=2]
 c2-\bendAfter #+4
 
 @lilypond[verbatim,quote,relative=2]
 c2-\bendAfter #+4
-c-\bendAfter #-4
-c-\bendAfter #+8
-c-\bendAfter #-8
+c2-\bendAfter #-4
+c2-\bendAfter #+8
+c2-\bendAfter #-8
 @end lilypond
 
 @end lilypond
 
-The dash (@tie{-}) following the note name is @emph{required} when
-writing @notation{falls} and @notation{doits}.
+The dash @code{-} immediately preceding the @code{\bendAfter}
+command is @emph{required} when writing falls and doits.
 
 
 @snippets
 
 
 @snippets
@@ -620,6 +760,9 @@ Snippets:
 @node Lines
 @subsection Lines
 
 @node Lines
 @subsection Lines
 
+This section explains how to create various expressive marks that
+follow a linear path: glissandos, arpeggios, and trills.
+
 @menu
 * Glissando::                   
 * Arpeggio::                    
 @menu
 * Glissando::                   
 * Arpeggio::                    
@@ -627,37 +770,27 @@ Snippets:
 @end menu
 
 @node Glissando
 @end menu
 
 @node Glissando
-@subsubsection Glissando
+@unnumberedsubsubsec Glissando
 
 @cindex glissando
 @funindex \glissando
 
 @cindex glissando
 @funindex \glissando
+@funindex glissando
 
 
-A @notation{glissando} is a smooth change in pitch.  It is denoted
-by a line or a wavy line between two notes.  A
-@notation{glissando} is created by attaching @code{\glissando} to
-a note:
+A @notation{glissando} is created by attaching @code{\glissando}
+to a note:
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
-c2\glissando c'
-\override Glissando #'style = #'zigzag
+g2\glissando g'
 c2\glissando c,
 @end lilypond
 
 c2\glissando c,
 @end lilypond
 
+Different styles of glissandi can be created.  For details, see
+@ref{Line styles}.
 
 @snippets
 
 
 @snippets
 
-@c Modify, add description, and put in input/new/
-@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-@c {suppressing-warnings-for-clashing-note-columns.ly}
-
-@lilypond[verbatim,quote]
-I = \once \override NoteColumn #'ignore-collision = ##t
-
-\relative c' <<
-  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
-  { \oneVoice \I c2 \glissando \I d, }
->>
-@end lilypond
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{contemporary-glissando.ly}
 
 
 @seealso
 
 
 @seealso
@@ -665,6 +798,9 @@ I = \once \override NoteColumn #'ignore-collision = ##t
 Music Glossary:
 @rglos{glissando}.
 
 Music Glossary:
 @rglos{glissando}.
 
+Notation Reference:
+@ref{Line styles}.
+
 Snippets:
 @rlsr{Expressive marks}.
 
 Snippets:
 @rlsr{Expressive marks}.
 
@@ -683,63 +819,70 @@ supported.
 
 
 @node Arpeggio
 
 
 @node Arpeggio
-@subsubsection Arpeggio
+@unnumberedsubsubsec Arpeggio
 
 @cindex arpeggio
 @cindex broken chord
 @cindex chord, broken
 
 @cindex arpeggio
 @cindex broken chord
 @cindex chord, broken
+@funindex \arpeggio
+@funindex arpeggio
+@funindex \arpeggioArrowUp
+@funindex arpeggioArrowUp
+@funindex \arpeggioArrowDown
+@funindex arpeggioArrowDown
+@funindex \arpeggioNormal
+@funindex arpeggioNormal
 
 
-@c Add documentation for new 'parenthesis' style arpeggio.  Maybe
-@c create a new \arpeggioParen command, or something similar. -pm
-
-You can specify an @notation{arpeggio} (also known as a
-@notation{broken chord}) on a chord by attaching an
-@code{\arpeggio} to the chord:
+An @notation{arpeggio} on a chord (also known as a broken chord)
+is denoted by appending @code{\arpeggio} to the chord construct:
 
 @lilypond[verbatim,quote,relative=1]
 
 @lilypond[verbatim,quote,relative=1]
-<c e g c>\arpeggio
+<c e g c>1\arpeggio
 @end lilypond
 
 @end lilypond
 
-A square bracket on the left, denoted by @code{\arpeggioBracket},
-is used to indicate that the chord should @emph{not} be
-arpeggiated:
+Different types of arpeggios may be written.
+@code{\arpeggioNormal} reverts to a normal arpeggio:
 
 @lilypond[verbatim,quote,relative=1]
 
 @lilypond[verbatim,quote,relative=1]
-\arpeggioBracket
-<c e g c>\arpeggio
+<c e g c>2\arpeggio
+\arpeggioArrowUp
+<c e g c>2\arpeggio
+\arpeggioArrowDown
+<c e g c>2\arpeggio
+\arpeggioNormal
+<c e g c>2\arpeggio
 @end lilypond
 
 @end lilypond
 
-The direction of the arpeggio can be denoted by adding an
-arrowhead to the wiggly line.  This is done with the commands
-@code{arpeggioUp} and @code{arpeggioDown}.  @code{arpeggioNeutral}
-reverts to the arrow-less version:
+@cindex arpeggio symbols, special
+@cindex special arpeggio symbols
+@funindex \arpeggioBracket
+@funindex arpeggioBracket
+@funindex \arpeggioParenthesis
+@funindex arpeggioParenthesis
+
+Special @emph{bracketed} arpeggio symbols can be created:
 
 @lilypond[verbatim,quote,relative=1]
 
 @lilypond[verbatim,quote,relative=1]
-\new Voice {
-  \arpeggioUp
-  <c e g c>\arpeggio
-  \arpeggioDown
-  <c e g c>\arpeggio
-  \arpeggioNeutral
-  <c e g c>\arpeggio
-}
+<c e g c>2
+\arpeggioBracket
+<c e g c>2\arpeggio
+\arpeggioParenthesis
+<c e g c>2\arpeggio
+\arpeggioNormal
+<c e g c>2\arpeggio
 @end lilypond
 
 @end lilypond
 
-@notation{Arpeggios} can be explicitly written out using
-@notation{ties}.  For more information, see @ref{Ties}.
+Arpeggios can be explicitly written out with ties.  For more
+information, see @ref{Ties}.
 
 @predefined
 
 
 @predefined
 
-@funindex \arpeggio
 @code{\arpeggio},
 @code{\arpeggio},
-@funindex \arpeggioUp
-@code{\arpeggioUp},
-@funindex \arpeggioDown
-@code{\arpeggioDown},
-@funindex \arpeggioNeutral
-@code{\arpeggioNeutral},
-@funindex \arpeggioBracket
-@code{\arpeggioBracket}.
+@code{\arpeggioArrowUp},
+@code{\arpeggioArrowDown},
+@code{\arpeggioNormal},
+@code{\arpeggioBracket},
+@code{\arpeggioParenthesis}.
 
 
 @snippets
 
 
 @snippets
@@ -756,8 +899,6 @@ reverts to the arrow-less version:
 
 @seealso
 
 
 @seealso
 
-@c TODO: Add 'broken chord' to glossary.
-
 Music Glossary:
 @rglos{arpeggio}.
 
 Music Glossary:
 @rglos{arpeggio}.
 
@@ -774,60 +915,91 @@ Internals Reference:
 
 @knownissues
 
 
 @knownissues
 
+@cindex cross-staff parenthesis-style arpeggio
+@cindex arpeggio, parenthesis-style, cross-staff
+@cindex arpeggio, cross-staff parenthesis-style
+
 It is not possible to mix connected arpeggios and unconnected
 arpeggios in one @code{PianoStaff} at the same point in
 time.
 
 It is not possible to mix connected arpeggios and unconnected
 arpeggios in one @code{PianoStaff} at the same point in
 time.
 
+The parenthesis-style arpeggio brackets do not work for
+cross-staff arpeggios.
+
 
 @node Trills
 
 @node Trills
-@subsubsection Trills
+@unnumberedsubsubsec Trills
 
 @cindex trills
 @funindex \trill
 
 @cindex trills
 @funindex \trill
+@funindex trill
+@funindex \startTrillSpan
+@funindex startTrillSpan
+@funindex \stopTrillSpan
+@funindex stopTrillSpan
 
 
-Short @notation{trills} are printed with @code{\trill} like normal
-articulation; see @ref{Articulations and ornamentations}.
+Short @notation{trills} without an extender line are printed with
+@code{\trill}; see @ref{Articulations and ornamentations}.
 
 
-Long running @notation{trills} are made with
-@code{\startTrillSpan} and @code{\stopTrillSpan}.  In the
-following example, a long running @notation{trill} is shown
-combined with grace notes.  To achieve precise control of the
-placement of the grace notes, see @ref{Grace notes}.
+Longer trills with an extender line are made with
+@code{\startTrillSpan} and @code{\stopTrillSpan}:
+
+@lilypond[verbatim,quote,relative=2]
+d1~\startTrillSpan
+d1
+c2\stopTrillSpan r2
+@end lilypond
+
+In the following example, a trill is combined with grace notes.
+The syntax of this construct and the method to precisely position
+the grace notes are described in @ref{Grace notes}.
 
 @lilypond[verbatim,quote,relative=2]
 c1 \afterGrace
 
 @lilypond[verbatim,quote,relative=2]
 c1 \afterGrace
-d1\startTrillSpan { c16[\stopTrillSpan d] }
-c4
+d1\startTrillSpan { c32[ d]\stopTrillSpan }
+e2 r2
 @end lilypond
 
 @cindex pitched trills
 @cindex trills, pitched
 @end lilypond
 
 @cindex pitched trills
 @cindex trills, pitched
+@funindex \pitchedTrill
+@funindex pitchedTrill
 
 
-@notation{Trills} that should be executed on an explicitly
-specified pitch can be typeset with the command
-@code{\pitchedTrill} using the following syntax:
-
-@example
-@code{\pitchedTrill} @var{mainnote} @code{\startTrillSpan}
-@var{trillnote} @var{endnote} @code{\stopTrillSpan}
-@end example
+Trills that require an auxiliary note with an explicit pitch can
+be typeset with the @code{\pitchedTrill} command.  The first
+argument is the main note, and the second is the @emph{trilled}
+note, printed as a stemless note head in parentheses.
 
 @lilypond[verbatim,quote,relative=1]
 
 @lilypond[verbatim,quote,relative=1]
-\pitchedTrill e2 \startTrillSpan fis
+\pitchedTrill e2\startTrillSpan fis
 d\stopTrillSpan
 @end lilypond
 
 d\stopTrillSpan
 @end lilypond
 
-@noindent
-The first argument is the main note.  The pitch of the second is
-printed as a stemless note head in parentheses.
+@cindex pitched trill with forced accidental
+@cindex trill, pitched with forced accidental
+@cindex accidental, forced for pitched trill
+
+In the following example, the second pitched trill is ambiguous;
+the accidental of the trilled note is not printed.  As a
+workaround, the accidentals of the trilled notes can be forced.
+The second measure illustrates this method:
+
+@lilypond[verbatim,quote,relative=2]
+\pitchedTrill eis4\startTrillSpan fis
+g\stopTrillSpan
+\pitchedTrill eis4\startTrillSpan fis
+g\stopTrillSpan
+\pitchedTrill eis4\startTrillSpan fis
+g\stopTrillSpan
+\pitchedTrill eis4\startTrillSpan fis!
+g\stopTrillSpan
+@end lilypond
 
 
 @predefined
 
 @code{\startTrillSpan},
 
 
 @predefined
 
 @code{\startTrillSpan},
-@funindex \startTrillSpan
 @code{\stopTrillSpan}.
 @code{\stopTrillSpan}.
-@funindex \stopTrillSpan
 
 
 @seealso
 
 
 @seealso
@@ -835,8 +1007,13 @@ printed as a stemless note head in parentheses.
 Music Glossary:
 @rglos{trill}.
 
 Music Glossary:
 @rglos{trill}.
 
+Notation Reference:
+@ref{Articulations and ornamentations},
+@ref{Grace notes}.
+
 Snippets:
 @rlsr{Expressive marks}.
 
 Internals Reference:
 @rinternals{TrillSpanner}.
 Snippets:
 @rlsr{Expressive marks}.
 
 Internals Reference:
 @rinternals{TrillSpanner}.
+
Debian packaging of lilypond