Documentation/notation/repeats.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  For details, see the Contributors'
   7     Guide, node Updating translation committishes..
   8 @end ignore
   9
  10 @c \version "2.19.21"
  11
  12 @node Repeats
  13 @section Repeats
  14
  15 @lilypondfile[quote]{repeats-headword.ly}
  16
  17 Repetition is a central concept in music, and multiple notations
  18 exist for repetitions.  LilyPond supports the following kinds of
  19 repeats:
  20
  21
  22 @table @code
  23 @item volta
  24 The repeated music is not written out but enclosed between repeat bar
  25 lines.  If the repeat is at the beginning of a piece, a repeat bar
  26 line is only printed at the end of the repeat.  Alternative endings
  27 (volte) are printed left to right with brackets.  This is the standard
  28 notation for repeats with alternatives.
  29
  30 @item unfold
  31 The repeated music is fully written out, as many times as
  32 specified by @code{@var{repeatcount}}.  This is useful when
  33 entering repetitious music.
  34
  35 @item percent
  36 These are beat or measure repeats.  They look like single slashes or
  37 percent signs.
  38
  39 @item tremolo
  40 This is used to write tremolo beams.
  41
  42 @end table
  43
  44
  45 @menu
  46 * Long repeats::
  47 * Short repeats::
  48 @end menu
  49
  50 @node Long repeats
  51 @subsection Long repeats
  52
  53 This section discusses how to input long (usually multi-measure)
  54 repeats.  The repeats can take two forms: repeats enclosed between
  55 repeat signs; or written-out repeats, used to input repetitious music.
  56 Repeat signs can also be controlled manually.
  57
  58 @menu
  59 * Normal repeats::
  60 * Manual repeat marks::
  61 * Written-out repeats::
  62 @end menu
  63
  64 @cindex volta
  65 @cindex prima volta
  66 @cindex seconda volta
  67 @cindex volta, prima
  68 @cindex volta, seconda
  69 @cindex repeat, normal
  70 @cindex normal repeat
  71 @cindex repeat with alternate endings
  72 @cindex alternate endings
  73 @funindex \repeat
  74 @funindex \alternative
  75 @funindex \partial
  76
  77 @node Normal repeats
  78 @unnumberedsubsubsec Normal repeats
  79
  80 The syntax for a normal repeat is
  81
  82 @example
  83 \repeat volta @var{repeatcount} @var{musicexpr}
  84 @end example
  85
  86 @noindent
  87 where @code{@var{musicexpr}} is a music expression.
  88
  89 A single repeat without an alternate ending:
  90
  91 @lilypond[verbatim,quote,relative=2]
  92 \repeat volta 2 { c4 d e f }
  93 c2 d
  94 \repeat volta 2 { d4 e f g }
  95 @end lilypond
  96
  97 An @q{opening} repeat mark is not, by default, printed in the first full
  98 measure.  However it is possible to add one by using @code{\bar ".|:"}
  99 before the first note.
 100
 101 @lilypond[verbatim,fragment,quote,relative=2]
 102 \repeat volta 2 { \bar ".|:" c4 d e f }
 103 c2 d
 104 \repeat volta 2 { d4 e f g }
 105 @end lilypond
 106
 107 Alternative endings can be produced using @code{\alternative}.  Each
 108 group of alternatives must be themselves, enclosed in a set of braces.
 109
 110 @example
 111 \repeat volta @var{repeatcount} @var{musicexpr}
 112 \alternative @{
 113   @{ @var{musicexpr} @}
 114 @}
 115 @end example
 116
 117 @noindent
 118 where @code{@var{musicexpr}} is a music expression.
 119
 120 If there are more repeats than there are alternate endings, the earliest
 121 repeats are given the first alternative.
 122
 123 A single repeat with one alternate ending:
 124
 125 @lilypond[verbatim,quote,relative=2]
 126 \repeat volta 2 { c4 d e f | }
 127 \alternative {
 128   { c2 e | }
 129   { f2 g | }
 130 }
 131 c1
 132 @end lilypond
 133
 134 Multiple repeats with one alternate ending:
 135
 136 @lilypond[verbatim,quote,relative=2]
 137 \repeat volta 4 { c4 d e f | }
 138 \alternative {
 139   { c2 e | }
 140   { f2 g | }
 141 }
 142 c1
 143 @end lilypond
 144
 145 Multiple repeats with more than one alternate ending:
 146
 147 @lilypond[verbatim,quote,relative=2]
 148 \repeat volta 3 { c4 d e f | }
 149 \alternative {
 150   { c2 e | }
 151   { f2 g | }
 152   { a2 g | }
 153 }
 154 c1
 155 @end lilypond
 156
 157 @warning{If there are two or more alternatives, nothing should appear
 158 between the closing brace of one and the opening brace of the next
 159 in an @code{@bs{}alternative} block, otherwise you will not get the
 160 expected number of endings.}
 161
 162 @warning{If you include @code{@bs{}relative} inside a
 163 @code{@bs{}repeat} without explicitly instantiating the
 164 @code{Voice} context, extra (unwanted) staves will appear.  See
 165 @rprogram{An extra staff appears}.}
 166
 167 @cindex repeat with upbeat
 168 @cindex upbeat in a repeat
 169 @cindex anacrusis in a repeat
 170 @cindex repeat with anacrusis
 171 @cindex repeat with pickup
 172 @cindex pickup in a repeat
 173 @funindex \partial
 174
 175 If a repeat starts in the middle of a measure and has no alternate
 176 endings, normally the end of the repeat will also fall in the
 177 middle of a measure, so that the two ends add up to one complete
 178 measure.  In such cases, the repeat signs do not constitute true
 179 bar lines.  Do not use @code{\partial} commands or bar checks
 180 where these repeat signs are printed:
 181
 182 @lilypond[verbatim,quote,relative=1]
 183 % no \partial here
 184 c4 e g  % no bar check here
 185 % no \partial here
 186 \repeat volta 4 {
 187   e4 |
 188   c2 e |
 189   % no \partial here
 190   g4 g g  % no bar check here
 191 }
 192 % no \partial here
 193 g4 |
 194 a2 a |
 195 g1 |
 196 @end lilypond
 197
 198 Similarly, if a repeat begins with the initial partial measure of
 199 a score and has no alternate endings, the same conditions apply as
 200 in the above example, except that in this case the @code{\partial}
 201 command is required at the beginning of the score:
 202
 203 @lilypond[verbatim,quote,relative=1]
 204 \partial 4  % required
 205 \repeat volta 4 {
 206   e4 |
 207   c2 e |
 208   % no \partial here
 209   g4 g g  % no bar check here
 210 }
 211 % no \partial here
 212 g4 |
 213 a2 a |
 214 g1 |
 215 @end lilypond
 216
 217 @cindex repeats, with ties
 218 @cindex alternative endings, with ties
 219 @cindex ties, in repeats
 220 @cindex ties, alternative endings
 221 @funindex \repeatTie
 222
 223 Ties may be added to a second ending:
 224
 225 @lilypond[verbatim,quote,relative=2]
 226 c1
 227 \repeat volta 2 { c4 d e f~ }
 228 \alternative {
 229   { f2 d }
 230   { f2\repeatTie f, }
 231 }
 232 @end lilypond
 233
 234 @funindex \inStaffSegno
 235 @cindex repeats, with segno
 236 @cindex segno, with repeats
 237
 238 The @code{\inStaffSegno} command can be used to generate a composite
 239 bar line incorporating the segno symbol with the appropriate repeat
 240 bar line when used with the @code{\repeat volta} command.  The
 241 correct type of repeat bar line, viz. start repeat, end repeat or
 242 double repeat, is selected automatically.  Note that the
 243 corresponding @qq{D.S.} mark must be added manually.
 244
 245 Away from a repeat:
 246
 247 @lilypond[verbatim,quote,relative=1]
 248 e1
 249 \inStaffSegno
 250 f2 g a b
 251 c1_"D.S." \bar "|."
 252 @end lilypond
 253
 254 At the start of a repeat:
 255
 256 @lilypond[verbatim,quote,relative=1]
 257 e1
 258 \repeat volta 2 {
 259   \inStaffSegno  % start repeat
 260   f2 g a b
 261 }
 262 c1_"D.S." \bar "|."
 263 @end lilypond
 264
 265 At the end of a repeat:
 266
 267 @lilypond[verbatim,quote,relative=1]
 268 e1
 269 \repeat volta 2 {
 270   f2 g a b
 271   \inStaffSegno  % end repeat
 272 }
 273 f2 g a b
 274 c1_"D.S." \bar "|."
 275 @end lilypond
 276
 277 Between two repeats:
 278
 279 @lilypond[verbatim,quote,relative=1]
 280 e1
 281 \repeat volta 2 {
 282   f2 g a b
 283 }
 284 \inStaffSegno  % double repeat
 285 \repeat volta 2 {
 286   f2 g a b
 287 }
 288 c1_"D.S." \bar "|."
 289 @end lilypond
 290
 291 Alternative bar line symbols can be obtained by setting (in the Score
 292 context) the properties @code{segnoType}, @code{startRepeatSegnoType},
 293 @code{endRepeatSegnoType} or @code{doubleRepeatSegnoType} to the
 294 required bar line type.  The alternative bar line types must be
 295 selected from the pre-defined types or types previously defined
 296 with the @code{\defineBarLine} command (see @ref{Bar lines}).
 297
 298 @lilypond[verbatim,quote,relative=1]
 299 \defineBarLine ":|.S[" #'(":|." "S[" "")
 300 \defineBarLine "]" #'("]" "" "")
 301 e1
 302 \repeat volta 2 {
 303   f2 g a b
 304   \once \set Score.endRepeatSegnoType = ":|.S["
 305   \inStaffSegno
 306 }
 307 f2 g \bar "]" a b
 308 c1_"D.S." \bar "|."
 309 @end lilypond
 310
 311 @snippets
 312 @lilypondfile[verbatim,quote,texidoc,doctitle]
 313 {shortening-volta-brackets.ly}
 314
 315 @lilypondfile[verbatim,quote,texidoc,doctitle]
 316 {adding-volta-brackets-to-additional-staves.ly}
 317
 318 @lilypondfile[verbatim,quote,texidoc,doctitle]
 319 {setting-the-double-repeat-default-for-volte.ly}
 320
 321 @cindex repeats, bar numbers letters
 322 @cindex repeats, alternative bar numbers
 323
 324 @lilypondfile[verbatim,quote,texidoc,doctitle]
 325 {alternative-bar-numbering.ly}
 326
 327 @seealso
 328 Music Glossary:
 329 @rglos{repeat},
 330 @rglos{volta}.
 331
 332 Notation Reference:
 333 @ref{Bar lines},
 334 @ref{Modifying context plug-ins},
 335 @ref{Modifying ties and slurs},
 336 @ref{Time administration}.
 337
 338 Installed Files:
 339 @file{ly/engraver-init.ly}.
 340
 341 Snippets:
 342 @rlsr{Repeats}.
 343
 344 Internals Reference:
 345 @rinternals{VoltaBracket},
 346 @rinternals{RepeatedMusic},
 347 @rinternals{VoltaRepeatedMusic},
 348 @rinternals{UnfoldedRepeatedMusic}.
 349
 350 @knownissues
 351 @cindex repeat, ambiguous
 352 @cindex nested repeat
 353 @cindex repeat, nested
 354 @cindex repeat timing information
 355 @cindex repeat and measure number
 356 @cindex timing information and repeats
 357 @cindex measure number and repeats
 358 @cindex repeats and slur
 359 @cindex slur and repeats
 360 @cindex glissandi and repeats
 361 @cindex repeats and glissandi
 362
 363 Slurs that span from a @code{\repeat} block into an
 364 @code{\alternative} block will only work for the first alternative
 365 ending.  The visual appearance of a continuing slur in other
 366 alternative blocks may be simulated with @code{\repeatTie} if the
 367 slur extends into only one note in the alternative block, although
 368 this method does not work in @code{TabStaff}.  Other methods which
 369 may be tailored to indicate continuing slurs over several notes in
 370 alternative blocks, and which also work in @code{TabStaff} contexts,
 371 are shown in @ref{Modifying ties and slurs}.
 372
 373 Also, slurs cannot wrap around from the end of one
 374 alternative back to the beginning of the repeat.
 375
 376 Glissandi that span from a @code{\repeat} block into an
 377 @code{\alternative} block will only work for the first alternative
 378 ending.  The visual appearance of a continuing glissando in other
 379 alternative blocks may be indicated by coding a glissando starting
 380 on a hidden grace note.  For an example, see
 381 @qq{Extending glissandi across repeats} under Selected Snippets
 382 in @ref{Glissando}.
 383
 384 If a repeat that begins with an incomplete measure has an
 385 @code{\alternative} block that contains modifications to the
 386 @code{measureLength} property, using @code{\unfoldRepeats} will
 387 result in wrongly-placed bar lines and bar check warnings.
 388
 389 A nested repeat like
 390
 391 @example
 392 \repeat @dots{}
 393 \repeat @dots{}
 394 \alternative
 395 @end example
 396
 397 @noindent
 398 is ambiguous, since it is not clear to which @code{\repeat} the
 399 @code{\alternative} belongs.  This ambiguity is resolved by always
 400 having the @code{\alternative} belong to the inner @code{\repeat}.
 401 For clarity, it is advisable to use braces in such situations.
 402
 403
 404 @node Manual repeat marks
 405 @unnumberedsubsubsec Manual repeat marks
 406
 407 @cindex manual repeat mark
 408 @cindex repeat, manual
 409 @cindex start repeat
 410 @cindex repeat, start
 411 @cindex end repeat
 412 @cindex repeat, end
 413 @cindex repeat number, changing
 414 @cindex repeat volta, changing
 415 @cindex volta bracket
 416 @cindex bracket, volta
 417 @funindex repeatCommands
 418 @funindex start-repeat
 419
 420 @warning{These methods are only used for displaying unusual repeat
 421 constructs, and may produce unexpected behavior.  In most cases,
 422 repeats should be created using the standard @code{@bs{}repeat} command
 423 or by printing the relevant bar lines.  For more information, see
 424 @ref{Bar lines}.}
 425
 426 The property @code{repeatCommands} can be used to control the
 427 layout of repeats.  Its value is a Scheme list of repeat commands.
 428
 429 @table @code
 430 @item start-repeat
 431 Print a @code{.|:} bar line.
 432
 433 @lilypond[verbatim,quote,relative=2]
 434 c1
 435 \set Score.repeatCommands = #'(start-repeat)
 436 d4 e f g
 437 c1
 438 @end lilypond
 439
 440 As per standard engraving practice, repeat signs are not printed
 441 at the beginning of a piece.
 442
 443 @item end-repeat
 444 Print a @code{:|.} bar line:
 445
 446 @lilypond[verbatim,quote,relative=2]
 447 c1
 448 d4 e f g
 449 \set Score.repeatCommands = #'(end-repeat)
 450 c1
 451 @end lilypond
 452
 453 @item (volta @var{number}) @dots{} (volta #f)
 454 Create a new volta with the specified number.  The volta bracket must
 455 be explicitly terminated, or it will not be printed.
 456
 457 @lilypond[verbatim,quote,relative=2]
 458 f4 g a b
 459 \set Score.repeatCommands = #'((volta "2"))
 460 g4 a g a
 461 \set Score.repeatCommands = #'((volta #f))
 462 c1
 463 @end lilypond
 464
 465 @end table
 466
 467 Multiple repeat commands may occur at the same point:
 468
 469 @lilypond[verbatim,quote,relative=2]
 470 f4 g a b
 471 \set Score.repeatCommands = #'((volta "2, 5") end-repeat)
 472 g4 a g a
 473 c1
 474 \set Score.repeatCommands = #'((volta #f) (volta "95") end-repeat)
 475 b1
 476 \set Score.repeatCommands = #'((volta #f))
 477 @end lilypond
 478
 479 @cindex volta bracket with text
 480 @cindex text in volta bracket
 481
 482 Text can be included with the volta bracket.  The text can be a
 483 number or numbers or markup text, see @ref{Formatting text}.  The
 484 simplest way to use markup text is to define the markup first,
 485 then include the markup in a Scheme list.
 486
 487 @lilypond[verbatim,quote]
 488 voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
 489 \relative {
 490   c''1
 491   \set Score.repeatCommands =
 492     #(list(list 'volta voltaAdLib) 'start-repeat)
 493   c4 b d e
 494   \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
 495   f1
 496   \set Score.repeatCommands = #'((volta #f))
 497 }
 498 @end lilypond
 499
 500 @seealso
 501 Notation Reference:
 502 @ref{Bar lines},
 503 @ref{Formatting text}.
 504
 505 Snippets:
 506 @rlsr{Repeats}.
 507
 508 Internals Reference:
 509 @rinternals{VoltaBracket},
 510 @rinternals{RepeatedMusic},
 511 @rinternals{VoltaRepeatedMusic}.
 512
 513
 514 @node Written-out repeats
 515 @unnumberedsubsubsec Written-out repeats
 516
 517 @cindex written-out repeats
 518 @cindex repeats, written-out
 519 @cindex repeats, unfold
 520 @cindex repeats, alternative
 521 @cindex unfold repeat
 522 @cindex unfold repeat, alternate endings
 523 @cindex alternate repeats
 524 @cindex alternate endings, repeats
 525 @funindex unfold
 526
 527 By using the @code{unfold} command, repeats can be used to simplify the
 528 writing out of repetitious music.  The syntax is
 529
 530 @example
 531 \repeat unfold @var{repeatcount} @var{musicexpr}
 532 @end example
 533
 534 @noindent
 535 where @code{@var{musicexpr}} is a music expression and
 536 @code{@var{repeatcount}} is the number of times
 537 @code{@var{musicexpr}} is repeated.
 538
 539 @lilypond[verbatim,quote,relative=2]
 540 \repeat unfold 2 { c4 d e f }
 541 c1
 542 @end lilypond
 543
 544 In some cases, especially in a @code{\relative} context, the
 545 @code{\repeat unfold} function is not the same as writing out the
 546 music expression multiple times. E.g,
 547
 548 @example
 549 \repeat unfold 2 @{ a'4 b c @}
 550 @end example
 551
 552 is not equivalent to
 553
 554 @example
 555 a'4 b c | a'4 b c
 556 @end example
 557
 558 Unfold repeats can be made with alternate endings.
 559
 560 @lilypond[verbatim,quote,relative=2]
 561 \repeat unfold 2 { c4 d e f }
 562 \alternative {
 563   { c2 g' }
 564   { c,2 b }
 565 }
 566 c1
 567 @end lilypond
 568
 569 If there are more repeats than there are alternate endings, the first
 570 alternative is applied multiple times until the remaining alternatives
 571 make up the total number of repeats.
 572
 573 @lilypond[verbatim,quote,relative=2]
 574 \repeat unfold 4 { c4 d e f }
 575 \alternative {
 576   { c2 g' }
 577   { c,2 b }
 578   { e2 d }
 579  }
 580 c1
 581 @end lilypond
 582
 583 If there are more alternate endings than repeats then only the first
 584 alternatives are applied.  The remaining alternatives will be ignored
 585 and not printed.
 586
 587 @lilypond[verbatim,quote,relative=2]
 588 \repeat unfold 2 { c4 d e f }
 589 \alternative {
 590   { c2 g' }
 591   { c,2 b }
 592   { e2 d }
 593 }
 594 c1
 595 @end lilypond
 596
 597 It is also possible to nest multiple @code{unfold} functions (with or
 598 without alternate endings).
 599
 600 @lilypond[verbatim,quote,relative=2]
 601 \repeat unfold 2 {
 602   \repeat unfold 2 { c4 d e f }
 603   \alternative {
 604     { c2 g' }
 605     { c,2 b }
 606   }
 607 }
 608 c1
 609 @end lilypond
 610
 611 Chord constructs can be repeated by the chord repetition symbol
 612 @code{q}.  See @ref{Chord repetition}.
 613
 614 @warning{If you include @code{@bs{}relative} inside a @code{@bs{}repeat}
 615 without explicitly instantiating the @code{Voice} context, extra
 616 (unwanted) staves will appear.  See @rprogram{An extra staff appears}.}
 617
 618 @seealso
 619 Notation Reference:
 620 @ref{Chord repetition}.
 621
 622 Snippets:
 623 @rlsr{Repeats}.
 624
 625 Internals Reference:
 626 @rinternals{RepeatedMusic},
 627 @rinternals{UnfoldedRepeatedMusic}.
 628
 629
 630 @node Short repeats
 631 @subsection Short repeats
 632
 633 This section discusses how to input short repeats.  Short repeats can
 634 take two forms: slashes or percent signs to represent repeats of a
 635 single note, a single measure or two measures, and tremolos otherwise.
 636
 637 @menu
 638 * Percent repeats::
 639 * Tremolo repeats::
 640 @end menu
 641
 642 @node Percent repeats
 643 @unnumberedsubsubsec Percent repeats
 644
 645 @cindex percent repeats
 646 @cindex measure repeats
 647 @cindex repeat, percent
 648 @cindex repeat, measure
 649 @cindex repeat, short
 650 @funindex \repeat percent
 651 @funindex percent
 652
 653 Repeated short patterns are printed once, and the repeated pattern
 654 is replaced with a special sign.
 655
 656 The syntax is
 657
 658 @example
 659 \repeat percent @var{number} @var{musicexpr}
 660 @end example
 661
 662 @noindent
 663 where @code{@var{musicexpr}} is a music expression.
 664
 665 Patterns that are shorter than one measure are replaced by slashes.
 666
 667 @lilypond[verbatim,quote,relative=2]
 668 \repeat percent 4 { c128 d e f }
 669 \repeat percent 4 { c64 d e f }
 670 \repeat percent 5 { c32 d e f }
 671 \repeat percent 4 { c16 d e f }
 672 \repeat percent 4 { c8 d }
 673 \repeat percent 4 { c4 }
 674 \repeat percent 2 { c2 }
 675 @end lilypond
 676
 677 Patterns of one or two measures are replaced by percent-like symbols.
 678
 679 @lilypond[verbatim,quote,relative=2]
 680 \repeat percent 2 { c4 d e f }
 681 \repeat percent 2 { c2 d }
 682 \repeat percent 2 { c1 }
 683 @end lilypond
 684
 685 @lilypond[verbatim,quote,relative=2]
 686 \repeat percent 3 { c4 d e f | c2 g' }
 687 @end lilypond
 688
 689 Patterns that are shorter than one measure but contain mixed durations
 690 use a double-percent symbol.
 691
 692 @lilypond[verbatim,quote,relative=2]
 693 \repeat percent 4 { c8. <d f>16 }
 694 \repeat percent 2 { \tuplet 3/2 { r8 c d } e4 }
 695 @end lilypond
 696
 697 @snippets
 698
 699 @lilypondfile[verbatim,quote,texidoc,doctitle]
 700 {percent-repeat-counter.ly}
 701
 702 @lilypondfile[verbatim,quote,texidoc,doctitle]
 703 {percent-repeat-count-visibility.ly}
 704
 705 @lilypondfile[verbatim,quote,texidoc,doctitle]
 706 {isolated-percent-repeats.ly}
 707
 708 @seealso
 709 Music Glossary:
 710 @rglos{percent repeat},
 711 @rglos{simile}.
 712
 713 Snippets:
 714 @rlsr{Repeats}.
 715
 716 Internals Reference:
 717 @rinternals{RepeatSlash},
 718 @rinternals{RepeatSlashEvent},
 719 @rinternals{DoubleRepeatSlash},
 720 @rinternals{PercentRepeat},
 721 @rinternals{PercentRepeatCounter},
 722 @rinternals{PercentRepeatedMusic},
 723 @rinternals{Percent_repeat_engraver},
 724 @rinternals{DoublePercentEvent},
 725 @rinternals{DoublePercentRepeat},
 726 @rinternals{DoublePercentRepeatCounter},
 727 @rinternals{Double_percent_repeat_engraver},
 728 @rinternals{Slash_repeat_engraver}.
 729
 730
 731 @node Tremolo repeats
 732 @unnumberedsubsubsec Tremolo repeats
 733
 734 @cindex tremolo beams
 735 @cindex tremolo
 736 @cindex repeat, tremolo
 737 @funindex \repeat tremolo
 738 @funindex tremolo
 739
 740 Tremolos can take two forms: alternation between two chords or two
 741 notes, and rapid repetition of a single note or chord.  Tremolos
 742 consisting of an alternation are indicated by adding beams between the
 743 notes or chords being alternated, while tremolos consisting of the
 744 rapid repetition of a single note are indicated by adding beams or
 745 slashes to a single note.
 746
 747 To place tremolo marks between notes, use @code{\repeat} with
 748 tremolo style:
 749
 750 @lilypond[quote,verbatim,relative=2]
 751 \repeat tremolo 8 { c16 d }
 752 \repeat tremolo 6 { c16 d }
 753 \repeat tremolo 2 { c16 d }
 754 @end lilypond
 755
 756 The @code{\repeat tremolo} syntax expects exactly two notes within
 757 the braces, and the number of repetitions must correspond to a
 758 note value that can be expressed with plain or dotted notes.  Thus,
 759 @code{\repeat tremolo 7} is valid and produces a double dotted
 760 note, but @code{\repeat tremolo 9} is not.
 761
 762 The duration of the tremolo equals the duration of the
 763 braced expression multiplied by the number of repeats:
 764 @code{\repeat tremolo 8 @{ c16 d16 @}} gives a whole note tremolo,
 765 notated as two whole notes joined by tremolo beams.
 766
 767 There are two ways to put tremolo marks on a single note.  The
 768 @code{\repeat tremolo} syntax is also used here, in which case
 769 the note should not be surrounded by braces:
 770
 771 @lilypond[quote,verbatim,ragged-right]
 772 \repeat tremolo 4 c'16
 773 @end lilypond
 774
 775 @cindex tremolo marks
 776 @funindex :
 777
 778 The same output can be obtained by adding @code{:@var{N}} after
 779 the note, where @code{@var{N}} indicates the duration of the
 780 subdivision (it must be at least 8).  If @code{@var{N}} is 8, one
 781 beam is added to the note's stem.  If @code{@var{N}} is omitted,
 782 the last value is used:
 783
 784 @lilypond[quote,verbatim,relative=2]
 785 c2:8 c:32
 786 c: c:
 787 @end lilypond
 788
 789 @snippets
 790
 791 @lilypondfile[verbatim,quote,texidoc,doctitle]
 792 {cross-staff-tremolos.ly}
 793
 794 @seealso
 795 Snippets:
 796 @rlsr{Repeats}.
 797
 798 @cindex tremolo, cross-staff
 799 @cindex cross-staff tremolo