Issue 4418/4 run scripts/auxiliar/update-with-convert-ly.sh

[lilypond.git] / Documentation / notation / rhythms.itely

diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely
index 73f875f0e5c385fac014aa63ccee621d2f12c8a5..fbfca6e8f92e3623152238470914de805e8cf3e1 100644 (file)
--- 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.22"
 
 @node Rhythms
 @section Rhythms
@@ -435,8 +435,8 @@ dots cannot be used to denote the rhythm.  Ties should also be
 used when note values cross larger subdivisions of the measure:
 
 @lilypond[verbatim,quote]
-\relative c' {
-  r8 c~ 2 r4 |
+\relative {
+  r8 c'~ 2 r4 |
   r8^"not" c2~ 8 r4
 }
 @end lilypond
@@ -558,8 +558,8 @@ collide with other objects in a staff.
 \override Tie.layer = #-2
 \override Staff.TimeSignature.layer = #-1
 \override Staff.KeySignature.layer = #-1
-\override Staff.TimeSignature.whiteout = ##t
-\override Staff.KeySignature.whiteout = ##t
+\override Staff.TimeSignature.whiteout-box = ##t
+\override Staff.KeySignature.whiteout-box = ##t
 b2 b~
 \time 3/4
 \key a \major
@@ -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
 
 
@@ -1094,9 +1091,9 @@ argument:
 @lilypond[quote,verbatim]
 \score {
   \new Staff {
-    \relative c' {
+    \relative {
       \time #'(2 2 3) 7/8
-      \repeat unfold 7 { c8 } |
+      \repeat unfold 7 { c'8 } |
       \time #'(3 2 2) 7/8
       \repeat unfold 7 { c8 } |
     }
@@ -1159,8 +1156,8 @@ to the original values:
 
 @lilypond[quote,verbatim]
 \score{
-  \relative c' {
-    \repeat unfold 8 { c8 } |
+  \relative {
+    \repeat unfold 8 { c'8 } |
     \overrideTimeSignatureSettings
       4/4        % timeSignatureFraction
       1/4        % baseMomentFraction
@@ -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
@@ -1358,7 +1356,7 @@ Music Glossary:
 
 Notation Reference:
 @ref{Formatting text},
-@ref{MIDI output}.
+@ref{Creating MIDI output}.
 
 Snippets:
 @rlsr{Staff notation}.
@@ -1619,10 +1617,10 @@ may be necessary to insert beams manually, as the duration scaling will
 affect the autobeaming rules.
 
 @lilypond[quote,verbatim]
-\relative c' <<
+\relative <<
   \new Staff {
     \time 3/4
-    c4 c c |
+    c'4 c c |
     c4 c c |
   }
   \new Staff {
@@ -1665,10 +1663,10 @@ moving the @code{Timing_translator} and the
 
 % Now each staff has its own time signature.
 
-\relative c' <<
+\relative <<
   \new Staff {
     \time 3/4
-    c4 c c |
+    c'4 c c |
     c4 c c |
   }
   \new Staff {
@@ -1705,9 +1703,9 @@ indicates the bottom number of the time signature and those that come
 before it, the top numbers.
 
 @lilypond[quote,verbatim]
-\relative c' {
+\relative {
   \compoundMeter #'((2 2 2 8))
-  \repeat unfold 6 c8 \repeat unfold 12 c16
+  \repeat unfold 6 c'8 \repeat unfold 12 c16
 }
 @end lilypond
 
@@ -1715,14 +1713,14 @@ More complex meters can be constructed using additional lists.  Also,
 automatic beaming settings will be adjusted depending on the values.
 
 @lilypond[quote,verbatim]
-\relative c' {
+\relative {
   \compoundMeter #'((1 4) (3 8))
-  \repeat unfold 5 c8 \repeat unfold 10 c16
+  \repeat unfold 5 c'8 \repeat unfold 10 c16
 }
 
-\relative c' {
+\relative {
   \compoundMeter #'((1 2 3 8) (3 4))
-  \repeat unfold 12 c8
+  \repeat unfold 12 c'8
 }
 @end lilypond
 
@@ -2138,15 +2136,15 @@ enclosing context will apply.
   \set Staff.beatStructure = #'(2 3 2)
   <<
     \new Voice = one {
-      \relative c'' {
-        a8 a a a a a a
+      \relative {
+        a'8 a a a a a a
       }
     }
     \new Voice = two {
-      \relative c' {
+      \relative {
         \voiceTwo
         \set Voice.beatStructure = #'(1 3 3)
-        f8 f f f f f f
+        f'8 f f f f f f
       }
     }
   >>
@@ -3562,8 +3560,8 @@ functions take a defined piece of music as an argument and generate a
 multi-measure rest or @code{\skip} exactly as long as the piece.
 
 @lilypond[verbatim,quote]
-MyCadenza = \relative c' {
-  c4 d8 e f g g4
+MyCadenza = \relative {
+  c'4 d8 e f g g4
   f2 g4 g
 }
 
@@ -3647,9 +3645,9 @@ advanced by 1/8 to 5/8, shortening that bar by 1/8.
 The next bar line then falls at 9/8 rather than 5/4.
 
 @lilypond[quote,verbatim]
-\new Voice \relative c' {
+\new Voice \relative {
   \set Timing.measureLength = #(ly:make-moment 5/4)
-  c1 c4 |
+  c'1 c4 |
   c1 c4 |
   c4 c
   \set Timing.measurePosition = #(ly:make-moment 5/8)