Documentation/notation/notation-appendices.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2
   3 @ignore
   4     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  For details, see the Contributors'
   8     Guide, node Updating translation committishes..
   9 @end ignore
  10
  11 @c \version "2.19.28"
  12
  13 @node Notation manual tables
  14 @appendix Notation manual tables
  15
  16 @menu
  17 * Chord name chart::
  18 * Common chord modifiers::
  19 * Predefined string tunings::
  20 * Predefined fretboard diagrams::
  21 * Predefined paper sizes::
  22 * MIDI instruments::
  23 * List of colors::
  24 * The Emmentaler font::
  25 * Note head styles::
  26 * Clef styles::
  27 * Text markup commands::
  28 * Text markup list commands::
  29 * List of special characters::
  30 * List of articulations::
  31 * Percussion notes::
  32 * Technical glossary::
  33 * All context properties::
  34 * Layout properties::
  35 * Available music functions::
  36 * Context modification identifiers::
  37 * Predefined type predicates::
  38 * Scheme functions::
  39 @end menu
  40
  41
  42
  43 @node Chord name chart
  44 @appendixsec Chord name chart
  45
  46 The following chart shows two standard systems for printing chord
  47 names, along with the pitches they represent.
  48
  49 @c The line width is a hack to allow space for instrument names
  50 @lilypondfile[quote,line-width=15\cm]{chord-names-jazz.ly}
  51
  52 @node Common chord modifiers
  53 @appendixsec Common chord modifiers
  54
  55 The following table shows chord modifiers that can be used to generate
  56 standard chord structures.
  57
  58 @multitable @columnfractions .2 .25 .2 .15 .2
  59
  60 @item
  61 @b{Type}
  62 @tab
  63 @b{Interval}
  64 @tab
  65 @b{Modifier}
  66 @tab
  67 @b{Example}
  68 @tab
  69 @b{Output}
  70
  71
  72 @item
  73 Major
  74 @tab
  75 Major third, @*perfect fifth
  76 @tab
  77 @code{5} or nothing
  78 @tab
  79 @code{c1:5}
  80 @tab
  81 @lilypond[line-width=2.1\cm,notime]
  82 <<
  83   \chords { c1:5 }
  84   \chordmode { c1:5 }
  85 >>
  86 @end lilypond
  87
  88 @item
  89 Minor
  90 @tab
  91 Minor third, @*perfect fifth
  92 @tab
  93 @code{m} or @code{m5}
  94 @tab
  95 @code{c1:m}
  96 @tab
  97 @lilypond[line-width=2.1\cm,noragged-right,notime]
  98 <<
  99   \chords { c1:m }
 100   \chordmode { c1:m }
 101 >>
 102 @end lilypond
 103
 104 @item
 105 Augmented
 106 @tab
 107 Major third, @*augmented fifth
 108 @tab
 109 @code{aug}
 110 @tab
 111 @code{c1:aug}
 112 @tab
 113 @lilypond[line-width=2.1\cm,noragged-right,notime]
 114 <<
 115   \chords { c1:aug }
 116   \chordmode { c1:aug }
 117 >>
 118 @end lilypond
 119
 120 @item
 121 Diminished
 122 @tab
 123 Minor third, @*diminished fifth
 124 @tab
 125 @code{dim}
 126 @tab
 127 @code{c1:dim}
 128 @tab
 129 @lilypond[line-width=2.1\cm,noragged-right,notime]
 130 <<
 131   \chords { c1:dim }
 132   \chordmode { c1:dim }
 133 >>
 134 @end lilypond
 135
 136 @item
 137 Dominant seventh
 138 @tab
 139 Major triad, @*minor seventh
 140 @tab
 141 @code{7}
 142 @tab
 143 @code{c1:7}
 144 @tab
 145 @lilypond[line-width=2.1\cm,noragged-right,notime]
 146 <<
 147   \chords { c1:7 }
 148   \chordmode { c1:7 }
 149 >>
 150 @end lilypond
 151
 152 @item
 153 Major seventh
 154 @tab
 155 Major triad, @*major seventh
 156 @tab
 157 @code{maj7} or @code{maj}
 158 @tab
 159 @code{c1:maj7}
 160 @tab
 161 @lilypond[line-width=2.1\cm,noragged-right,notime]
 162 <<
 163   \chords { c1:maj7 }
 164   \chordmode { c1:maj7 }
 165 >>
 166 @end lilypond
 167
 168 @item
 169 Minor seventh
 170 @tab
 171 Minor triad, @*minor seventh
 172 @tab
 173 @code{m7}
 174 @tab
 175 @code{c1:m7}
 176 @tab
 177 @lilypond[line-width=2.1\cm,noragged-right,notime]
 178 <<
 179   \chords { c1:m7 }
 180   \chordmode { c1:m7 }
 181 >>
 182 @end lilypond
 183
 184 @item
 185 Diminished seventh
 186 @tab
 187 Diminished triad, @*diminished seventh
 188 @tab
 189 @code{dim7}
 190 @tab
 191 @code{c1:dim7}
 192 @tab
 193 @lilypond[line-width=2.1\cm,noragged-right,notime]
 194 <<
 195   \chords { c1:dim7}
 196   \chordmode { c1:dim7 }
 197 >>
 198 @end lilypond
 199
 200 @item
 201 Augmented seventh
 202 @tab
 203 Augmented triad, @*minor seventh
 204 @tab
 205 @code{aug7}
 206 @tab
 207 @code{c1:aug7}
 208 @tab
 209 @lilypond[line-width=2.1\cm,noragged-right,notime]
 210 <<
 211   \chords { c1:aug7 }
 212   \chordmode { c1:aug7 }
 213 >>
 214 @end lilypond
 215
 216 @item
 217 Half-diminished seventh
 218 @tab
 219 Diminished triad, @*minor seventh
 220 @tab
 221 @code{m7.5-}
 222 @tab
 223 @code{c1:m7.5-}
 224 @tab
 225 @lilypond[line-width=2.1\cm,noragged-right,notime]
 226 <<
 227   \chords { c1:m7.5- }
 228   \chordmode { c1:m7.5- }
 229 >>
 230 @end lilypond
 231
 232 @item
 233 Minor-major seventh
 234 @tab
 235 Minor triad, @*major seventh
 236 @tab
 237 @code{m7+}
 238 @tab
 239 @code{c1:m7+}
 240 @tab
 241 @lilypond[line-width=2.1\cm,noragged-right,notime]
 242 <<
 243   \chords { c1:m7+ }
 244   \chordmode { c1:m7+ }
 245 >>
 246 @end lilypond
 247
 248 @item
 249 Major sixth
 250 @tab
 251 Major triad, @*sixth
 252 @tab
 253 @code{6}
 254 @tab
 255 @code{c1:6}
 256 @tab
 257 @lilypond[line-width=2.1\cm,noragged-right,notime]
 258 <<
 259   \chords { c1:6 }
 260   \chordmode { c1:6 }
 261 >>
 262 @end lilypond
 263
 264 @item
 265 Minor sixth
 266 @tab
 267 Minor triad, @*sixth
 268 @tab
 269 @code{m6}
 270 @tab
 271 @code{c1:m6}
 272 @tab
 273 @lilypond[line-width=2.1\cm,noragged-right,notime]
 274 <<
 275   \chords { c1:m6 }
 276   \chordmode { c1:m6 }
 277 >>
 278 @end lilypond
 279
 280 @item
 281 Dominant ninth
 282 @tab
 283 Dominant seventh, @*major ninth
 284 @tab
 285 @code{9}
 286 @tab
 287 @code{c1:9}
 288 @tab
 289 @lilypond[line-width=2.1\cm,noragged-right,notime]
 290 <<
 291   \chords { c1:9 }
 292   \chordmode { c1:9 }
 293 >>
 294 @end lilypond
 295
 296 @item
 297 Major ninth
 298 @tab
 299 Major seventh, @*major ninth
 300 @tab
 301 @code{maj9}
 302 @tab
 303 @code{c1:maj9}
 304 @tab
 305 @lilypond[line-width=2.1\cm,noragged-right,notime]
 306 <<
 307   \chords { c1:maj9 }
 308   \chordmode { c1:maj9 }
 309 >>
 310 @end lilypond
 311
 312 @item
 313 Minor ninth
 314 @tab
 315 Minor seventh, @*major ninth
 316 @tab
 317 @code{m9}
 318 @tab
 319 @code{c1:m9}
 320 @tab
 321 @lilypond[line-width=2.1\cm,noragged-right,notime]
 322 <<
 323   \chords { c1:m9 }
 324   \chordmode { c1:m9 }
 325 >>
 326 @end lilypond
 327
 328 @item
 329 Dominant eleventh
 330 @tab
 331 Dominant ninth, @*perfect eleventh
 332 @tab
 333 @code{11}
 334 @tab
 335 @code{c1:11}
 336 @tab
 337 @lilypond[line-width=2.1\cm,noragged-right,notime]
 338 <<
 339   \chords { c1:11 }
 340   \chordmode { c1:11 }
 341 >>
 342 @end lilypond
 343
 344 @item
 345 Major eleventh
 346 @tab
 347 Major ninth, @*perfect eleventh
 348 @tab
 349 @code{maj11}
 350 @tab
 351 @code{c1:maj11}
 352 @tab
 353 @lilypond[line-width=2.1\cm,noragged-right,notime]
 354 <<
 355   \chords { c1:maj11 }
 356   \chordmode { c1:maj11 }
 357 >>
 358 @end lilypond
 359
 360 @item
 361 Minor eleventh
 362 @tab
 363 Minor ninth, @*perfect eleventh
 364 @tab
 365 @code{m11}
 366 @tab
 367 @code{c1:m11}
 368 @tab
 369 @lilypond[line-width=2.1\cm,noragged-right,notime]
 370 <<
 371   \chords { c1:m11 }
 372   \chordmode { c1:m11 }
 373 >>
 374 @end lilypond
 375
 376 @item
 377 Dominant thirteenth
 378 @tab
 379 Dominant ninth, @*major thirteenth
 380 @tab
 381 @code{13}
 382 @tab
 383 @code{c1:13}
 384 @tab
 385 @lilypond[line-width=2.1\cm,noragged-right,notime]
 386 <<
 387   \chords { c1:13 }
 388   \chordmode { c1:13 }
 389 >>
 390 @end lilypond
 391
 392 @item
 393 Dominant thirteenth
 394 @tab
 395 Dominant eleventh, @*major thirteenth
 396 @tab
 397 @code{13.11}
 398 @tab
 399 @code{c1:13.11}
 400 @tab
 401 @lilypond[line-width=2.1\cm,noragged-right,notime]
 402 <<
 403   \chords{ c1:13.11 }
 404   \chordmode { c1:13.11 }
 405 >>
 406 @end lilypond
 407
 408 @item
 409 Major thirteenth
 410 @tab
 411 Major eleventh, @*major thirteenth
 412 @tab
 413 @code{maj13.11}
 414 @tab
 415 @code{c1:maj13.11}
 416 @tab
 417 @lilypond[line-width=2.1\cm,noragged-right,notime]
 418 <<
 419   \chords { c1:maj13.11 }
 420   \chordmode { c1:maj13.11 }
 421 >>
 422 @end lilypond
 423
 424 @item
 425 Minor thirteenth
 426 @tab
 427 Minor eleventh, @*major thirteenth
 428 @tab
 429 @code{m13.11}
 430 @tab
 431 @code{c1:m13.11}
 432 @tab
 433 @lilypond[line-width=2.1\cm,noragged-right,notime]
 434 <<
 435   \chords { c1:m13.11 }
 436   \chordmode { c1:m13.11 }
 437 >>
 438 @end lilypond
 439
 440 @item
 441 Suspended second
 442 @tab
 443 Major second, @*perfect fifth
 444 @tab
 445 @code{sus2}
 446 @tab
 447 @code{c1:sus2}
 448 @tab
 449 @lilypond[line-width=2.1\cm,noragged-right,notime]
 450 <<
 451   \chords { c1:sus2 }
 452   \chordmode { c1:sus2 }
 453 >>
 454 @end lilypond
 455
 456 @item
 457 Suspended fourth
 458 @tab
 459 Perfect fourth, @*perfect fifth
 460 @tab
 461 @code{sus4}
 462 @tab
 463 @code{c1:sus4}
 464 @tab
 465 @lilypond[line-width=2.1\cm,noragged-right,notime]
 466 <<
 467   \chords { c1:sus4 }
 468   \chordmode { c1:sus4 }
 469 >>
 470 @end lilypond
 471
 472 @item
 473 Power chord @*(two-voiced)
 474 @tab
 475 Perfect fifth
 476 @tab
 477 @code{1.5}
 478 @tab
 479 @code{\powerChords c1:5}
 480 @tab
 481 @lilypond[line-width=2.1\cm,noragged-right,notime]
 482 \chordmode { \powerChords c1:5 }
 483 @end lilypond
 484
 485 @item
 486 Power chord @*@w{(three-voiced)}
 487 @tab
 488 Perfect fifth, @*octave
 489 @tab
 490 @code{1.5.8}
 491 @tab
 492 @code{\powerChords c1:5.8}
 493 @tab
 494 @lilypond[line-width=2.1\cm,noragged-right,notime]
 495   \chordmode { \powerChords c1:5.8 }
 496 @end lilypond
 497
 498 @end multitable
 499
 500 @node Predefined string tunings
 501 @appendixsec Predefined string tunings
 502
 503 The chart below shows the predefined string tunings.
 504
 505 @lilypondfile{display-predefined-string-tunings.ly}
 506
 507 @node Predefined fretboard diagrams
 508 @appendixsec Predefined fretboard diagrams
 509
 510 @menu
 511 * Diagrams for Guitar::
 512 * Diagrams for Ukulele::
 513 * Diagrams for Mandolin::
 514 @end menu
 515
 516 @node Diagrams for Guitar
 517 @unnumberedsubsec Diagrams for Guitar
 518
 519 @lilypondfile[line-width=15.5\cm]{display-predefined-fretboards.ly}
 520
 521 @node Diagrams for Ukulele
 522 @unnumberedsubsec Diagrams for Ukulele
 523
 524 @lilypondfile[line-width=15.5\cm]{display-predefined-ukulele-fretboards.ly}
 525
 526 @node Diagrams for Mandolin
 527 @unnumberedsubsec Diagrams for Mandolin
 528
 529 @lilypondfile[line-width=15.5\cm]{display-predefined-mandolin-fretboards.ly}
 530
 531
 532 @node Predefined paper sizes
 533 @appendixsec Predefined paper sizes
 534
 535 Paper sizes are defined in @file{scm/paper.scm}
 536
 537 @noindent
 538 @strong{The @qq{ISO 216} A Series}
 539 @table @code
 540 @item "a10"
 541 (26 x 37 mm)
 542 @item "a9"
 543 (37 x 52 mm)
 544 @item "a8"
 545 (52 x 74 mm)
 546 @item "a7"
 547 (74 x 105 mm)
 548 @item "a6"
 549 (105 x 148 mm)
 550 @item "a5"
 551 (148 x 210 mm)
 552 @item "a4"
 553 (210 x 297 mm)
 554 @item "a3"
 555 (297 x 420 mm)
 556 @item "a2"
 557 (420 x 594 mm)
 558 @item "a1"
 559 (594 x 841 mm)
 560 @item "a0"
 561 (841 x 1189 mm)
 562 @end table
 563
 564 @noindent
 565 @strong{The @qq{ISO 216} B Series}
 566 @table @code
 567 @item "b10"
 568 (31 x 44 mm)
 569 @item "b9"
 570 (44 x 62 mm)
 571 @item "b8"
 572 (62 x 88 mm)
 573 @item "b7"
 574 (88 x 125 mm)
 575 @item "b6"
 576 (125 x 176 mm)
 577 @item "b5"
 578 (176 x 250 mm)
 579 @item "b4"
 580 (250 x 353 mm)
 581 @item "b3"
 582 (353 x 500 mm)
 583 @item "b2"
 584 (500 x 707 mm)
 585 @item "b1"
 586 (707 x 1000 mm)
 587 @item "b0"
 588 (1000 x 1414 mm)
 589 @end table
 590
 591 @noindent
 592 @strong{Two extended sizes as defined in @qq{DIN 476}}
 593 @table @code
 594 @item "4a0"
 595 (1682 x 2378 mm)
 596 @item "2a0"
 597 (1189 x 1682 mm)
 598 @end table
 599
 600 @noindent
 601 @strong{@qq{ISO 269} standard C series}
 602 @table @code
 603 @item "c10"
 604 (28 x 40 mm)
 605 @item "c9"
 606 (40 x 57 mm)
 607 @item "c8"
 608 (57 x 81 mm)
 609 @item "c7"
 610 (81 x 114 mm)
 611 @item "c6"
 612 (114 x 162 mm)
 613 @item "c5"
 614 (162 x 229 mm)
 615 @item "c4"
 616 (229 x 324 mm)
 617 @item "c3"
 618 (324 x 458 mm)
 619 @item "c2"
 620 (458 x 648 mm)
 621 @item "c1"
 622 (648 x 917 mm)
 623 @item "c0"
 624 (917 x 1297 mm)
 625 @end table
 626
 627 @noindent
 628 @strong{North American paper sizes}
 629 @table @code
 630 @item "junior-legal"
 631 (8.0 x 5.0 in)
 632 @item "legal"
 633 (8.5 x 14.0 in)
 634 @item "ledger"
 635 (17.0 x 11.0 in)
 636 @item "letter"
 637 (8.5 x 11.0 in)
 638 @item "tabloid"
 639 (11.0 x 17.0 in)
 640 @item "11x17"
 641 (11.0 x 17.0 in)
 642 @item "17x11"
 643 (17.0 x 11.0 in)
 644 @end table
 645
 646 @noindent
 647 @strong{Government-letter by IEEE Printer Working Group, for children's
 648 writing}
 649 @table @code
 650 @item "government-letter"
 651 (8 x 10.5 in)
 652 @item "government-legal"
 653 (8.5 x 13.0 in)
 654 @item "philippine-legal"
 655 (8.5 x 13.0 in)
 656 @end table
 657
 658 @noindent
 659 @strong{ANSI sizes}
 660 @table @code
 661 @item "ansi a"
 662 (8.5 x 11.0 in)
 663 @item "ansi b"
 664 (17.0 x 11.0 in)
 665 @item "ansi c"
 666 (17.0 x 22.0 in)
 667 @item "ansi d"
 668 (22.0 x 34.0 in)
 669 @item "ansi e"
 670 (34.0 x 44.0 in)
 671 @item "engineering f"
 672 (28.0 x 40.0 in)
 673 @end table
 674
 675 @noindent
 676 @strong{North American Architectural sizes}
 677 @table @code
 678 @item "arch a"
 679 (9.0 x 12.0 in)
 680 @item "arch b"
 681 (12.0 x 18.0 in)
 682 @item "arch c"
 683 (18.0 x 24.0 in)
 684 @item "arch d"
 685 (24.0 x 36.0 in)
 686 @item "arch e"
 687 (36.0 x 48.0 in)
 688 @item "arch e1"
 689 (30.0 x 42.0 in)
 690 @end table
 691
 692 @noindent
 693 @strong{Antique sizes still used in the United Kingdom}
 694 @table @code
 695 @item "statement"
 696 (5.5 x 8.5 in)
 697 @item "half letter"
 698 (5.5 x 8.5 in)
 699 @item "quarto"
 700 (8.0 x 10.0 in)
 701 @item "octavo"
 702 (6.75 x 10.5 in)
 703 @item "executive"
 704 (7.25 x 10.5 in)
 705 @item "monarch"
 706 (7.25 x 10.5 in)
 707 @item "foolscap"
 708 (8.27 x 13.0 in)
 709 @item "folio"
 710 (8.27 x 13.0 in)
 711 @item "super-b"
 712 (13.0 x 19.0 in)
 713 @item "post"
 714 (15.5 x 19.5 in)
 715 @item "crown"
 716 (15.0 x 20.0 in)
 717 @item "large post"
 718 (16.5 x 21.0 in)
 719 @item "demy"
 720 (17.5 x 22.5 in)
 721 @item "medium"
 722 (18.0 x 23.0 in)
 723 @item "broadsheet"
 724 (18.0 x 24.0 in)
 725 @item "royal"
 726 (20.0 x 25.0 in)
 727 @item "elephant"
 728 (23.0 x 28.0 in)
 729 @item "double demy"
 730 (22.5 x 35.0 in)
 731 @item "quad demy"
 732 (35.0 x 45.0 in)
 733 @item "atlas"
 734 (26.0 x 34.0 in)
 735 @item "imperial"
 736 (22.0 x 30.0 in)
 737 @item "antiquarian"
 738 (31.0 x 53.0 in)
 739 @end table
 740
 741 @noindent
 742 @strong{PA4 based sizes}
 743 @table @code
 744 @item "pa0"
 745 (840 x 1120 mm)
 746 @item "pa1"
 747 (560 x 840 mm)
 748 @item "pa2"
 749 (420 x 560 mm)
 750 @item "pa3"
 751 (280 x 420 mm)
 752 @item "pa4"
 753 (210 x 280 mm)
 754 @item "pa5"
 755 (140 x 210 mm)
 756 @item "pa6"
 757 (105 x 140 mm)
 758 @item "pa7"
 759 (70 x 105 mm)
 760 @item "pa8"
 761 (52 x 70 mm)
 762 @item "pa9"
 763 (35 x 52 mm)
 764 @item "pa10"
 765 (26 x 35 mm)
 766 @end table
 767
 768 @noindent
 769 @strong{Used in Southeast Asia and Australia}
 770 @table @code
 771 @item "f4"
 772 (210 x 330 mm)
 773 @end table
 774
 775 @noindent
 776 @strong{Used for very small @code{@@lilypond} examples in the
 777 documentation based on a8 landscape.}
 778 @table @code
 779 @item "a8landscape"
 780 (74 x 52 mm)
 781 @end table
 782
 783
 784 @node MIDI instruments
 785 @appendixsec MIDI instruments
 786
 787 The following is a list of names that can be used for the
 788 @code{midiInstrument} property.  The order of the instruments
 789 below, starting in the left-hand column moving down, corresponds
 790 to the General MIDI Standard's 128 Program Numbers.
 791
 792 @example
 793 acoustic grand            contrabass           lead 7 (fifths)
 794 bright acoustic           tremolo strings      lead 8 (bass+lead)
 795 electric grand            pizzicato strings    pad 1 (new age)
 796 honky-tonk                orchestral harp      pad 2 (warm)
 797 electric piano 1          timpani              pad 3 (polysynth)
 798 electric piano 2          string ensemble 1    pad 4 (choir)
 799 harpsichord               string ensemble 2    pad 5 (bowed)
 800 clav                      synthstrings 1       pad 6 (metallic)
 801 celesta                   synthstrings 2       pad 7 (halo)
 802 glockenspiel              choir aahs           pad 8 (sweep)
 803 music box                 voice oohs           fx 1 (rain)
 804 vibraphone                synth voice          fx 2 (soundtrack)
 805 marimba                   orchestra hit        fx 3 (crystal)
 806 xylophone                 trumpet              fx 4 (atmosphere)
 807 tubular bells             trombone             fx 5 (brightness)
 808 dulcimer                  tuba                 fx 6 (goblins)
 809 drawbar organ             muted trumpet        fx 7 (echoes)
 810 percussive organ          french horn          fx 8 (sci-fi)
 811 rock organ                brass section        sitar
 812 church organ              synthbrass 1         banjo
 813 reed organ                synthbrass 2         shamisen
 814 accordion                 soprano sax          koto
 815 harmonica                 alto sax             kalimba
 816 concertina                tenor sax            bagpipe
 817 acoustic guitar (nylon)   baritone sax         fiddle
 818 acoustic guitar (steel)   oboe                 shanai
 819 electric guitar (jazz)    english horn         tinkle bell
 820 electric guitar (clean)   bassoon              agogo
 821 electric guitar (muted)   clarinet             steel drums
 822 overdriven guitar         piccolo              woodblock
 823 distorted guitar          flute                taiko drum
 824 guitar harmonics          recorder             melodic tom
 825 acoustic bass             pan flute            synth drum
 826 electric bass (finger)    blown bottle         reverse cymbal
 827 electric bass (pick)      shakuhachi           guitar fret noise
 828 fretless bass             whistle              breath noise
 829 slap bass 1               ocarina              seashore
 830 slap bass 2               lead 1 (square)      bird tweet
 831 synth bass 1              lead 2 (sawtooth)    telephone ring
 832 synth bass 2              lead 3 (calliope)    helicopter
 833 violin                    lead 4 (chiff)       applause
 834 viola                     lead 5 (charang)     gunshot
 835 cello                     lead 6 (voice)
 836 @end example
 837
 838
 839 @node List of colors
 840 @appendixsec List of colors
 841
 842 @subsubheading Normal colors
 843
 844 Usage syntax is detailed in @ref{Coloring objects}.
 845
 846 @cindex List of colors
 847 @cindex Colors, list of
 848
 849 @verbatim
 850 black       white          red         green
 851 blue        cyan           magenta     yellow
 852 grey        darkred        darkgreen   darkblue
 853 darkcyan    darkmagenta    darkyellow
 854 @end verbatim
 855
 856
 857 @subsubheading X color names
 858
 859 X color names come several variants:
 860
 861 Any name that is spelled as a single word with capitalization
 862 (e.g., @q{LightSlateBlue}) can also be spelled as space separated
 863 words without capitalization (e.g., @q{light slate blue}).
 864
 865 The word @q{grey} can always be spelled @q{gray} (e.g., @q{DarkSlateGray}).
 866
 867 Some names can take a numerical suffix (e.g., @q{LightSalmon4}).
 868
 869
 870 @subsubheading Color Names without a numerical suffix:
 871
 872 @verbatim
 873 snow            GhostWhite      WhiteSmoke      gainsboro       FloralWhite
 874 OldLace         linen           AntiqueWhite    PapayaWhip      BlanchedAlmond
 875 bisque          PeachPuff       NavajoWhite     moccasin        cornsilk
 876 ivory           LemonChiffon    seashell        honeydew        MintCream
 877 azure           AliceBlue       lavender        LavenderBlush   MistyRose
 878 white           black           DarkSlateGrey   DimGrey         SlateGrey
 879 LightSlateGrey  grey            LightGrey       MidnightBlue    navy
 880 NavyBlue        CornflowerBlue  DarkSlateBlue   SlateBlue       MediumSlateBlue
 881 LightSlateBlue  MediumBlue      RoyalBlue       blue            DodgerBlue
 882 DeepSkyBlue     SkyBlue         LightSkyBlue    SteelBlue       LightSteelBlue
 883 LightBlue       PowderBlue      PaleTurquoise   DarkTurquoise   MediumTurquoise
 884 turquoise       cyan            LightCyan       CadetBlue       MediumAquamarine
 885 aquamarine      DarkGreen       DarkOliveGreen  DarkSeaGreen    SeaGreen
 886 MediumSeaGreen  LightSeaGreen   PaleGreen       SpringGreen     LawnGreen
 887 green           chartreuse      MediumSpringGreen       GreenYellow     LimeGreen
 888 YellowGreen     ForestGreen     OliveDrab       DarkKhaki       khaki
 889 PaleGoldenrod   LightGoldenrodYellow    LightYellow     yellow  gold
 890 LightGoldenrod  goldenrod       DarkGoldenrod   RosyBrown       IndianRed
 891 SaddleBrown     sienna          peru            burlywood       beige
 892 wheat           SandyBrown      tan             chocolate       firebrick
 893 brown           DarkSalmon      salmon          LightSalmon     orange
 894 DarkOrange      coral           LightCoral      tomato          OrangeRed
 895 red             HotPink         DeepPink        pink            LightPink
 896 PaleVioletRed   maroon          MediumVioletRed VioletRed       magenta
 897 violet          plum            orchid          MediumOrchid    DarkOrchid
 898 DarkViolet      BlueViolet      purple          MediumPurple    thistle
 899 DarkGrey        DarkBlue        DarkCyan        DarkMagenta     DarkRed
 900 LightGreen
 901 @end verbatim
 902
 903
 904 @subsubheading Color names with a numerical suffix
 905
 906 In the following names the suffix N can be a number in the range 1-4:
 907
 908 @verbatim
 909 snowN           seashellN       AntiqueWhiteN   bisqueN         PeachPuffN
 910 NavajoWhiteN    LemonChiffonN   cornsilkN       ivoryN          honeydewN
 911 LavenderBlushN  MistyRoseN      azureN          SlateBlueN      RoyalBlueN
 912 blueN           DodgerBlueN     SteelBlueN      DeepSkyBlueN    SkyBlueN
 913 LightSkyBlueN   LightSteelBlueN LightBlueN      LightCyanN      PaleTurquoiseN
 914 CadetBlueN      turquoiseN      cyanN           aquamarineN     DarkSeaGreenN
 915 SeaGreenN       PaleGreenN      SpringGreenN    greenN          chartreuseN
 916 OliveDrabN      DarkOliveGreenN khakiN          LightGoldenrodN LightYellowN
 917 yellowN         goldN           goldenrodN      DarkGoldenrodN  RosyBrownN
 918 IndianRedN      siennaN         burlywoodN      wheatN          tanN
 919 chocolateN      firebrickN      brownN          salmonN         LightSalmonN
 920 orangeN         DarkOrangeN     coralN          tomatoN         OrangeRedN
 921 redN            DeepPinkN       HotPinkN        pinkN           LightPinkN
 922 PaleVioletRedN  maroonN         VioletRedN      magentaN        orchidN
 923 plumN           MediumOrchidN   DarkOrchidN     purpleN         MediumPurpleN
 924 thistleN
 925 @end verbatim
 926
 927
 928 @subsubheading Grey Scale
 929
 930 A grey scale can be obtained using:
 931
 932 @example
 933 greyN
 934 @end example
 935
 936 @noindent
 937 Where N is in the range 0-100.
 938
 939
 940 @node The Emmentaler font
 941 @appendixsec The Emmentaler font
 942
 943
 944 @cindex Emmentaler font
 945 @cindex Font, Emmentaler
 946 @cindex Feta font
 947 @cindex Font, Feta
 948 @cindex Parmesan font
 949 @cindex Font, Parmesan
 950
 951 The Emmentaler font consists of two @emph{sub-sets} of glyphs.
 952 @qq{Feta}, used for classical notation and @qq{Parmesan}, used for
 953 Ancient notation.
 954
 955 Any glyph within the Emmentaler font can be accessed directly by using
 956 text markup along with the name of the glyph (as shown in the tables
 957 below).  For example;
 958
 959 @example
 960 g^\markup @{\musicglyph #"scripts.segno" @}
 961 @end example
 962
 963 @noindent
 964 or
 965
 966 @example
 967 \markup @{\musicglyph #"five"@}
 968 @end example
 969
 970 For more information see @ref{Formatting text}.
 971
 972
 973 @menu
 974 * Clef glyphs::
 975 * Time Signature glyphs::
 976 * Number glyphs::
 977 * Accidental glyphs::
 978 * Default Notehead glyphs::
 979 * Special Notehead glyphs::
 980 * Shape-note Notehead glyphs::
 981 * Rest glyphs::
 982 * Flag glyphs::
 983 * Dot glyphs::
 984 * Dynamic glyphs::
 985 * Script glyphs::
 986 * Arrowhead glyphs::
 987 * Bracket-tip glyphs::
 988 * Pedal glyphs::
 989 * Accordion glyphs::
 990 * Tie glyphs::
 991 * Vaticana glyphs::
 992 * Medicaea glyphs::
 993 * Hufnagel glyphs::
 994 * Mensural glyphs::
 995 * Neomensural glyphs::
 996 * Petrucci glyphs::
 997 * Solesmes glyphs::
 998 * Kievan Notation glyphs::
 999 @end menu
1000
1001
1002 @node Clef glyphs
1003 @unnumberedsubsec Clef glyphs
1004
1005 @lilypond[quote]
1006 \include "font-table.ly"
1007 \markuplist \override-lines #'(word-space . 4)
1008             \doc-chars #clefs
1009 @end lilypond
1010
1011
1012 @node Time Signature glyphs
1013 @unnumberedsubsec Time Signature glyphs
1014
1015 @lilypond[quote]
1016 \include "font-table.ly"
1017 \markuplist \override-lines #'(word-space . 4)
1018             \doc-chars #timesig
1019 @end lilypond
1020
1021
1022 @node Number glyphs
1023 @unnumberedsubsec Number glyphs
1024
1025 @lilypond[quote]
1026 \include "font-table.ly"
1027 \markuplist \override-lines #'(word-space . 4)
1028             \doc-chars #numbers
1029 @end lilypond
1030
1031
1032 @node Accidental glyphs
1033 @unnumberedsubsec Accidental glyphs
1034
1035 @lilypond[quote]
1036 \include "font-table.ly"
1037 \markuplist \override-lines #'(word-space . 4)
1038             \doc-chars #accidentals
1039 @end lilypond
1040
1041
1042 @node Default Notehead glyphs
1043 @unnumberedsubsec Default Notehead glyphs
1044
1045 @lilypond[quote]
1046 \include "font-table.ly"
1047 \markuplist \override-lines #'(word-space . 4)
1048             \doc-chars #default-noteheads
1049 @end lilypond
1050
1051
1052 @node Special Notehead glyphs
1053 @unnumberedsubsec Special Notehead glyphs
1054
1055 @lilypond[quote]
1056 \include "font-table.ly"
1057 \markuplist \override-lines #'(word-space . 4)
1058             \doc-chars #special-noteheads
1059 @end lilypond
1060
1061
1062 @node Shape-note Notehead glyphs
1063 @unnumberedsubsec Shape-note Notehead glyphs
1064
1065 @lilypond[quote]
1066 \include "font-table.ly"
1067 \markuplist \override-lines #'(word-space . 4)
1068             \doc-chars #shape-note-noteheads
1069 @end lilypond
1070
1071
1072 @node Rest glyphs
1073 @unnumberedsubsec Rest glyphs
1074
1075 @lilypond[quote]
1076 \include "font-table.ly"
1077 \markuplist \override-lines #'(word-space . 4)
1078             \doc-chars #rests
1079 @end lilypond
1080
1081
1082 @node Flag glyphs
1083 @unnumberedsubsec Flag glyphs
1084
1085 @lilypond[quote]
1086 \include "font-table.ly"
1087 \markuplist \override-lines #'(word-space . 4)
1088             \doc-chars #flags
1089 @end lilypond
1090
1091
1092 @node Dot glyphs
1093 @unnumberedsubsec Dot glyphs
1094
1095 @lilypond[quote]
1096 \include "font-table.ly"
1097 \markuplist \override-lines #'(word-space . 4)
1098             \doc-chars #dots
1099 @end lilypond
1100
1101
1102 @node Dynamic glyphs
1103 @unnumberedsubsec Dynamic glyphs
1104
1105 @lilypond[quote]
1106 \include "font-table.ly"
1107 \markuplist \override-lines #'(word-space . 4)
1108             \doc-chars #dynamics
1109 @end lilypond
1110
1111
1112 @node Script glyphs
1113 @unnumberedsubsec Script glyphs
1114
1115 @lilypond[quote]
1116 \include "font-table.ly"
1117 \markuplist \override-lines #'(word-space . 4)
1118             \doc-chars #scripts
1119 @end lilypond
1120
1121
1122 @node Arrowhead glyphs
1123 @unnumberedsubsec Arrowhead glyphs
1124
1125 @lilypond[quote]
1126 \include "font-table.ly"
1127 \markuplist \override-lines #'(word-space . 4)
1128             \doc-chars #arrowheads
1129 @end lilypond
1130
1131
1132 @node Bracket-tip glyphs
1133 @unnumberedsubsec Bracket-tip glyphs
1134
1135 @lilypond[quote]
1136 \include "font-table.ly"
1137 \markuplist \override-lines #'(word-space . 4)
1138             \doc-chars #brackettips
1139 @end lilypond
1140
1141
1142 @node Pedal glyphs
1143 @unnumberedsubsec Pedal glyphs
1144
1145 @lilypond[quote]
1146 \include "font-table.ly"
1147 \markuplist \override-lines #'(word-space . 4)
1148             \doc-chars #pedal
1149 @end lilypond
1150
1151
1152 @node Accordion glyphs
1153 @unnumberedsubsec Accordion glyphs
1154
1155 @lilypond[quote]
1156 \include "font-table.ly"
1157 \markuplist \override-lines #'(word-space . 4)
1158             \doc-chars #accordion
1159 @end lilypond
1160
1161
1162 @node Tie glyphs
1163 @unnumberedsubsec Tie glyphs
1164
1165 @lilypond[quote]
1166 \include "font-table.ly"
1167 \markuplist \override-lines #'(word-space . 4)
1168             \doc-chars #ties
1169 @end lilypond
1170
1171
1172 @node Vaticana glyphs
1173 @unnumberedsubsec Vaticana glyphs
1174
1175 @lilypond[quote]
1176 \include "font-table.ly"
1177 \markuplist \override-lines #'(word-space . 4)
1178             \doc-chars #vaticana
1179 @end lilypond
1180
1181
1182 @node Medicaea glyphs
1183 @unnumberedsubsec Medicaea glyphs
1184
1185 @lilypond[quote]
1186 \include "font-table.ly"
1187 \markuplist \override-lines #'(word-space . 4)
1188             \doc-chars #medicaea
1189 @end lilypond
1190
1191
1192 @node Hufnagel glyphs
1193 @unnumberedsubsec Hufnagel glyphs
1194
1195 @lilypond[quote]
1196 \include "font-table.ly"
1197 \markuplist \override-lines #'(word-space . 4)
1198             \doc-chars #hufnagel
1199 @end lilypond
1200
1201
1202 @node Mensural glyphs
1203 @unnumberedsubsec Mensural glyphs
1204
1205 @lilypond[quote]
1206 \include "font-table.ly"
1207 \markuplist \override-lines #'(word-space . 4)
1208             \doc-chars #mensural
1209 @end lilypond
1210
1211
1212 @node Neomensural glyphs
1213 @unnumberedsubsec Neomensural glyphs
1214
1215 @lilypond[quote]
1216 \include "font-table.ly"
1217 \markuplist \override-lines #'(word-space . 4)
1218             \doc-chars #neomensural
1219 @end lilypond
1220
1221
1222 @node Petrucci glyphs
1223 @unnumberedsubsec Petrucci glyphs
1224
1225 @lilypond[quote]
1226 \include "font-table.ly"
1227 \markuplist \override-lines #'(word-space . 4)
1228             \doc-chars #petrucci
1229 @end lilypond
1230
1231
1232 @node Solesmes glyphs
1233 @unnumberedsubsec Solesmes glyphs
1234
1235 @lilypond[quote]
1236 \include "font-table.ly"
1237 \markuplist \override-lines #'(word-space . 4)
1238             \doc-chars #solesmes
1239 @end lilypond
1240
1241 @node Kievan Notation glyphs
1242 @unnumberedsubsec Kievan Notation glyphs
1243
1244 @lilypond[quote]
1245 \include "font-table.ly"
1246 \markuplist \override-lines #'(word-space . 4)
1247              \doc-chars #kievan
1248 @end lilypond
1249
1250
1251 @node Note head styles
1252 @appendixsec Note head styles
1253
1254 @cindex note head styles
1255 The following styles may be used for note heads.
1256
1257 @lilypondfile[noindent]{note-head-style.ly}
1258
1259
1260 @node Clef styles
1261 @appendixsec Clef styles
1262
1263 The following table shows all the different clef styles possible
1264 (including where @emph{middle C} sits relative to the clef).
1265
1266 @multitable @columnfractions .30 .2 .30 .2
1267
1268 @headitem
1269 Example
1270 @tab
1271 Output
1272 @tab
1273 Example
1274 @tab
1275 Output
1276
1277
1278 @item
1279 @code{\clef G}
1280 @tab
1281 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1282 \clef G c1
1283 @end lilypond
1284
1285 @tab
1286 @code{\clef "G2"}
1287 @tab
1288 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1289 \clef "G2"
1290 c1
1291 @end lilypond
1292
1293 @item
1294 @code{\clef treble}
1295 @tab
1296 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1297 \clef treble
1298 c1
1299 @end lilypond
1300
1301 @tab
1302 @code{\clef violin}
1303 @tab
1304 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1305 \clef violin
1306 c1
1307 @end lilypond
1308
1309 @item
1310 @code{\clef french}
1311 @tab
1312 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1313 \clef french
1314 c1
1315 @end lilypond
1316
1317 @tab
1318 @code{\clef GG}
1319 @tab
1320 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1321 \clef GG
1322 c1
1323 @end lilypond
1324
1325 @item
1326 @code{\clef tenorG}
1327 @tab
1328 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1329 \clef tenorG
1330 c1
1331 @end lilypond
1332
1333 @tab
1334 @code{\clef soprano}
1335 @tab
1336 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1337 \clef soprano
1338 c1
1339 @end lilypond
1340
1341 @item
1342 @code{\clef mezzosoprano}
1343 @tab
1344 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1345 \clef mezzosoprano
1346 c1
1347 @end lilypond
1348
1349 @tab
1350 @code{\clef C}
1351 @tab
1352 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1353 \clef C
1354 c1
1355 @end lilypond
1356
1357 @item
1358 @code{\clef alto}
1359 @tab
1360 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1361 \clef alto
1362 c1
1363 @end lilypond
1364
1365 @tab
1366 @code{\clef tenor}
1367 @tab
1368 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1369 \clef tenor
1370 c1
1371 @end lilypond
1372
1373 @item
1374 @code{\clef baritone}
1375 @tab
1376 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1377 \clef baritone
1378 c1
1379 @end lilypond
1380
1381 @tab
1382 @code{\clef varC}
1383 @tab
1384 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1385 \clef varC
1386 c1
1387 @end lilypond
1388
1389 @item
1390 @code{\clef altovarC}
1391 @tab
1392 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1393 \clef altovarC
1394 c1
1395 @end lilypond
1396
1397 @tab
1398 @code{\clef tenorvarC}
1399 @tab
1400 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1401 \clef tenorvarC
1402 c1
1403 @end lilypond
1404
1405 @item
1406 @code{\clef baritonevarC}
1407 @tab
1408 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1409 \clef baritonevarC
1410 c1
1411 @end lilypond
1412
1413 @tab
1414 @code{\clef varbaritone}
1415 @tab
1416 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1417 \clef varbaritone
1418 c1
1419 @end lilypond
1420
1421 @item
1422 @code{\clef baritonevarF}
1423 @tab
1424 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1425 \clef baritonevarF
1426 c1
1427 @end lilypond
1428
1429 @tab
1430 @code{\clef F}
1431 @tab
1432 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1433 \clef F
1434 c1
1435 @end lilypond
1436
1437 @item
1438 @code{\clef bass}
1439 @tab
1440 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1441 \clef bass
1442 c1
1443 @end lilypond
1444
1445 @tab
1446 @code{\clef subbass}
1447 @tab
1448 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1449 \clef subbass
1450 c1
1451 @end lilypond
1452
1453 @item
1454 @code{\clef percussion}
1455 @tab
1456 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1457 \clef percussion
1458 c1
1459 @end lilypond
1460
1461 @tab
1462 @c @example does not work as expected within multitables
1463 @code{
1464 \new TabStaff @{ @*
1465 @ @ \clef tab @*
1466 @}
1467 }
1468 @tab
1469 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1470 \new TabStaff {
1471   \clef tab
1472   c1
1473 }
1474 @end lilypond
1475
1476 @item
1477 @c @example does not work as expected within multitables
1478 @code{
1479 \new TabStaff @{ @*
1480 @ @ \clef moderntab @*
1481 @}
1482 }
1483 @tab
1484 @lilypond[line-width=3\cm,notime,ragged-right,relative=1]
1485 \new TabStaff {
1486   \clef moderntab
1487   c1
1488 }
1489 @end lilypond
1490
1491
1492 @end multitable
1493
1494
1495 @node Text markup commands
1496 @appendixsec Text markup commands
1497
1498 @ignore
1499 All the .tely files included in this appendix are automatically
1500 generated from source files during the build.
1501 For translators: you cannot translate the content of these files.
1502 @end ignore
1503
1504 @include markup-commands.tely
1505
1506
1507 @node Text markup list commands
1508 @appendixsec Text markup list commands
1509
1510 The following commands can all be used with @code{\markuplist}:
1511
1512 @include markup-list-commands.tely
1513
1514
1515 @node List of special characters
1516 @appendixsec List of special characters
1517
1518 The following special characters references can be used;
1519 for more details, see @ref{ASCII aliases}.
1520
1521 The HTML syntax is used and most of these references are the same as HTML.
1522 The rest of them are inspired by @LaTeX{}.
1523
1524 The characters are boxed so that you can see their size.
1525 A small padding has been added between the character and the box
1526 for more readability.
1527
1528 @lilypond[quote]
1529 \include "special-characters.ly"
1530 @end lilypond
1531
1532
1533 @node List of articulations
1534 @appendixsec List of articulations
1535
1536
1537 The following lists show all the scripts in the Feta font that may be
1538 attached to notes (eg. @samp{f\accent} or @samp{f->}).  Each example
1539 shows the script in the @emph{up}, @emph{down} and @emph{neutral}
1540 positions respectively.
1541
1542 @c Articulations and ornamentations
1543 @c Fingering instructions (for "thumb")
1544 @c Common notation for unfretted strings
1545 @c   Bowing indications
1546 @c   Harmonics
1547 @c   Snap (Bartók) pizzicato
1548 @c Custom percussion staves (for "halfopen" -- not yet funindexed)
1549 @c References for wind instruments (for "open"/"stopped" -- not yet funindexed)
1550
1551
1552 @menu
1553 * Articulation scripts::
1554 * Ornament scripts::
1555 * Fermata scripts::
1556 * Instrument-specific scripts::
1557 * Repeat sign scripts::
1558 * Ancient scripts::
1559 @end menu
1560
1561 @ignore
1562 The @multitable @columnfraction value discrepancy between the first and
1563 the remaining columns is deliberate; it seems (at least visually
1564 anyway) the gap (after building the documentation) between first and
1565 second column examples was always larger than between the remaining
1566 columns - JL
1567 @end ignore
1568
1569 @cindex accent
1570 @cindex espressivo
1571 @cindex marcato
1572 @cindex portato
1573 @cindex staccatissimo
1574 @cindex staccato
1575 @cindex tenuto
1576 @cindex thumb
1577
1578 @node Articulation scripts
1579 @unnumberedsubsec Articulation scripts
1580
1581 @multitable @columnfractions .22 .25 .25 .25
1582
1583 @item
1584 @code{\accent} or @code{->}
1585 @lilypond[notime,relative=2]
1586 f^\accent e,_\accent b'\accent
1587 @end lilypond
1588 @tab
1589 @code{\espressivo}
1590 @lilypond[notime,relative=2]
1591 f^\espressivo e,_\espressivo b'\espressivo
1592 @end lilypond
1593 @tab
1594 @code{\marcato} or @code{-^}
1595 @lilypond[notime,relative=2]
1596 f^\marcato e,_\marcato b'\marcato
1597 @end lilypond
1598 @tab
1599 @code{\portato} or @code{-_}
1600 @lilypond[notime,relative=2]
1601 f^\portato e,_\portato b'\portato
1602 @end lilypond
1603
1604 @item
1605 @code{\staccatissimo} @* or @code{-!}
1606 @lilypond[notime,relative=2]
1607 f^\staccatissimo e,_\staccatissimo b'\staccatissimo
1608 @end lilypond
1609 @tab
1610 @code{\staccato} or @code{-.}
1611 @lilypond[notime,relative=2]
1612 f^\staccato e,_\staccato b'\staccato
1613 @end lilypond
1614 @tab
1615 @code{\tenuto} or @code{--}
1616 @lilypond[notime,relative=2]
1617 f^\tenuto e,_\tenuto b'\tenuto
1618 @end lilypond
1619
1620 @end multitable
1621
1622 @cindex prall
1623 @cindex prallup
1624 @cindex pralldown
1625 @cindex upprall
1626 @cindex downprall
1627 @cindex prallprall
1628 @cindex lineprall
1629 @cindex prallmordent
1630 @cindex mordent
1631 @cindex upmordent
1632 @cindex downmordent
1633 @cindex trill
1634 @cindex turn
1635 @cindex reverseturn
1636
1637 @node Ornament scripts
1638 @unnumberedsubsec Ornament scripts
1639
1640 @multitable @columnfractions .22 .25 .25 .25
1641
1642 @item
1643 @code{\prall}
1644 @lilypond[notime,relative=2]
1645 f^\prall e,_\prall b'\prall
1646 @end lilypond
1647 @tab
1648 @code{\prallup}
1649 @lilypond[notime,relative=2]
1650 f^\prallup e,_\prallup b'\prallup
1651 @end lilypond
1652 @tab
1653 @code{\pralldown}
1654 @lilypond[notime,relative=2]
1655 f^\pralldown e,_\pralldown b'\pralldown
1656 @end lilypond
1657 @tab
1658 @code{\upprall}
1659 @lilypond[notime,relative=2]
1660 f^\upprall e,_\upprall b'\upprall
1661 @end lilypond
1662
1663 @item
1664 @code{\downprall}
1665 @lilypond[notime,relative=2]
1666 f^\downprall e,_\downprall b'\downprall
1667 @end lilypond
1668 @tab
1669 @code{\prallprall}
1670 @lilypond[notime,relative=2]
1671 f^\prallprall e,_\prallprall b'\prallprall
1672 @end lilypond
1673 @tab
1674 @code{\lineprall}
1675 @lilypond[notime,relative=2]
1676 f^\lineprall e,_\lineprall b'\lineprall
1677 @end lilypond
1678 @tab
1679 @code{\prallmordent}
1680 @lilypond[notime,relative=2]
1681 f^\prallmordent e,_\prallmordent b'\prallmordent
1682 @end lilypond
1683
1684 @item
1685 @code{\mordent}
1686 @lilypond[notime,relative=2]
1687 f^\mordent e,_\mordent b'\mordent
1688 @end lilypond
1689 @tab
1690 @code{\upmordent}
1691 @lilypond[notime,relative=2]
1692 f^\upmordent e,_\upmordent b'\upmordent
1693 @end lilypond
1694 @tab
1695 @code{\downmordent}
1696 @lilypond[notime,relative=2]
1697 f^\downmordent e,_\downmordent b'\downmordent
1698 @end lilypond
1699 @tab
1700 @code{\trill}
1701 @lilypond[notime,relative=2]
1702 f^\trill e,_\trill b'\trill
1703 @end lilypond
1704
1705 @item
1706 @code{\turn}
1707 @lilypond[notime,relative=2]
1708 f^\turn e,_\turn b'\reverseturn
1709 @end lilypond
1710 @tab
1711 @code{\reverseturn}
1712 @lilypond[notime,relative=2]
1713 f^\reverseturn e,_\reverseturn b'\reverseturn
1714 @end lilypond
1715
1716 @end multitable
1717
1718 @cindex fermata
1719 @cindex shortfermata
1720 @cindex longfermata
1721 @cindex verylongfermata
1722
1723 @node Fermata scripts
1724 @unnumberedsubsec Fermata scripts
1725
1726 @multitable @columnfractions .22 .25 .25 .25
1727
1728 @item
1729 @code{\shortfermata}
1730 @lilypond[notime,relative=2]
1731 f^\shortfermata e,_\shortfermata b'\shortfermata
1732 @end lilypond
1733 @tab
1734 @code{\fermata}
1735 @lilypond[notime,relative=2]
1736 f^\fermata e,_\fermata b'\fermata
1737 @end lilypond
1738 @tab
1739 @code{\longfermata}
1740 @lilypond[notime,relative=2]
1741 f^\longfermata e,_\longfermata b'\longfermata
1742 @end lilypond
1743 @tab
1744 @code{\verylongfermata}
1745 @lilypond[notime,relative=2]
1746 f^\verylongfermata e,_\verylongfermata b'\verylongfermata
1747 @end lilypond
1748
1749 @end multitable
1750
1751 @cindex upbow
1752 @cindex downbow
1753 @cindex flageolet
1754 @cindex open
1755 @cindex halfopen
1756 @cindex lheel
1757 @cindex rheel
1758 @cindex ltoe
1759 @cindex rtoe
1760 @cindex snappizzicato
1761 @cindex stopped
1762
1763 @node Instrument-specific scripts
1764 @unnumberedsubsec Instrument-specific scripts
1765
1766 @multitable @columnfractions .22 .25 .25 .25
1767
1768 @item
1769 @code{\upbow}
1770 @lilypond[notime,relative=2]
1771 f^\upbow e,_\upbow b'\upbow
1772 @end lilypond
1773 @tab
1774 @code{\downbow}
1775 @lilypond[notime,relative=2]
1776 f^\downbow e,_\downbow b'\downbow
1777 @end lilypond
1778 @tab
1779 @code{\flageolet}
1780 @lilypond[notime,relative=2]
1781 f^\flageolet e,_\flageolet b'\flageolet
1782 @end lilypond
1783 @tab
1784 @code{\open}
1785 @lilypond[notime,relative=2]
1786 f^\open e,_\open b'\open
1787 @end lilypond
1788
1789 @item
1790 @code{\halfopen}
1791 @lilypond[notime,relative=2]
1792 f^\halfopen e,_\halfopen b'\halfopen
1793 @end lilypond
1794 @tab
1795 @code{\lheel}
1796 @lilypond[notime,relative=2]
1797 f^\lheel e,_\lheel b'\lheel
1798 @end lilypond
1799 @tab
1800 @code{\rheel}
1801 @lilypond[notime,relative=2]
1802 f^\rheel e,_\rheel b'\rheel
1803 @end lilypond
1804 @tab
1805 @code{\ltoe}
1806 @lilypond[notime,relative=2]
1807 f^\ltoe e,_\ltoe b'\ltoe
1808 @end lilypond
1809
1810 @item
1811 @code{\rtoe}
1812 @lilypond[notime,relative=2]
1813 f^\rtoe e,_\rtoe b'\rtoe
1814 @end lilypond
1815 @tab
1816 @code{\snappizzicato}
1817 @lilypond[notime,relative=2]
1818 f^\snappizzicato e,_\snappizzicato b'\snappizzicato
1819 @end lilypond
1820 @tab
1821 @code{\stopped} or @code{-+}
1822 @lilypond[notime,relative=2]
1823 f^\stopped e,_\stopped b'\stopped
1824 @end lilypond
1825
1826 @end multitable
1827
1828 @cindex segno
1829 @cindex coda
1830 @cindex varcoda
1831
1832 @node Repeat sign scripts
1833 @unnumberedsubsec Repeat sign scripts
1834
1835 @multitable @columnfractions .22 .25 .25 .25
1836
1837 @item
1838 @code{\segno}
1839 @lilypond[notime,relative=2]
1840 f^\segno e,_\segno b'\segno
1841 @end lilypond
1842 @tab
1843 @code{\coda}
1844 @lilypond[notime,relative=2]
1845 f^\coda e,_\coda b'\coda
1846 @end lilypond
1847 @tab
1848 @code{\varcoda}
1849 @lilypond[notime,relative=2]
1850 f^\varcoda e,_\varcoda b'\varcoda
1851 @end lilypond
1852
1853 @end multitable
1854
1855 @cindex accentus
1856 @cindex circulus
1857 @cindex ictus
1858 @cindex semicirculus
1859 @cindex signumcongruentiae
1860
1861 @node Ancient scripts
1862 @unnumberedsubsec Ancient scripts
1863
1864 @multitable @columnfractions .22 .25 .25 .25
1865
1866 @item
1867 @code{\accentus}
1868 @lilypond[notime]
1869 \include "gregorian.ly"
1870 \new VaticanaStaff { e'^\accentus s4 f_\accentus s4 b\accentus}
1871 @end lilypond
1872 @tab
1873 @code{\circulus}
1874 @lilypond[notime]
1875 \include "gregorian.ly"
1876 \new VaticanaStaff { e'^\circulus s4 f_\circulus s4 b\circulus  }
1877 @end lilypond
1878 @tab
1879 @code{\ictus}
1880 @lilypond[notime]
1881 \include "gregorian.ly"
1882 \new VaticanaStaff { e'^\ictus s4 f_\ictus s4 b\ictus}
1883 @end lilypond
1884
1885 @item
1886 @code{\semicirculus}
1887 @lilypond[notime]
1888 \include "gregorian.ly"
1889 \new VaticanaStaff {
1890   e'^\semicirculus s4 f_\semicirculus s4 b\semicirculus
1891 }
1892 @end lilypond
1893 @tab
1894 @code{\signumcongruentiae}
1895 @lilypond[notime]
1896 \include "gregorian.ly"
1897 \new VaticanaStaff {
1898   e'^\signumcongruentiae s4
1899   f_\signumcongruentiae s4
1900   b\signumcongruentiae
1901 }
1902 @end lilypond
1903
1904 @end multitable
1905
1906 @cindex drums, various
1907 @cindex acoustic bass
1908 @cindex bass
1909 @cindex snare
1910 @cindex electric snare
1911 @cindex acoustic snare
1912 @cindex tom tom
1913 @cindex bongo
1914 @cindex conga
1915 @cindex timbale
1916 @cindex sidestick
1917 @cindex floor tom tom
1918 @cindex low tom tom
1919 @cindex high tom tom
1920 @cindex mid tom tom
1921 @cindex high hat
1922 @cindex pedal high hat
1923 @cindex open high hat
1924 @cindex half-open high hat
1925 @cindex cymbal, various
1926 @cindex crash cymbal
1927 @cindex ride cymbal
1928 @cindex chinese cymbal
1929 @cindex splash cymbal
1930 @cindex ride bell
1931 @cindex cowbell
1932 @cindex agogo
1933 @cindex high bongo
1934 @cindex low bongo
1935 @cindex mute bongo
1936 @cindex open bongo
1937 @cindex high conga
1938 @cindex low conga
1939 @cindex mute conga
1940 @cindex open conga
1941 @cindex high timbale
1942 @cindex low timbale
1943 @cindex mute timbale
1944 @cindex open timbale
1945 @cindex sidestick
1946 @cindex guiro
1947 @cindex cabasa
1948 @cindex maracas
1949 @cindex whistle
1950 @cindex handclap
1951 @cindex tambourine
1952 @cindex vibraslap
1953 @cindex tam tam
1954 @cindex claves
1955 @cindex woodblock
1956 @cindex cuica
1957 @cindex triangle
1958
1959 @node Percussion notes
1960 @appendixsec Percussion notes
1961
1962 @multitable @columnfractions .22 .25 .25 .25
1963
1964 @item
1965 @code{bassdrum @* bd @*}
1966 @lilypond[notime,ragged-right]
1967 \drums { bd4 bd1 }
1968 @end lilypond
1969 @tab
1970 @code{acousticbassdrum @* bda @*}
1971 @lilypond[notime,ragged-right]
1972 \drums { bda4 bda1 }
1973 @end lilypond
1974 @tab
1975 @code{snare @* sn @*}
1976 @lilypond[notime,ragged-right]
1977 \drums { sn4 sn1 }
1978 @end lilypond
1979 @tab
1980 @code{acousticsnare @* sna @*}
1981 @lilypond[notime,ragged-right]
1982 \drums { sna4 sna1 }
1983 @end lilypond
1984
1985 @item
1986 @code{electricsnare @* sne @*}
1987 @lilypond[notime,ragged-right]
1988 \drums { sne4 sne1 }
1989 @end lilypond
1990 @tab
1991 @code{lowfloortom @* tomfl @*}
1992 @lilypond[notime,ragged-right]
1993 \drums { tomfl4 tomfl1 }
1994 @end lilypond
1995 @tab
1996 @code{highfloortom @* tomfh @*}
1997 @lilypond[notime,ragged-right]
1998 \drums { tomfh4 tomfh1 }
1999 @end lilypond
2000 @tab
2001 @code{lowtom @* toml @*}
2002 @lilypond[notime,ragged-right]
2003 \drums { toml4 toml1 }
2004 @end lilypond
2005
2006 @item
2007 @code{hightom @* tomh @*}
2008 @lilypond[notime,ragged-right]
2009 \drums { tomh4 tomh1 }
2010 @end lilypond
2011 @tab
2012 @code{lowmidtom @* tomml @*}
2013 @lilypond[notime,ragged-right]
2014 \drums { tomml4 tomml1 }
2015 @end lilypond
2016 @tab
2017 @code{highmidtom @* tommh @*}
2018 @lilypond[notime,ragged-right]
2019 \drums { tommh4 tommh1 }
2020 @end lilypond
2021 @tab
2022 @code{highhat @* hh @*}
2023 @lilypond[notime,ragged-right]
2024 \drums { hh4 hh1 }
2025 @end lilypond
2026
2027 @item
2028 @code{closedhihat @* hhc @*}
2029 @lilypond[notime,ragged-right]
2030 \drums { hhc4 hhc1 }
2031 @end lilypond
2032 @tab
2033 @code{openhighhat @* hho @*}
2034 @lilypond[notime,ragged-right]
2035 \drums { hho4 hho1 }
2036 @end lilypond
2037 @tab
2038 @code{halfopenhihat @* hhho @*}
2039 @lilypond[notime,ragged-right]
2040 \drums { hhho4 hhho1 }
2041 @end lilypond
2042 @tab
2043 @code{pedalhihat @* hhp @*}
2044 @lilypond[notime,ragged-right]
2045 \drums { hhp4 hhp1 }
2046 @end lilypond
2047
2048
2049 @item
2050 @code{crashcymbal @* cymc @*}
2051 @lilypond[notime,ragged-right]
2052 \drums { cymc4 cymc1 }
2053 @end lilypond
2054 @tab
2055 @code{crashcymbala @* cymca @*}
2056 @lilypond[notime,ragged-right]
2057 \drums { cymca4 cymca1 }
2058 @end lilypond
2059 @tab
2060 @code{crashcymbalb @* cymcb @*}
2061 @lilypond[notime,ragged-right]
2062 \drums { cymcb4 cymcb1 }
2063 @end lilypond
2064 @tab
2065 @code{ridecymbal @* cymr @*}
2066 @lilypond[notime,ragged-right]
2067 \drums { cymr4 cymr1 }
2068 @end lilypond
2069
2070 @item
2071 @code{ridecymbala @* cymra @*}
2072 @lilypond[notime,ragged-right]
2073 \drums { cymra4 cymra1 }
2074 @end lilypond
2075 @tab
2076 @code{ridecymbalb @* cymrb @*}
2077 @lilypond[notime,ragged-right]
2078 \drums { cymrb4 cymrb1 }
2079 @end lilypond
2080 @tab
2081 @code{chinesecymbal @* cymch @*}
2082 @lilypond[notime,ragged-right]
2083 \drums { cymch4 cymch1 }
2084 @end lilypond
2085 @tab
2086 @code{splashcymbal @* cyms @*}
2087 @lilypond[notime,ragged-right]
2088 \drums { cyms4 cyms1 }
2089 @end lilypond
2090
2091 @item
2092 @code{ridebell @* rb @*}
2093 @lilypond[notime,ragged-right]
2094 \drums { rb4 rb1 }
2095 @end lilypond
2096 @tab
2097 @code{cowbell @* cb @*}
2098 @lilypond[notime,ragged-right]
2099 \drums { cb4 cb1 }
2100 @end lilypond
2101 @tab
2102 @code{hibongo @* boh @*}
2103 @lilypond[notime,ragged-right]
2104 \drums { boh4 boh1 }
2105 @end lilypond
2106 @tab
2107 @code{openhibongo @* boho @*}
2108 @lilypond[notime,ragged-right]
2109 \drums { boho4 boho1 }
2110 @end lilypond
2111
2112 @item
2113 @code{mutehibongo @* bohm @*}
2114 @lilypond[notime,ragged-right]
2115 \drums { bohm4 bohm1 }
2116 @end lilypond
2117 @tab
2118 @code{lobongo @* bol @*}
2119 @lilypond[notime,ragged-right]
2120 \drums { bol4 bol1 }
2121 @end lilypond
2122 @tab
2123 @code{openlobongo @* bolo @*}
2124 @lilypond[notime,ragged-right]
2125 \drums { bolo4 bolo1 }
2126 @end lilypond
2127 @tab
2128 @code{mutelobongo @* bolm @*}
2129 @lilypond[notime,ragged-right]
2130 \drums { bolm4 bolm1 }
2131 @end lilypond
2132
2133
2134 @item
2135 @code{hiconga @* cgh @*}
2136 @lilypond[notime,ragged-right]
2137 \drums { cgh4 cgh1 }
2138 @end lilypond
2139 @tab
2140 @code{openhiconga @* cgho @*}
2141 @lilypond[notime,ragged-right]
2142 \drums { cgho4 cgho1 }
2143 @end lilypond
2144 @tab
2145 @code{mutehiconga @* cghm @*}
2146 @lilypond[notime,ragged-right]
2147 \drums { cghm4 cghm1 }
2148 @end lilypond
2149 @tab
2150 @code{loconga @* cgl @*}
2151 @lilypond[notime,ragged-right]
2152 \drums { cgl4 cgl1 }
2153 @end lilypond
2154
2155 @item
2156 @code{openloconga @* cglo @*}
2157 @lilypond[notime,ragged-right]
2158 \drums { cglo4 cglo1 }
2159 @end lilypond
2160 @tab
2161 @code{muteloconga @* cglm @*}
2162 @lilypond[notime,ragged-right]
2163 \drums { cglm4 cglm1 }
2164 @end lilypond
2165 @tab
2166 @code{hitimbale @* timh @*}
2167 @lilypond[notime,ragged-right]
2168 \drums { timh4 timh1 }
2169 @end lilypond
2170 @tab
2171 @code{lotimbale @* timl @*}
2172 @lilypond[notime,ragged-right]
2173 \drums { timl4 timl1 }
2174 @end lilypond
2175
2176 @item
2177 @code{hiagogo @* agh @*}
2178 @lilypond[notime,ragged-right]
2179 \drums { agh4 agh1 }
2180 @end lilypond
2181 @tab
2182 @code{loagogo @* agl @*}
2183 @lilypond[notime,ragged-right]
2184 \drums { agl4 agl1 }
2185 @end lilypond
2186 @tab
2187 @code{sidestick @* ss @*}
2188 @lilypond[notime,ragged-right]
2189 \drums { ss4 ss1 }
2190 @end lilypond
2191 @tab
2192 @code{hisidestick @* ssh @*}
2193 @lilypond[notime,ragged-right]
2194 \drums { ssh4 ssh1 }
2195 @end lilypond
2196
2197 @item
2198 @code{losidestick @* ssl @*}
2199 @lilypond[notime,ragged-right]
2200 \drums { ssl4 ssl1 }
2201 @end lilypond
2202 @tab
2203 @code{guiro @* gui @*}
2204 @lilypond[notime,ragged-right]
2205 \drums { gui4 gui1 }
2206 @end lilypond
2207 @tab
2208 @code{shortguiro @* guis @*}
2209 @lilypond[notime,ragged-right]
2210 \drums { guis4 guis1 }
2211 @end lilypond
2212 @tab
2213 @code{longguiro @* guil @*}
2214 @lilypond[notime,ragged-right]
2215 \drums { guil4 guil1 }
2216 @end lilypond
2217
2218 @item
2219 @code{cabasa @* cab @*}
2220 @lilypond[notime,ragged-right]
2221 \drums { cab4 cab1 }
2222 @end lilypond
2223 @tab
2224 @code{maracas @* mar @*}
2225 @lilypond[notime,ragged-right]
2226 \drums { mar4 mar1 }
2227 @end lilypond
2228 @tab
2229 @code{shortwhistle @* whs @*}
2230 @lilypond[notime,ragged-right]
2231 \drums { whs4 whs1 }
2232 @end lilypond
2233 @tab
2234 @code{longwhistle @* whl @*}
2235 @lilypond[notime,ragged-right]
2236 \drums { whl4 whl1 }
2237 @end lilypond
2238
2239 @item
2240 @code{handclap @* hc @*}
2241 @lilypond[notime,ragged-right]
2242 \drums { hc4 hc1 }
2243 @end lilypond
2244 @tab
2245 @code{tambourine @* tamb @*}
2246 @lilypond[notime,ragged-right]
2247 \drums { tamb4 tamb1 }
2248 @end lilypond
2249 @tab
2250 @code{vibraslap @* vibs @*}
2251 @lilypond[notime,ragged-right]
2252 \drums { vibs4 vibs1 }
2253 @end lilypond
2254 @tab
2255 @code{tamtam @* tt @*}
2256 @lilypond[notime,ragged-right]
2257 \drums { tt4 tt1 }
2258 @end lilypond
2259
2260 @item
2261 @code{claves @* cl @*}
2262 @lilypond[notime,ragged-right]
2263 \drums { cl4 cl1 }
2264 @end lilypond
2265 @tab
2266 @code{hiwoodblock @* wbh @*}
2267 @lilypond[notime,ragged-right]
2268 \drums { wbh4 wbh1 }
2269 @end lilypond
2270 @tab
2271 @code{lowoodblock @* wbl @*}
2272 @lilypond[notime,ragged-right]
2273 \drums { wbl4 wbl1 }
2274 @end lilypond
2275 @tab
2276 @code{opencuica @* cuio @*}
2277 @lilypond[notime,ragged-right]
2278 \drums { cuio4 cuio1 }
2279 @end lilypond
2280
2281 @item
2282 @code{mutecuica @* cuim @*}
2283 @lilypond[notime,ragged-right]
2284 \drums { cuim4 cuim1 }
2285 @end lilypond
2286 @tab
2287 @code{triangle @* tri @*}
2288 @lilypond[notime,ragged-right]
2289 \drums { tri4 tri1 }
2290 @end lilypond
2291 @tab
2292 @code{opentriangle @* trio @*}
2293 @lilypond[notime,ragged-right]
2294 \drums { trio4 trio1 }
2295 @end lilypond
2296 @tab
2297 @code{mutetriangle @* trim}
2298 @lilypond[notime,ragged-right]
2299 \drums { trim4 trim1 }
2300 @end lilypond
2301
2302 @item
2303 @code{oneup @* ua @*}
2304 @lilypond[notime,ragged-right]
2305 \drums { ua4 ua1 }
2306 @end lilypond
2307 @tab
2308 @code{twoup @* ub @*}
2309 @lilypond[notime,ragged-right]
2310 \drums { ub4 ub1 }
2311 @end lilypond
2312 @tab
2313 @code{threeup @* uc @*}
2314 @lilypond[notime,ragged-right]
2315 \drums { uc4 uc1 }
2316 @end lilypond
2317 @tab
2318 @code{fourup @* ud @*}
2319 @lilypond[notime,ragged-right]
2320 \drums { ud4 ud1 }
2321 @end lilypond
2322
2323 @item
2324 @code{fiveup @* ue @*}
2325 @lilypond[notime,ragged-right]
2326 \drums { ue4 ue1 }
2327 @end lilypond
2328 @tab
2329 @code{onedown @* da @*}
2330 @lilypond[notime,ragged-right]
2331 \drums { da4 da1 }
2332 @end lilypond
2333 @tab
2334 @code{twodown @* db @*}
2335 @lilypond[notime,ragged-right]
2336 \drums { db4 db1 }
2337 @end lilypond
2338 @tab
2339 @code{threedown @* dc @*}
2340 @lilypond[notime,ragged-right]
2341 \drums { dc4 dc1 }
2342 @end lilypond
2343
2344 @item
2345 @code{fourdown @* dd @*}
2346 @lilypond[notime,ragged-right]
2347 \drums { dd4 dd1 }
2348 @end lilypond
2349 @tab
2350 @code{fivedown @* de @*}
2351 @lilypond[notime,ragged-right]
2352 \drums { de4 de1 }
2353 @end lilypond
2354
2355
2356 @end multitable
2357
2358
2359 @node Technical glossary
2360 @appendixsec Technical glossary
2361
2362 A glossary of the technical terms and concepts used internally in
2363 LilyPond.  These terms may appear in the manuals, on mailing lists
2364 or in the source code.
2365
2366 @menu
2367 * alist::
2368 * callback::
2369 * closure::
2370 * glyph::
2371 * grob::
2372 * immutable::
2373 * interface::
2374 * lexer::
2375 * mutable::
2376 * output-def::
2377 * parser::
2378 * parser variable::
2379 * prob::
2380 * smob::
2381 * stencil::
2382 @end menu
2383
2384 @node alist
2385 @unnumberedsubsec alist
2386
2387 @cindex alist
2388 @cindex association list
2389
2390 An association list or @strong{alist} for short is a Scheme pair
2391 which associates a value with a key: @w{@code{(key . value)}}.  For
2392 example, in @file{scm/lily.scm}, the alist
2393 @w{@qq{type-p-name-alist}} associates certain type predicates
2394 (e.g., @code{ly:music?}) with names (e.g., @qq{music}) so
2395 that type-check failures can be reported with a console message that
2396 includes the name of the expected type predicate.
2397
2398 @node callback
2399 @unnumberedsubsec callback
2400
2401 @cindex callback
2402
2403 A @strong{callback} is a routine, function or method whose reference is
2404 passed as an argument in a call to another routine, so allowing
2405 the called routine to invoke it.  The technique enables a lower-
2406 level software layer to call a function defined in a higher
2407 layer.  Callbacks are used extensively in LilyPond to permit
2408 user-level Scheme code to define how many low-level actions are
2409 performed.
2410
2411
2412 @node closure
2413 @unnumberedsubsec closure
2414
2415 @cindex closure
2416
2417 In Scheme, a @strong{closure} is created when a function, usually
2418 a lambda expression, is passed as a variable.  The closure contains
2419 the function's code plus references to the lexical bindings of the
2420 function's free variables (i.e., those variables used in the
2421 expression but defined outside it).  When this function is applied
2422 to different arguments later, the free variable bindings that were
2423 captured in the closure are used to obtain the values of the free
2424 variables to be used in the calculation.  One useful property of
2425 closures is the retention of internal variable values between
2426 invocations, so permitting state to be maintained.
2427
2428
2429 @node glyph
2430 @unnumberedsubsec glyph
2431
2432 @cindex glyph
2433 @cindex font
2434 @cindex typeface
2435
2436 A @strong{glyph} is a particular graphical representation of a typographic
2437 character, or a combination of two characters formating a ligature.
2438 A set of glyphs with a single style and shape comprise a font, and
2439 a set of fonts covering several styles and sizes comprise a typeface.
2440
2441 @seealso
2442 Notation Reference:
2443 @ref{Fonts},
2444 @ref{Special characters}.
2445
2446
2447 @node grob
2448 @unnumberedsubsec grob
2449
2450 @cindex grob
2451 @cindex layout objects
2452 @cindex graphical objects
2453
2454 LilyPond objects which represent items of notation in the printed
2455 output such as note heads, stems, slurs, ties, fingering, clefs,
2456 etc are called @q{Layout objects}, often known as @q{GRaphical
2457 OBjects}, or @strong{grobs} for short.  They are represented by
2458 instances of the @code{Grob} class.
2459
2460 @seealso
2461 Learning Manual:
2462 @rlearning{Objects and interfaces},
2463 @rlearning{Naming conventions of objects and properties},
2464 @rlearning{Properties of layout objects}.
2465
2466 Internals Reference:
2467 @rinternals{grob-interface},
2468 @rinternals{All layout objects}.
2469
2470
2471 @node immutable
2472 @unnumberedsubsec immutable
2473
2474 @cindex immutable objects
2475 @cindex immutable properties
2476 @cindex shared properties
2477
2478 An @strong{immutable} object is one whose state cannot be modified
2479 after creation, in contrast to a mutable object, which can be
2480 modified after creation.
2481
2482 In LilyPond, immutable or shared properties define the default
2483 style and behavior of grobs.  They are shared between many objects.
2484 In apparent contradiction to the name, they can be changed using
2485 @code{\override} and @code{\revert}.
2486
2487 @seealso
2488 Notation Reference:
2489 @ref{mutable}.
2490
2491
2492 @node interface
2493 @unnumberedsubsec interface
2494
2495 @cindex interface
2496 @cindex grob-interface
2497 @cindex graphical object interfaces
2498
2499 Actions and properties which are common to a number of grobs are
2500 grouped together in an object called a @code{grob-interface}, or
2501 just @q{interface} for short.
2502
2503 @seealso
2504 Learning Manual:
2505 @rlearning{Objects and interfaces},
2506 @rlearning{Naming conventions of objects and properties},
2507 @rlearning{Properties found in interfaces}.
2508
2509 Notation Reference:
2510 @ref{Layout interfaces}.
2511
2512 Internals Reference:
2513 @rinternals{Graphical Object Interfaces}.
2514
2515
2516 @node lexer
2517 @unnumberedsubsec lexer
2518
2519 @cindex lexer
2520 @cindex Flex
2521
2522 A @strong{lexer} is a program which converts a sequence of
2523 characters into a sequence of tokens, a process called lexical
2524 analysis.  The LilyPond lexer converts the stream obtained from an
2525 input @file{.ly} file into a tokenized stream more suited to the
2526 next stage of processing - parsing, for which see @ref{parser}.
2527 The LilyPond lexer is built with Flex from the lexer file
2528 @file{lily/lexer.ll} which contains the lexical rules.  This file
2529 is part of the source code and is not included in the LilyPond
2530 binary installation.
2531
2532
2533 @node mutable
2534 @unnumberedsubsec mutable
2535
2536 @cindex mutable objects
2537 @cindex mutable properties
2538
2539 A @strong{mutable} object is one whose state can be modified after
2540 creation, in contrast to an immutable object, whose state is fixed
2541 at the time of creation.
2542
2543 In LilyPond, mutable properties contain values that are specific to
2544 one grob.  Typically, lists of other objects or results from
2545 computations are stored in mutable properties.
2546
2547 @seealso
2548 Notation Reference:
2549 @ref{immutable}.
2550
2551
2552 @node output-def
2553 @unnumberedsubsec output-def
2554
2555 @cindex output-def
2556
2557 An instance of the @code{Output-def} class contains the methods and
2558 data structures associated with an output block.  Instances are
2559 created for midi, layout and paper blocks.
2560
2561
2562 @node parser
2563 @unnumberedsubsec parser
2564
2565 @cindex parser
2566 @cindex Bison
2567 @cindex LilyPond grammar
2568 @cindex grammar for LilyPond
2569 @cindex BNF
2570
2571 A @strong{parser} analyzes the sequence of tokens produced by a
2572 lexer to determine its grammatical structure, grouping the tokens
2573 progressively into larger groupings according to the rules of the
2574 grammar.  If the sequence of tokens is valid the end product is a
2575 tree of tokens whose root is the grammar's start symbol.  If this
2576 cannot be achieved the file is invalid and an appropriate error
2577 message is produced.  The syntactic groupings and the rules for
2578 constructing the groupings from their parts for the LilyPond syntax
2579 are defined in @file{lily/parser.yy} and shown in Backus Normal Form
2580 (BNF) in @rcontrib{LilyPond grammar}.  This file is used to build the
2581 parser during the program build by the parser generator, Bison.  It is
2582 part of the source code and is not included in the LilyPond binary
2583 installation.
2584
2585
2586 @node parser variable
2587 @unnumberedsubsec parser variable
2588
2589 @cindex parser variable
2590 @cindex Scheme variable
2591 @cindex global variable
2592 @cindex afterGraceFraction
2593 @cindex musicQuotes
2594 @cindex mode
2595 @cindex output-count
2596 @cindex output-suffix
2597 @cindex partCombineListener
2598 @cindex pitchnames
2599 @cindex toplevel-bookparts
2600 @cindex toplevel-scores
2601 @cindex showLastLength
2602 @cindex showFirstLength
2603
2604 These are variables defined directly in Scheme.  Their direct
2605 use by users is strongly discouraged, because their scoping
2606 semantics can be confusing.
2607
2608 When the value of such a variable is changed in a @file{.ly} file,
2609 the change is global, and unless explicitly reverted, the new value
2610 will persist to the end of the file, affecting subsequent
2611 @code{\score} blocks as well as external files added with the
2612 @code{\include} command.  This can lead to unintended consequences
2613 and in complex typesetting projects the consequent errors can be
2614 difficult to track down.
2615
2616 LilyPond uses the following parser variables:
2617
2618 @itemize
2619 @item afterGraceFraction
2620 @item musicQuotes
2621 @item mode
2622 @item output-count
2623 @item output-suffix
2624 @item partCombineListener
2625 @item pitchnames
2626 @item toplevel-bookparts
2627 @item toplevel-scores
2628 @item showLastLength
2629 @item showFirstLength
2630 @end itemize
2631
2632
2633 @node prob
2634 @unnumberedsubsec prob
2635
2636 @cindex prob
2637 @cindex property object
2638
2639 PRoperty OBjects, or @strong{probs} for short, are instances of
2640 the @code{Prob} class, a simple base class for objects which have
2641 mutable and immutable property alists and the methods to manipulate
2642 them.  The @code{Music} and @code{Stream_event} classes derive from
2643 @code{Prob}.  Instances of the @code{Prob} class are also created
2644 to hold the formatted content of system grobs and titling blocks
2645 during page layout.
2646
2647
2648 @node smob
2649 @unnumberedsubsec smob
2650
2651 @cindex smob
2652 @cindex Scheme object
2653
2654 @strong{Smobs}, or ScheMe OBjects, are part of the mechanism used
2655 by Guile to export C and C++ objects to Scheme code.  In LilyPond,
2656 smobs are created from C++ objects through macros.  There are two
2657 types of smob objects: simple smobs, intended for simple immutable
2658 objects like numbers, and complex smobs, used for objects with
2659 identities.  If you have access to the LilyPond sources, more
2660 information can be found in @file{lily/includes/smob.hh}.
2661
2662 @node stencil
2663 @unnumberedsubsec stencil
2664
2665 @cindex stencil
2666
2667 An instance of the @strong{stencil} class holds the information
2668 required to print a typographical object.  It is a simple smob
2669 containing a confining box, which defines the vertical and
2670 horizontal extents of the object, and a Scheme expression which
2671 will print the object when evaluated.  Stencils may be combined
2672 to form more complex stencils defined by a tree of Scheme
2673 expressions formed from the Scheme expressions of the component
2674 stencils.
2675
2676 The @code{stencil} property, which connects a grob to its stencil,
2677 is defined in the @code{grob-interface} interface.
2678
2679 @seealso
2680 Internals Reference:
2681 @rinternals{grob-interface}.
2682
2683
2684 @node All context properties
2685 @appendixsec All context properties
2686
2687 @include context-properties.tely
2688
2689
2690 @node Layout properties
2691 @appendixsec Layout properties
2692
2693 @include layout-properties.tely
2694
2695
2696 @node Available music functions
2697 @appendixsec Available music functions
2698
2699 @include identifiers.tely
2700
2701 @node Context modification identifiers
2702 @appendixsec Context modification identifiers
2703
2704 The following commands are defined for use as context modifications
2705 within a @code{\layout} or @code{\with} block.
2706
2707 @include context-mod-identifiers.tely
2708
2709 @node Predefined type predicates
2710 @appendixsec Predefined type predicates
2711
2712 @include type-predicates.tely
2713
2714
2715 @node Scheme functions
2716 @appendixsec Scheme functions
2717
2718 @include scheme-functions.tely