From ba9a8dc730bb3a681455150bc0a3eef0976523af Mon Sep 17 00:00:00 2001 From: Trevor Daniels Date: Fri, 1 May 2015 22:56:47 +0100 Subject: [PATCH] Issue 3687 (part 2): Amend docs to use \compressMMRests Amend the examples in the LM and NR to use the \compressMMRests music function rather than the predefs \compressFullBarRests and \expandFullBarRests to avoid advocating the use of techniques which may have undesirable side effects. --- Documentation/learning/fundamental.itely | 24 +++--- .../notation/changing-defaults.itely | 15 ++-- Documentation/notation/rhythms.itely | 84 +++++++++---------- 3 files changed, 63 insertions(+), 60 deletions(-) diff --git a/Documentation/learning/fundamental.itely b/Documentation/learning/fundamental.itely index d36d3bc068..d86134e9ea 100644 --- a/Documentation/learning/fundamental.itely +++ b/Documentation/learning/fundamental.itely @@ -8,7 +8,7 @@ Guide, node Updating translation committishes.. @end ignore -@c \version "2.19.16" +@c \version "2.19.20" @node Fundamental concepts @chapter Fundamental concepts @@ -3164,22 +3164,18 @@ takes 3@tie{}measures in 2/4 time R2*3 @end example -When printing the part, multi-rests -must be condensed. This is done by setting a run-time variable +When printing the part, multi-measure rests must be compressed. There +is a music function available to do this: @example -\set Score.skipBars = ##t +\compressMMRests @{ ... @} @end example -@noindent -This command sets the property @code{skipBars} in the -@code{Score} context to true (@code{##t}). Prepending the rest and -this option to the music above, leads to the following result +Applying this to @code{hornNotes} gives: @lilypond[quote,ragged-right] -\transpose f c' \relative c { +\compressMMRests \transpose f c' \relative c { \time 2/4 - \set Score.skipBars = ##t R2*3 | r4 f8 a | cis4 f | e4 d | } @@ -3220,5 +3216,13 @@ leading to >> @end lilypond +@seealso +Learning Manual: +@ref{Organizing pieces with variables}. +Notation Reference: +@ruser{Transpose}, +@ruser{Writing parts}, +@ruser{Full measure rests}, +@ruser{Including LilyPond files}. diff --git a/Documentation/notation/changing-defaults.itely b/Documentation/notation/changing-defaults.itely index fe989da217..a1134477e6 100644 --- a/Documentation/notation/changing-defaults.itely +++ b/Documentation/notation/changing-defaults.itely @@ -8,7 +8,7 @@ Guide, node Updating translation committishes.. @end ignore -@c \version "2.19.16" +@c \version "2.19.20" @node Changing defaults @chapter Changing defaults @@ -2972,12 +2972,13 @@ a @lilypond[verbatim,quote,relative=2] a1 -\compressFullBarRests -R1*23 -% increase the length of the rest bar -\once \override MultiMeasureRest.minimum-length = #20 -R1*23 -a1 +\compressMMRests { + R1*23 + % increase the length of the rest bar + \once \override MultiMeasureRest.minimum-length = #20 + R1*23 + a1 +} @end lilypond @lilypond[verbatim,quote,relative=2] diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely index 73f875f0e5..54ce04cb8f 100644 --- a/Documentation/notation/rhythms.itely +++ b/Documentation/notation/rhythms.itely @@ -7,7 +7,7 @@ Guide, node Updating translation committishes.. @end ignore -@c \version "2.19.16" +@c \version "2.19.20" @node Rhythms @section Rhythms @@ -810,6 +810,8 @@ Internals Reference: @cindex whole rest for a full measure @cindex rest, whole for a full measure +@funindex compressMMRests +@funindex \compressMMRests @funindex R Rests for one or more full measures are entered like notes with @@ -817,11 +819,12 @@ the note name uppercase @code{R}: @lilypond[quote,verbatim,relative=2] % Rest measures contracted to single measure -\compressFullBarRests -R1*4 -R1*24 -R1*4 -b2^"Tutti" b4 a4 +\compressMMRests { + R1*4 + R1*24 + R1*4 + b2^"Tutti" b4 a4 +} @end lilypond The duration of full-measure rests is identical to the duration @@ -830,15 +833,16 @@ always be an integral number of measure-lengths, so augmentation dots or fractions must often be used: @lilypond[quote,verbatim,relative=2] -\compressFullBarRests -\time 2/4 -R1 | R2 | -\time 3/4 -R2. | R2.*2 | -\time 13/8 -R1*13/8 | R1*13/8*12 | -\time 10/8 -R4*5*4 | +\compressMMRests { + \time 2/4 + R1 | R2 | + \time 3/4 + R2. | R2.*2 | + \time 13/8 + R1*13/8 | R1*13/8*12 | + \time 10/8 + R4*5*4 | +} @end lilypond A full-measure rest is printed as either a whole or breve rest, @@ -856,11 +860,6 @@ R1*2 | @cindex multi-measure rest, expanding @cindex multi-measure rest, contracting -@funindex \expandFullBarRests -@funindex expandFullBarRests -@funindex \compressFullBarRests -@funindex compressFullBarRests - By default a multi-measure rest is expanded in the printed score to show all the rest measures explicitly. Alternatively, a multi-measure rest can be shown as a single measure containing a multi-measure rest @@ -872,10 +871,10 @@ symbol, with the number of measures of rest printed above the measure: \time 2/4 R2 | \time 4/4 % Rest measures contracted to single measure -\compressFullBarRests -r1 | R1*17 | R1*4 | -% Rest measures expanded -\expandFullBarRests +\compressMMRests { + r1 | R1*17 | R1*4 | +} +% Rest measures expanded again \time 3/4 R2.*2 | @end lilypond @@ -899,10 +898,11 @@ The predefined command @code{\fermataMarkup} is provided for adding fermatas. @lilypond[quote,verbatim,relative=2] -\compressFullBarRests -\time 3/4 -R2.*10^\markup { \italic "ad lib." } -R2.^\fermataMarkup +\compressMMRests { + \time 3/4 + R2.*10^\markup { \italic "ad lib." } + R2.^\fermataMarkup +} @end lilypond @warning{Markups attached to a multi-measure rest are objects of type @@ -929,17 +929,14 @@ setting, resulting bar-check warnings may not be displayed. @funindex textLengthOff @funindex \fermataMarkup @funindex fermataMarkup -@funindex \compressFullBarRests -@funindex compressFullBarRests -@funindex \expandFullBarRests -@funindex expandFullBarRests +@funindex \compressMMRests +@funindex compressMMRests @predefined @code{\textLengthOn}, @code{\textLengthOff}, @code{\fermataMarkup}, -@code{\compressFullBarRests}, -@code{\expandFullBarRests}. +@code{\compressMMRests}. @endpredefined @@ -1323,15 +1320,16 @@ restores the default behavior of ignoring tempo marks for horizontal spacing. @lilypond[verbatim,quote,relative=0] -\compressFullBarRests -\markLengthOn -\tempo "Molto vivace" -R1*12 -\tempo "Meno mosso" -R1*16 -\markLengthOff -\tempo "Tranquillo" -R1*20 +\compressMMRests { + \markLengthOn + \tempo "Molto vivace" + R1*12 + \tempo "Meno mosso" + R1*16 + \markLengthOff + \tempo "Tranquillo" + R1*20 +} @end lilypond @snippets -- 2.39.2