Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.13.36"
@node Expressive marks
@section Expressive marks
created in a score.
@menu
-* Attached to notes::
-* Curves::
-* Lines::
+* Expressive marks attached to notes::
+* Expressive marks as curves::
+* Expressive marks as lines::
@end menu
-@node Attached to notes
-@subsection Attached to notes
+@node Expressive marks attached to notes
+@subsection Expressive marks attached to notes
This section explains how to create expressive marks that are
attached to notes: articulations, ornamentations, and dynamics.
@funindex \fermata
@funindex \longfermata
@funindex \verylongfermata
+@funindex \fermataMarkup
@funindex \segno
@funindex \coda
@funindex \varcoda
@var{note}\@var{name}
@end example
-The possible values for @var{name} are listed in @ref{List of
-articulations}. For example:
+The possible values for @code{@var{name}} are listed in
+@ref{List of articulations}. For example:
@lilypond[verbatim,quote,relative=2]
c4\staccato c\mordent b2\turn
@end lilypond
The rules for the default placement of articulations are defined
-in @file{scm/@/script@/.scm}. Articulations and ornamentations
+in @file{scm/script.scm}. Articulations and ornamentations
may be manually placed above or below the staff; see
@ref{Direction and placement}.
Articulations are @code{Script} objects. Their properties are
described more fully in @rinternals{Script}.
+Articulations can be attached to rests as well as notes but they
+cannot be attached to multi-measure rests. A special predefined
+command, @code{\fermataMarkup}, is available for attaching a fermata
+to a multi-measure rest (and only a multi-measure rest). This
+creates a @code{MultiMeasureRestText} object.
+
+@lilypond[verbatim,quote,relative=2]
+\override Script #'color = #red
+\override MultiMeasureRestText #'color = #blue
+a2\fermata r\fermata
+R1\fermataMarkup
+@end lilypond
+
In addition to articulations, text and markups can be attached to
notes. See @ref{Text scripts}.
Learning Manual:
@rlearning{Placement of objects}.
-
Notation Reference:
@ref{Text scripts},
@ref{Direction and placement},
@ref{Trills}.
Installed Files:
-@file{scm/@/script@/.scm}.
+@file{scm/script.scm}.
Snippets:
@rlsr{Expressive marks}.
c1\!
@end lilypond
-Spacer rests are needed to engrave multiple marks on one note.
+A hairpin that is terminated with @code{\!} will end at the
+right edge of the note that has the @code{\!} assigned to it. In the
+case where it is terminated with the start of another @notation{crescendo}
+or @notation{decrescendo} mark, it will end at the centre of the note
+that has the next @code{\<} or @code{\>} assigned to it. The next
+hairpin will then start at the right edge of the same note
+instead of the usual left edge had it been terminated with @code{\!}
+before.
+
+@lilypond[verbatim,quote,relative=2]
+c1\< | c4 a c\< a | c4 a c\! a\< | c4 a c a\!
+@end lilypond
+
+Hairpins that are terminated with absolute dynamic marks instead of
+@code{\!} will also be engraved in a similar way. However, the length
+of the absolute dynamic itself can alter where the preceding hairpin
+ends.
+
+@lilypond[verbatim,quote,relative=2]
+c1\< | c4 a c\mf a | c1\< | c4 a c\ffff a
+@end lilypond
@cindex multiple dynamic marks on one note
@cindex dynamic marks, multiple on one note
+Spacer rests are needed to engrave multiple marks on one note.
+This is particularly useful when adding a @notation{crescendo} and
+@notation{decrescendo} to the same note:
@lilypond[verbatim,quote,relative=2]
c4\< c\! d\> e\!
@funindex \espressivo
@funindex espressivo
-In some situations the @code{\espressivo} articulation mark may be
-the appropriate choice to indicate a crescendo and decrescendo on
-one note:
+The @code{\espressivo} command can be used to indicate a crescendo
+and decrescendo on the same note. However, be warned that this is
+implemented as an articulation, not a dynamic.
@lilypond[verbatim,quote,relative=2]
c2 b4 a
-@node Curves
-@subsection Curves
+@node Expressive marks as curves
+@subsection Expressive marks as curves
This section explains how to create various expressive marks that
are curved: normal slurs, phrasing slurs, breath marks, falls, and
@funindex phrasingSlurDashPattern
@cindex phrasing slur, defining dash patterns
@cindex slur, phrasing, defining dash patterns
-@cindex slur, definind dash patterns for phrasing
+@cindex slur, defining dash patterns for phrasing
Custom dash patterns for phrasing slurs can be defined:
@rlsr{Expressive marks}.
-@node Lines
-@subsection Lines
+@node Expressive marks as lines
+@subsection Expressive marks as lines
This section explains how to create various expressive marks that
follow a linear path: glissandos, arpeggios, and trills.