From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Sat, 17 Jul 2010 07:32:05 +0000 (+0100)
Subject: Docs: NR expressive: clarify \fermata and \fermataMarkup
X-Git-Tag: release/2.13.29-1~57
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a02ca233bc1a2af11980d8eab1e874c559cdff09;p=lilypond.git

Docs: NR expressive: clarify \fermata and \fermataMarkup
---

diff --git a/Documentation/notation/expressive.itely b/Documentation/notation/expressive.itely
index d31e59d94f..9ba59343ff 100644
--- a/Documentation/notation/expressive.itely
+++ b/Documentation/notation/expressive.itely
@@ -108,6 +108,7 @@ Methods to create new dynamic markings are also discussed.
 @funindex \fermata
 @funindex \longfermata
 @funindex \verylongfermata
+@funindex \fermataMarkup
 @funindex \segno
 @funindex \coda
 @funindex \varcoda
@@ -159,6 +160,19 @@ may be manually placed above or below the staff; see
 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}.