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.14.0"
  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 * MIDI instruments::
  22 * List of colors::
  23 * The Feta font::
  24 * Note head styles::
  25 * Text markup commands::
  26 * Text markup list commands::
  27 * List of articulations::
  28 * Percussion notes::
  29 * Technical glossary::
  30 * All context properties::
  31 * Layout properties::
  32 * Available music functions::
  33 * Context modification identifiers::
  34 * Predefined type predicates::
  35 * Scheme functions::
  36 @end menu
  37
  38
  39
  40 @node Chord name chart
  41 @appendixsec Chord name chart
  42
  43 The following charts shows two standard systems for printing chord
  44 names, along with the pitches they represent.
  45
  46 @lilypondfile{chord-names-jazz.ly}
  47
  48 @node Common chord modifiers
  49 @appendixsec Common chord modifiers
  50
  51 The following table shows chord modifiers that can be used in
  52 @code{\chordmode} to generate standard chord structures.
  53
  54 @multitable @columnfractions .2 .3 .2 .2
  55
  56 @item
  57 @b{Chord type}
  58 @tab
  59 @b{Intervals}
  60 @tab
  61 @b{Modifier(s)}
  62 @tab
  63 @b{Example}
  64
  65
  66 @item
  67 Major
  68 @tab
  69 Major third, perfect fifth
  70 @tab
  71 @code{5} or nothing
  72 @tab
  73 @lilypond[line-width=3\cm,noragged-right, notime]
  74 \chordmode {
  75   c1:5
  76 }
  77 @end lilypond
  78
  79 @item
  80 Minor
  81 @tab
  82 Minor third, perfect fifth
  83 @tab
  84 @code{m} or @code{m5}
  85 @tab
  86 @lilypond[line-width=3\cm,noragged-right, notime]
  87 \chordmode {
  88   c1:m
  89 }
  90 @end lilypond
  91
  92 @item
  93 Augmented
  94 @tab
  95 Major third, augmented fifth
  96 @tab
  97 @code{aug}
  98 @tab
  99 @lilypond[line-width=3\cm,noragged-right, notime]
 100 \chordmode {
 101   c1:aug
 102 }
 103 @end lilypond
 104
 105 @item
 106 Diminished
 107 @tab
 108 Minor third, diminished fifth
 109 @tab
 110 @code{dim}
 111 @tab
 112 @lilypond[line-width=3\cm,noragged-right, notime]
 113 \chordmode {
 114   c1:dim
 115 }
 116 @end lilypond
 117
 118 @item
 119 Dominant seventh
 120 @tab
 121 Major triad, minor seventh
 122 @tab
 123 @code{7}
 124 @tab
 125 @lilypond[line-width=3\cm,noragged-right, notime]
 126 \chordmode {
 127   c1:7
 128 }
 129 @end lilypond
 130
 131 @item
 132 Major seventh
 133 @tab
 134 Major triad, major seventh
 135 @tab
 136 @code{maj7} or @code{maj}
 137 @tab
 138 @lilypond[line-width=3\cm,noragged-right, notime]
 139 \chordmode {
 140   c1:maj7
 141 }
 142 @end lilypond
 143
 144 @item
 145 Minor seventh
 146 @tab
 147 Minor triad, minor seventh
 148 @tab
 149 @code{m7}
 150 @tab
 151 @lilypond[line-width=3\cm,noragged-right, notime]
 152 \chordmode {
 153   c1:m7
 154 }
 155 @end lilypond
 156
 157 @item
 158 Diminished seventh
 159 @tab
 160 Diminished triad, diminished seventh
 161 @tab
 162 @code{dim7}
 163 @tab
 164 @lilypond[line-width=3\cm,noragged-right, notime]
 165 \chordmode {
 166   c1:dim7
 167 }
 168 @end lilypond
 169
 170 @item
 171 Augmented seventh
 172 @tab
 173 Augmented triad, minor seventh
 174 @tab
 175 @code{aug7}
 176 @tab
 177 @lilypond[line-width=3\cm,noragged-right, notime]
 178 \chordmode {
 179   c1:aug7
 180 }
 181 @end lilypond
 182
 183 @item
 184 Half-diminished seventh
 185 @tab
 186 Diminished triad, minor seventh
 187 @tab
 188 @code{m7.5-}
 189 @tab
 190 @lilypond[line-width=3\cm,noragged-right, notime]
 191 \chordmode {
 192   c1:m7.5-
 193 }
 194 @end lilypond
 195
 196 @item
 197 Minor-major seventh
 198 @tab
 199 Minor triad, major seventh
 200 @tab
 201 @code{m7+}
 202 @tab
 203 @lilypond[line-width=3\cm,noragged-right, notime]
 204 \chordmode {
 205   c1:m7+
 206 }
 207 @end lilypond
 208
 209 @item
 210 Major sixth
 211 @tab
 212 Major triad, sixth
 213 @tab
 214 @code{6}
 215 @tab
 216 @lilypond[line-width=3\cm,noragged-right, notime]
 217 \chordmode {
 218   c1:6
 219 }
 220 @end lilypond
 221
 222 @item
 223 Minor sixth
 224 @tab
 225 Minor triad, sixth
 226 @tab
 227 @code{m6}
 228 @tab
 229 @lilypond[line-width=3\cm,noragged-right, notime]
 230 \chordmode {
 231   c1:m6
 232 }
 233 @end lilypond
 234
 235 @item
 236 Dominant ninth
 237 @tab
 238 Dominant seventh, major ninth
 239 @tab
 240 @code{9}
 241 @tab
 242 @lilypond[line-width=3\cm,noragged-right, notime]
 243 \chordmode {
 244   c1:9
 245 }
 246 @end lilypond
 247
 248 @item
 249 Major ninth
 250 @tab
 251 Major seventh, major ninth
 252 @tab
 253 @code{maj9}
 254 @tab
 255 @lilypond[line-width=3\cm,noragged-right, notime]
 256 \chordmode {
 257   c1:maj9
 258 }
 259 @end lilypond
 260
 261 @item
 262 Minor ninth
 263 @tab
 264 Minor seventh, major ninth
 265 @tab
 266 @code{m9}
 267 @tab
 268 @lilypond[line-width=3\cm,noragged-right, notime]
 269 \chordmode {
 270   c1:m9
 271 }
 272 @end lilypond
 273
 274 @item
 275 Dominant eleventh
 276 @tab
 277 Dominant ninth, perfect eleventh
 278 @tab
 279 @code{11}
 280 @tab
 281 @lilypond[line-width=3\cm,noragged-right, notime]
 282 \chordmode {
 283   c1:11
 284 }
 285 @end lilypond
 286
 287 @item
 288 Major eleventh
 289 @tab
 290 Major ninth, perfect eleventh
 291 @tab
 292 @code{maj11}
 293 @tab
 294 @lilypond[line-width=3\cm,noragged-right, notime]
 295 \chordmode {
 296   c1:maj11
 297 }
 298 @end lilypond
 299
 300 @item
 301 Minor eleventh
 302 @tab
 303 Minor ninth, perfect eleventh
 304 @tab
 305 @code{m11}
 306 @tab
 307 @lilypond[line-width=3\cm,noragged-right, notime]
 308 \chordmode {
 309   c1:m11
 310 }
 311 @end lilypond
 312
 313 @item
 314 Dominant thirteenth
 315 @tab
 316 Dominant ninth, major thirteenth
 317 @tab
 318 @code{13}
 319 @tab
 320 @lilypond[line-width=3\cm,noragged-right, notime]
 321 \chordmode {
 322   c1:13
 323 }
 324 @end lilypond
 325
 326 @item
 327 Dominant thirteenth
 328 @tab
 329 Dominant eleventh, major thirteenth
 330 @tab
 331 @code{13.11}
 332 @tab
 333 @lilypond[line-width=3\cm,noragged-right, notime]
 334 \chordmode {
 335   c1:13.11
 336 }
 337 @end lilypond
 338
 339 @item
 340 Major thirteenth
 341 @tab
 342 Major eleventh, major thirteenth
 343 @tab
 344 @code{maj13.11}
 345 @tab
 346 @lilypond[line-width=3\cm,noragged-right, notime]
 347 \chordmode {
 348   c1:maj13.11
 349 }
 350 @end lilypond
 351
 352 @item
 353 Minor thirteenth
 354 @tab
 355 Minor eleventh, major thirteenth
 356 @tab
 357 @code{m13.11}
 358 @tab
 359 @lilypond[line-width=3\cm,noragged-right, notime]
 360 \chordmode {
 361   c1:m13.11
 362 }
 363 @end lilypond
 364
 365 @item
 366 Suspended second
 367 @tab
 368 Major second, perfect fifth
 369 @tab
 370 @code{sus2}
 371 @tab
 372 @lilypond[line-width=3\cm,noragged-right, notime]
 373 \chordmode {
 374   c1:sus2
 375 }
 376 @end lilypond
 377
 378 @item
 379 Suspended fourth
 380 @tab
 381 Perfect fourth, perfect fifth
 382 @tab
 383 @code{sus4}
 384 @tab
 385 @lilypond[line-width=3\cm,noragged-right, notime]
 386 \chordmode {
 387   c1:sus4
 388 }
 389 @end lilypond
 390
 391 @item
 392 Power chord (two-voiced)
 393 @tab
 394 Perfect fifth
 395 @tab
 396 @code{1.5}
 397 @tab
 398 @lilypond[line-width=3\cm,noragged-right, notime]
 399 \chordmode {
 400   \powerChords
 401   c1:1.5
 402 }
 403 @end lilypond
 404
 405 @item
 406 Power chord (three-voiced)
 407 @tab
 408 Perfect fifth, octave
 409 @tab
 410 @code{1.5.8}
 411 @tab
 412 @lilypond[line-width=3\cm,noragged-right, notime]
 413 \chordmode {
 414   \powerChords
 415   c1:1.5.8
 416 }
 417 @end lilypond
 418
 419 @end multitable
 420
 421 @node Predefined string tunings
 422 @appendixsec Predefined string tunings
 423
 424 The chart below shows the predefined string tunings.
 425
 426 @lilypondfile{display-predefined-string-tunings.ly}
 427
 428 @node Predefined fretboard diagrams
 429 @appendixsec Predefined fretboard diagrams
 430
 431 The chart below shows the predefined fretboard diagrams for guitar.
 432
 433 @lilypondfile{display-predefined-fretboards.ly}
 434
 435 The chart below shows the predefined fretboard diagrams for ukulele.
 436
 437 @lilypondfile{display-predefined-ukulele-fretboards.ly}
 438
 439 The chart below shows the predefined fretboard diagrams for mandolin.
 440
 441 @lilypondfile{display-predefined-mandolin-fretboards.ly}
 442
 443 @node MIDI instruments
 444 @appendixsec MIDI instruments
 445
 446 The following is a list of names that can be used for the
 447 @code{midiInstrument} property.  The order of the instruments
 448 below, starting in the left-hand column moving down, corresponds
 449 to the General MIDI Standard's 128 Program Numbers.
 450
 451 @example
 452 acoustic grand            contrabass           lead 7 (fifths)
 453 bright acoustic           tremolo strings      lead 8 (bass+lead)
 454 electric grand            pizzicato strings    pad 1 (new age)
 455 honky-tonk                orchestral harp      pad 2 (warm)
 456 electric piano 1          timpani              pad 3 (polysynth)
 457 electric piano 2          string ensemble 1    pad 4 (choir)
 458 harpsichord               string ensemble 2    pad 5 (bowed)
 459 clav                      synthstrings 1       pad 6 (metallic)
 460 celesta                   synthstrings 2       pad 7 (halo)
 461 glockenspiel              choir aahs           pad 8 (sweep)
 462 music box                 voice oohs           fx 1 (rain)
 463 vibraphone                synth voice          fx 2 (soundtrack)
 464 marimba                   orchestra hit        fx 3 (crystal)
 465 xylophone                 trumpet              fx 4 (atmosphere)
 466 tubular bells             trombone             fx 5 (brightness)
 467 dulcimer                  tuba                 fx 6 (goblins)
 468 drawbar organ             muted trumpet        fx 7 (echoes)
 469 percussive organ          french horn          fx 8 (sci-fi)
 470 rock organ                brass section        sitar
 471 church organ              synthbrass 1         banjo
 472 reed organ                synthbrass 2         shamisen
 473 accordion                 soprano sax          koto
 474 harmonica                 alto sax             kalimba
 475 concertina                tenor sax            bagpipe
 476 acoustic guitar (nylon)   baritone sax         fiddle
 477 acoustic guitar (steel)   oboe                 shanai
 478 electric guitar (jazz)    english horn         tinkle bell
 479 electric guitar (clean)   bassoon              agogo
 480 electric guitar (muted)   clarinet             steel drums
 481 overdriven guitar         piccolo              woodblock
 482 distorted guitar          flute                taiko drum
 483 guitar harmonics          recorder             melodic tom
 484 acoustic bass             pan flute            synth drum
 485 electric bass (finger)    blown bottle         reverse cymbal
 486 electric bass (pick)      shakuhachi           guitar fret noise
 487 fretless bass             whistle              breath noise
 488 slap bass 1               ocarina              seashore
 489 slap bass 2               lead 1 (square)      bird tweet
 490 synth bass 1              lead 2 (sawtooth)    telephone ring
 491 synth bass 2              lead 3 (calliope)    helicopter
 492 violin                    lead 4 (chiff)       applause
 493 viola                     lead 5 (charang)     gunshot
 494 cello                     lead 6 (voice)
 495 @end example
 496
 497
 498 @node List of colors
 499 @appendixsec List of colors
 500
 501 @subsubheading Normal colors
 502
 503 Usage syntax is detailed in @ref{Coloring objects}.
 504
 505 @cindex List of colors
 506 @cindex Colors, list of
 507
 508 @verbatim
 509 black       white          red         green
 510 blue        cyan           magenta     yellow
 511 grey        darkred        darkgreen   darkblue
 512 darkcyan    darkmagenta    darkyellow
 513 @end verbatim
 514
 515
 516 @subsubheading X color names
 517
 518 X color names come several variants:
 519
 520 Any name that is spelled as a single word with capitalization
 521 (e.g. @q{LightSlateBlue}) can also be spelled as space separated
 522 words without capitalization (e.g. @q{light slate blue}).
 523
 524 The word @q{grey} can always be spelled @q{gray} (e.g. @q{DarkSlateGray}).
 525
 526 Some names can take a numerical suffix (e.g. @q{LightSalmon4}).
 527
 528
 529 @subsubheading Color Names without a numerical suffix:
 530
 531 @verbatim
 532 snow            GhostWhite      WhiteSmoke      gainsboro       FloralWhite
 533 OldLace         linen           AntiqueWhite    PapayaWhip      BlanchedAlmond
 534 bisque          PeachPuff       NavajoWhite     moccasin        cornsilk
 535 ivory           LemonChiffon    seashell        honeydew        MintCream
 536 azure           AliceBlue       lavender        LavenderBlush   MistyRose
 537 white           black           DarkSlateGrey   DimGrey         SlateGrey
 538 LightSlateGrey  grey            LightGrey       MidnightBlue    navy
 539 NavyBlue        CornflowerBlue  DarkSlateBlue   SlateBlue       MediumSlateBlue
 540 LightSlateBlue  MediumBlue      RoyalBlue       blue            DodgerBlue
 541 DeepSkyBlue     SkyBlue         LightSkyBlue    SteelBlue       LightSteelBlue
 542 LightBlue       PowderBlue      PaleTurquoise   DarkTurquoise   MediumTurquoise
 543 turquoise       cyan            LightCyan       CadetBlue       MediumAquamarine
 544 aquamarine      DarkGreen       DarkOliveGreen  DarkSeaGreen    SeaGreen
 545 MediumSeaGreen  LightSeaGreen   PaleGreen       SpringGreen     LawnGreen
 546 green           chartreuse      MediumSpringGreen       GreenYellow     LimeGreen
 547 YellowGreen     ForestGreen     OliveDrab       DarkKhaki       khaki
 548 PaleGoldenrod   LightGoldenrodYellow    LightYellow     yellow  gold
 549 LightGoldenrod  goldenrod       DarkGoldenrod   RosyBrown       IndianRed
 550 SaddleBrown     sienna          peru            burlywood       beige
 551 wheat           SandyBrown      tan             chocolate       firebrick
 552 brown           DarkSalmon      salmon          LightSalmon     orange
 553 DarkOrange      coral           LightCoral      tomato          OrangeRed
 554 red             HotPink         DeepPink        pink            LightPink
 555 PaleVioletRed   maroon          MediumVioletRed VioletRed       magenta
 556 violet          plum            orchid          MediumOrchid    DarkOrchid
 557 DarkViolet      BlueViolet      purple          MediumPurple    thistle
 558 DarkGrey        DarkBlue        DarkCyan        DarkMagenta     DarkRed
 559 LightGreen
 560 @end verbatim
 561
 562
 563 @subsubheading Color names with a numerical suffix
 564
 565 In the following names the suffix N can be a number in the range 1-4:
 566
 567 @verbatim
 568 snowN           seashellN       AntiqueWhiteN   bisqueN         PeachPuffN
 569 NavajoWhiteN    LemonChiffonN   cornsilkN       ivoryN          honeydewN
 570 LavenderBlushN  MistyRoseN      azureN          SlateBlueN      RoyalBlueN
 571 blueN           DodgerBlueN     SteelBlueN      DeepSkyBlueN    SkyBlueN
 572 LightSkyBlueN   LightSteelBlueN LightBlueN      LightCyanN      PaleTurquoiseN
 573 CadetBlueN      turquoiseN      cyanN           aquamarineN     DarkSeaGreenN
 574 SeaGreenN       PaleGreenN      SpringGreenN    greenN          chartreuseN
 575 OliveDrabN      DarkOliveGreenN khakiN          LightGoldenrodN LightYellowN
 576 yellowN         goldN           goldenrodN      DarkGoldenrodN  RosyBrownN
 577 IndianRedN      siennaN         burlywoodN      wheatN          tanN
 578 chocolateN      firebrickN      brownN          salmonN         LightSalmonN
 579 orangeN         DarkOrangeN     coralN          tomatoN         OrangeRedN
 580 redN            DeepPinkN       HotPinkN        pinkN           LightPinkN
 581 PaleVioletRedN  maroonN         VioletRedN      magentaN        orchidN
 582 plumN           MediumOrchidN   DarkOrchidN     purpleN         MediumPurpleN
 583 thistleN
 584 @end verbatim
 585
 586
 587 @subsubheading Grey Scale
 588
 589 A grey scale can be obtained using:
 590
 591 @example
 592 greyN
 593 @end example
 594
 595 @noindent
 596 Where N is in the range 0-100.
 597
 598
 599 @node The Feta font
 600 @appendixsec The Feta font
 601
 602 @cindex Feta font
 603 @cindex Font, Feta
 604
 605 The following symbols are available in the Emmentaler font and may be
 606 accessed directly using text markup with the name of the glyph
 607 as shown in the tables below,
 608 such as @code{g^\markup @{\musicglyph #"scripts.segno" @}} or
 609 @code{\markup @{\musicglyph #"five"@}}.  For more information,
 610 see @ref{Formatting text}.
 611
 612
 613 @menu
 614 * Clef glyphs::
 615 * Time Signature glyphs::
 616 * Number glyphs::
 617 * Accidental glyphs::
 618 * Default Notehead glyphs::
 619 * Special Notehead glyphs::
 620 * Shape-note Notehead glyphs::
 621 * Rest glyphs::
 622 * Flag glyphs::
 623 * Dot glyphs::
 624 * Dynamic glyphs::
 625 * Script glyphs::
 626 * Arrowhead glyphs::
 627 * Bracket-tip glyphs::
 628 * Pedal glyphs::
 629 * Accordion glyphs::
 630 * Vaticana glyphs::
 631 * Medicaea glyphs::
 632 * Hufnagel glyphs::
 633 * Mensural glyphs::
 634 * Neomensural glyphs::
 635 * Petrucci glyphs::
 636 * Solesmes glyphs::
 637 @end menu
 638
 639
 640 @node Clef glyphs
 641 @unnumberedsubsec Clef glyphs
 642
 643 @lilypond[quote]
 644 \include "font-table.ly"
 645 \markuplines \override-lines #'(word-space . 4)
 646              \doc-chars #clefs
 647 @end lilypond
 648
 649
 650 @node Time Signature glyphs
 651 @unnumberedsubsec Time Signature glyphs
 652
 653 @lilypond[quote]
 654 \include "font-table.ly"
 655 \markuplines \override-lines #'(word-space . 4)
 656              \doc-chars #timesig
 657 @end lilypond
 658
 659
 660 @node Number glyphs
 661 @unnumberedsubsec Number glyphs
 662
 663 @lilypond[quote]
 664 \include "font-table.ly"
 665 \markuplines \override-lines #'(word-space . 4)
 666              \doc-chars #numbers
 667 @end lilypond
 668
 669
 670 @node Accidental glyphs
 671 @unnumberedsubsec Accidental glyphs
 672
 673 @lilypond[quote]
 674 \include "font-table.ly"
 675 \markuplines \override-lines #'(word-space . 4)
 676              \doc-chars #accidentals
 677 @end lilypond
 678
 679
 680 @node Default Notehead glyphs
 681 @unnumberedsubsec Default Notehead glyphs
 682
 683 @lilypond[quote]
 684 \include "font-table.ly"
 685 \markuplines \override-lines #'(word-space . 4)
 686              \doc-chars #default-noteheads
 687 @end lilypond
 688
 689
 690 @node Special Notehead glyphs
 691 @unnumberedsubsec Special Notehead glyphs
 692
 693 @lilypond[quote]
 694 \include "font-table.ly"
 695 \markuplines \override-lines #'(word-space . 4)
 696              \doc-chars #special-noteheads
 697 @end lilypond
 698
 699
 700 @node Shape-note Notehead glyphs
 701 @unnumberedsubsec Shape-note Notehead glyphs
 702
 703 @lilypond[quote]
 704 \include "font-table.ly"
 705 \markuplines \override-lines #'(word-space . 4)
 706              \doc-chars #shape-note-noteheads
 707 @end lilypond
 708
 709
 710 @node Rest glyphs
 711 @unnumberedsubsec Rest glyphs
 712
 713 @lilypond[quote]
 714 \include "font-table.ly"
 715 \markuplines \override-lines #'(word-space . 4)
 716              \doc-chars #rests
 717 @end lilypond
 718
 719
 720 @node Flag glyphs
 721 @unnumberedsubsec Flag glyphs
 722
 723 @lilypond[quote]
 724 \include "font-table.ly"
 725 \markuplines \override-lines #'(word-space . 4)
 726              \doc-chars #flags
 727 @end lilypond
 728
 729
 730 @node Dot glyphs
 731 @unnumberedsubsec Dot glyphs
 732
 733 @lilypond[quote]
 734 \include "font-table.ly"
 735 \markuplines \override-lines #'(word-space . 4)
 736              \doc-chars #dots
 737 @end lilypond
 738
 739
 740 @node Dynamic glyphs
 741 @unnumberedsubsec Dynamic glyphs
 742
 743 @lilypond[quote]
 744 \include "font-table.ly"
 745 \markuplines \override-lines #'(word-space . 4)
 746              \doc-chars #dynamics
 747 @end lilypond
 748
 749
 750 @node Script glyphs
 751 @unnumberedsubsec Script glyphs
 752
 753 @lilypond[quote]
 754 \include "font-table.ly"
 755 \markuplines \override-lines #'(word-space . 4)
 756              \doc-chars #scripts
 757 @end lilypond
 758
 759
 760 @node Arrowhead glyphs
 761 @unnumberedsubsec Arrowhead glyphs
 762
 763 @lilypond[quote]
 764 \include "font-table.ly"
 765 \markuplines \override-lines #'(word-space . 4)
 766              \doc-chars #arrowheads
 767 @end lilypond
 768
 769
 770 @node Bracket-tip glyphs
 771 @unnumberedsubsec Bracket-tip glyphs
 772
 773 @lilypond[quote]
 774 \include "font-table.ly"
 775 \markuplines \override-lines #'(word-space . 4)
 776              \doc-chars #brackettips
 777 @end lilypond
 778
 779
 780 @node Pedal glyphs
 781 @unnumberedsubsec Pedal glyphs
 782
 783 @lilypond[quote]
 784 \include "font-table.ly"
 785 \markuplines \override-lines #'(word-space . 4)
 786              \doc-chars #pedal
 787 @end lilypond
 788
 789
 790 @node Accordion glyphs
 791 @unnumberedsubsec Accordion glyphs
 792
 793 @lilypond[quote]
 794 \include "font-table.ly"
 795 \markuplines \override-lines #'(word-space . 4)
 796              \doc-chars #accordion
 797 @end lilypond
 798
 799
 800 @node Vaticana glyphs
 801 @unnumberedsubsec Vaticana glyphs
 802
 803 @lilypond[quote]
 804 \include "font-table.ly"
 805 \markuplines \override-lines #'(word-space . 4)
 806              \doc-chars #vaticana
 807 @end lilypond
 808
 809
 810 @node Medicaea glyphs
 811 @unnumberedsubsec Medicaea glyphs
 812
 813 @lilypond[quote]
 814 \include "font-table.ly"
 815 \markuplines \override-lines #'(word-space . 4)
 816              \doc-chars #medicaea
 817 @end lilypond
 818
 819
 820 @node Hufnagel glyphs
 821 @unnumberedsubsec Hufnagel glyphs
 822
 823 @lilypond[quote]
 824 \include "font-table.ly"
 825 \markuplines \override-lines #'(word-space . 4)
 826              \doc-chars #hufnagel
 827 @end lilypond
 828
 829
 830 @node Mensural glyphs
 831 @unnumberedsubsec Mensural glyphs
 832
 833 @lilypond[quote]
 834 \include "font-table.ly"
 835 \markuplines \override-lines #'(word-space . 4)
 836              \doc-chars #mensural
 837 @end lilypond
 838
 839
 840 @node Neomensural glyphs
 841 @unnumberedsubsec Neomensural glyphs
 842
 843 @lilypond[quote]
 844 \include "font-table.ly"
 845 \markuplines \override-lines #'(word-space . 4)
 846              \doc-chars #neomensural
 847 @end lilypond
 848
 849
 850 @node Petrucci glyphs
 851 @unnumberedsubsec Petrucci glyphs
 852
 853 @lilypond[quote]
 854 \include "font-table.ly"
 855 \markuplines \override-lines #'(word-space . 4)
 856              \doc-chars #petrucci
 857 @end lilypond
 858
 859
 860 @node Solesmes glyphs
 861 @unnumberedsubsec Solesmes glyphs
 862
 863 @lilypond[quote]
 864 \include "font-table.ly"
 865 \markuplines \override-lines #'(word-space . 4)
 866              \doc-chars #solesmes
 867 @end lilypond
 868
 869
 870 @node Note head styles
 871 @appendixsec Note head styles
 872
 873 @cindex note head styles
 874 The following styles may be used for note heads.
 875
 876 @lilypondfile[noindent]{note-head-style.ly}
 877
 878
 879 @node Text markup commands
 880 @appendixsec Text markup commands
 881
 882 @include markup-commands.tely
 883
 884
 885 @node Text markup list commands
 886 @appendixsec Text markup list commands
 887
 888 The following commands can all be used with @code{\markuplines}:
 889
 890 @include markup-list-commands.tely
 891
 892
 893 @node List of articulations
 894 @appendixsec List of articulations
 895
 896
 897 @cindex accent
 898 @cindex accentus
 899 @cindex circulus
 900 @cindex coda
 901 @cindex downbow
 902 @cindex downmordent
 903 @cindex downprall
 904 @cindex espressivo
 905 @cindex fermata
 906 @cindex flageolet
 907 @cindex halfopen
 908 @cindex ictus
 909 @cindex lheel
 910 @cindex lineprall
 911 @cindex longfermata
 912 @cindex ltoe
 913 @cindex marcato
 914 @cindex mordent
 915 @cindex open
 916 @cindex portato
 917 @cindex prall
 918 @cindex pralldown
 919 @cindex prallmordent
 920 @cindex prallprall
 921 @cindex prallup
 922 @cindex reverseturn
 923 @cindex rheel
 924 @cindex rtoe
 925 @cindex segno
 926 @cindex semicirculus
 927 @cindex shortfermata
 928 @cindex signumcongruentiae
 929 @cindex snappizzicato
 930 @cindex staccatissimo
 931 @cindex staccato
 932 @cindex stopped
 933 @cindex tenuto
 934 @cindex thumb
 935 @cindex trill
 936 @cindex turn
 937 @cindex upbow
 938 @cindex upmordent
 939 @cindex upprall
 940 @cindex varcoda
 941 @cindex verylongfermata
 942
 943 The following scripts are available in the Feta font and may be
 944 attached to notes (eg. @samp{c\accent}).
 945
 946 @c Articulations and ornamentations
 947 @c Fingering instructions (for "thumb")
 948 @c Common notation for unfretted strings
 949 @c   Bowing indications
 950 @c   Harmonics
 951 @c   Snap (Bartók) pizzicato
 952 @c Custom percussion staves (for "halfopen" -- not yet funindexed)
 953 @c References for wind instruments (for "open"/"stopped" -- not yet funindexed)
 954
 955
 956 @menu
 957 * Articulation scripts::
 958 * Ornament scripts::
 959 * Fermata scripts::
 960 * Instrument-specific scripts::
 961 * Repeat sign scripts::
 962 * Ancient scripts::
 963 @end menu
 964
 965
 966 @node Articulation scripts
 967 @unnumberedsubsec Articulation scripts
 968
 969 @lilypond[quote]
 970 \include "script-chart.ly"
 971 \new RhythmicStaff { \scriptStaff #articulations }
 972 @end lilypond
 973
 974 @node Ornament scripts
 975 @unnumberedsubsec Ornament scripts
 976
 977 @lilypond[quote]
 978 \include "script-chart.ly"
 979 \new RhythmicStaff { \scriptStaff #ornaments }
 980 @end lilypond
 981
 982 @node Fermata scripts
 983 @unnumberedsubsec Fermata scripts
 984
 985 @lilypond[quote]
 986 \include "script-chart.ly"
 987 \new RhythmicStaff { \scriptStaff #fermatas }
 988 @end lilypond
 989
 990 @node Instrument-specific scripts
 991 @unnumberedsubsec Instrument-specific scripts
 992
 993 @lilypond[quote]
 994 \include "script-chart.ly"
 995 \new RhythmicStaff { \scriptStaff #instrument-specific }
 996 @end lilypond
 997
 998 @node Repeat sign scripts
 999 @unnumberedsubsec Repeat sign scripts
1000
1001 @lilypond[quote]
1002 \include "script-chart.ly"
1003 \new RhythmicStaff { \scriptStaff #repeats }
1004 @end lilypond
1005
1006 @node Ancient scripts
1007 @unnumberedsubsec Ancient scripts
1008
1009 @lilypond[quote]
1010 \include "script-chart.ly"
1011 \include "gregorian.ly"
1012 \new VaticanaStaff { \scriptStaffAncient #ancient }
1013 @end lilypond
1014
1015
1016 @node Percussion notes
1017 @appendixsec Percussion notes
1018
1019 @lilypondfile[quote]{percussion-chart.ly}
1020
1021
1022 @node Technical glossary
1023 @appendixsec Technical glossary
1024
1025 A glossary of the technical terms and concepts used internally in
1026 LilyPond.  These terms may appear in the manuals, on mailing lists
1027 or in the source code.
1028
1029 @menu
1030 * alist::
1031 * callback::
1032 * closure::
1033 * glyph::
1034 * grob::
1035 * immutable::
1036 * interface::
1037 * lexer::
1038 * mutable::
1039 * output-def::
1040 * parser::
1041 * parser variable::
1042 * prob::
1043 * simple closure::
1044 * smob::
1045 * stencil::
1046 @end menu
1047
1048 @node alist
1049 @unnumberedsubsec alist
1050
1051 @cindex alist
1052 @cindex association list
1053
1054 An association list or @strong{alist} for short is a Scheme pair
1055 which associates a value with a key: @w{@code{(key . value)}}.  For
1056 example, in @file{scm/lily.scm}, the alist
1057 @w{@qq{type-p-name-alist}} associates certain type predicates
1058 (e.g.@tie{}@code{ly:music?}) with names (e.g.@tie{}@qq{music}) so
1059 that type-check failures can be reported with a console message that
1060 includes the name of the expected type predicate.
1061
1062 @node callback
1063 @unnumberedsubsec callback
1064
1065 @cindex callback
1066
1067 A @strong{callback} is a routine, function or method whose reference is
1068 passed as an argument in a call to another routine, so allowing
1069 the called routine to invoke it.  The technique enables a lower-
1070 level software layer to call a function defined in a higher
1071 layer.  Callbacks are used extensively in LilyPond to permit
1072 user-level Scheme code to define how many low-level actions are
1073 performed.
1074
1075
1076 @node closure
1077 @unnumberedsubsec closure
1078
1079 @cindex closure
1080 @cindex simple closure
1081
1082 In Scheme, a @strong{closure} is created when a function, usually
1083 a lambda expression, is passed as a variable.  The closure contains
1084 the function's code plus references to the lexical bindings of the
1085 function's free variables (i.e. those variables used in the
1086 expression but defined outside it).  When this function is applied
1087 to different arguments later, the free variable bindings that were
1088 captured in the closure are used to obtain the values of the free
1089 variables to be used in the calculation.  One useful property of
1090 closures is the retention of internal variable values between
1091 invocations, so permitting state to be maintained.
1092
1093 A @strong{simple closure} is a closure whose expression has no free
1094 variables and hence no free variable bindings.
1095
1096 A simple closure is represented in LilyPond by a smob containing
1097 the expression and a method to apply the expression to a passed
1098 list of arguments.
1099
1100
1101 @node glyph
1102 @unnumberedsubsec glyph
1103
1104 @cindex glyph
1105 @cindex font
1106 @cindex typeface
1107
1108 A @strong{glyph} is a particular graphical representation of a typographic
1109 character, or a combination of two characters formating a ligature.
1110 A set of glyphs with a single style and shape comprise a font, and
1111 a set of fonts covering several styles and sizes comprise a typeface.
1112
1113
1114 @seealso
1115 Notation Reference:
1116 @ref{Fonts},
1117 @ref{Text encoding}.
1118
1119
1120 @node grob
1121 @unnumberedsubsec grob
1122
1123 @cindex grob
1124 @cindex layout objects
1125 @cindex graphical objects
1126
1127 LilyPond objects which represent items of notation in the printed
1128 output such as note heads, stems, slurs, ties, fingering, clefs,
1129 etc are called @q{Layout objects}, often known as @q{GRaphical
1130 OBjects}, or @strong{grobs} for short.  They are represented by
1131 instances of the @code{Grob} class.
1132
1133 @seealso
1134 Learning Manual:
1135 @rlearning{Objects and interfaces},
1136 @rlearning{Naming conventions of objects and properties},
1137 @rlearning{Properties of layout objects}.
1138
1139 Internals Reference:
1140 @rinternals{grob-interface},
1141 @rinternals{All layout objects}.
1142
1143
1144 @node immutable
1145 @unnumberedsubsec immutable
1146
1147 @cindex immutable objects
1148 @cindex immutable properties
1149 @cindex shared properties
1150
1151 An @strong{immutable} object is one whose state cannot be modified
1152 after creation, in contrast to a mutable object, which can be
1153 modified after creation.
1154
1155 In LilyPond, immutable or shared properties define the default
1156 style and behavior of grobs.  They are shared between many objects.
1157 In apparent contradiction to the name, they can be changed using
1158 @code{\override} and @code{\revert}.
1159
1160 @seealso
1161 Notation Reference:
1162 @ref{mutable}.
1163
1164 @node interface
1165 @unnumberedsubsec interface
1166
1167 @cindex interface
1168 @cindex grob-interface
1169 @cindex graphical object interfaces
1170
1171 Actions and properties which are common to a number of grobs are
1172 grouped together in an object called a @code{grob-interface}, or
1173 just @q{interface} for short.
1174
1175 @seealso
1176 Learning Manual:
1177 @rlearning{Objects and interfaces},
1178 @rlearning{Naming conventions of objects and properties},
1179 @rlearning{Properties found in interfaces}.
1180
1181 Notation Reference:
1182 @ref{Layout interfaces}.
1183
1184 Internals Reference:
1185 @rinternals{Graphical Object Interfaces}.
1186
1187
1188 @node lexer
1189 @unnumberedsubsec lexer
1190
1191 @cindex lexer
1192 @cindex Flex
1193
1194 A @strong{lexer} is a program which converts a sequence of
1195 characters into a sequence of tokens, a process called lexical
1196 analysis.  The LilyPond lexer converts the stream obtained from an
1197 input @file{.ly} file into a tokenized stream more suited to the
1198 next stage of processing - parsing, for which see @ref{parser}.
1199 The LilyPond lexer is built with Flex from the lexer file
1200 @file{lily/lexer.ll} which contains the lexical rules.  This file
1201 is part of the source code and is not included in the LilyPond
1202 binary installation.
1203
1204
1205 @node mutable
1206 @unnumberedsubsec mutable
1207
1208 @cindex mutable objects
1209 @cindex mutable properties
1210
1211 A @strong{mutable} object is one whose state can be modified after
1212 creation, in contrast to an immutable object, whose state is fixed
1213 at the time of creation.
1214
1215 In LilyPond, mutable properties contain values that are specific to
1216 one grob.  Typically, lists of other objects or results from
1217 computations are stored in mutable properties.
1218
1219 @seealso
1220 Notation Reference:
1221 @ref{immutable}.
1222
1223 @node output-def
1224 @unnumberedsubsec output-def
1225
1226 @cindex output-def
1227
1228 An instance of the @code{Output-def} class contains the methods and
1229 data structures associated with an output block.  Instances are
1230 created for midi, layout and paper blocks.
1231
1232
1233 @node parser
1234 @unnumberedsubsec parser
1235
1236 @cindex parser
1237 @cindex Bison
1238 @cindex grammar for LilyPond
1239 @cindex BNF
1240
1241 A @strong{parser} analyzes the sequence of tokens produced by a
1242 lexer to determine its grammatical structure, grouping the tokens
1243 progressively into larger groupings according to the rules of the
1244 grammar.  If the sequence of tokens is valid the end product is a
1245 tree of tokens whose root is the grammar's start symbol.  If this
1246 cannot be achieved the file is invalid and an appropriate error
1247 message is produced.  The syntactic groupings and the rules for
1248 constructing the groupings from their parts for the LilyPond syntax
1249 are defined in @file{lily/parser.yy} and shown in Backus Normal Form
1250 (BNF) in @ref{LilyPond grammar}.  This file is used to build the
1251 parser during the program build by the parser generator, Bison.  It
1252 is part of the source code and is not included in the LilyPond
1253 binary installation.
1254
1255
1256 @node parser variable
1257 @unnumberedsubsec parser variable
1258
1259 @cindex parser variable
1260 @cindex Scheme variable
1261 @cindex global variable
1262 @cindex afterGraceFraction
1263 @cindex musicQuotes
1264 @cindex mode
1265 @cindex output-count
1266 @cindex output-suffix
1267 @cindex parseStringResult
1268 @cindex partCombineListener
1269 @cindex pitchnames
1270 @cindex toplevel-bookparts
1271 @cindex toplevel-scores
1272 @cindex showLastLength
1273 @cindex showFirstLength
1274
1275 These are variables defined directly in Scheme.  Their direct
1276 use by users is strongly discouraged, because their scoping
1277 semantics can be confusing.
1278
1279 When the value of such a variable is changed in a @file{.ly} file,
1280 the change is global, and unless explicitly reverted, the new value
1281 will persist to the end of the file, affecting subsequent
1282 @code{\score} blocks as well as external files added with the
1283 @code{\include} command.  This can lead to unintended consequences
1284 and in complex typesetting projects the consequent errors can be
1285 difficult to track down.
1286
1287 LilyPond uses the following parser variables:
1288
1289 @itemize
1290 @item afterGraceFraction
1291 @item musicQuotes
1292 @item mode
1293 @item output-count
1294 @item output-suffix
1295 @item parseStringResult
1296 @item partCombineListener
1297 @item pitchnames
1298 @item toplevel-bookparts
1299 @item toplevel-scores
1300 @item showLastLength
1301 @item showFirstLength
1302 @end itemize
1303
1304
1305 @node prob
1306 @unnumberedsubsec prob
1307
1308 @cindex prob
1309 @cindex property object
1310
1311 PRoperty OBjects, or @strong{probs} for short, are instances of
1312 the @code{Prob} class, a simple base class for objects which have
1313 mutable and immutable property alists and the methods to manipulate
1314 them.  The @code{Music} and @code{Stream_event} classes derive from
1315 @code{Prob}.  Instances of the @code{Prob} class are also created
1316 to hold the formatted content of system grobs and titling blocks
1317 during page layout.
1318
1319
1320 @node simple closure
1321 @unnumberedsubsec simple closure
1322
1323 See @ref{closure}.
1324
1325
1326 @node smob
1327 @unnumberedsubsec smob
1328
1329 @cindex smob
1330 @cindex Scheme object
1331
1332 @strong{Smobs}, or ScheMe OBjects, are part of the mechanism used
1333 by Guile to export C and C++ objects to Scheme code.  In LilyPond,
1334 smobs are created from C++ objects through macros.  There are two
1335 types of smob objects: simple smobs, intended for simple immutable
1336 objects like numbers, and complex smobs, used for objects with
1337 identities.  If you have access to the LilyPond sources, more
1338 information can be found in @file{lily/includes/smob.hh}.
1339
1340 @node stencil
1341 @unnumberedsubsec stencil
1342
1343 @cindex stencil
1344
1345 An instance of the @strong{stencil} class holds the information
1346 required to print a typographical object.  It is a simple smob
1347 containing a confining box, which defines the vertical and
1348 horizontal extents of the object, and a Scheme expression which
1349 will print the object when evaluated.  Stencils may be combined
1350 to form more complex stencils defined by a tree of Scheme
1351 expressions formed from the Scheme expressions of the component
1352 stencils.
1353
1354 The @code{stencil} property, which connects a grob to its stencil,
1355 is defined in the @code{grob-interface} interface.
1356
1357 @seealso
1358 Internals Reference:
1359 @rinternals{grob-interface}.
1360
1361
1362 @node All context properties
1363 @appendixsec All context properties
1364
1365 @include context-properties.tely
1366
1367
1368 @node Layout properties
1369 @appendixsec Layout properties
1370
1371 @include layout-properties.tely
1372
1373
1374 @node Available music functions
1375 @appendixsec Available music functions
1376
1377 @include identifiers.tely
1378
1379 @node Context modification identifiers
1380 @appendixsec Context modification identifiers
1381
1382 The following commands are defined for use as context modifications
1383 within a @code{\layout} or @code{\with} block.
1384
1385 @include context-mod-identifiers.tely
1386
1387 @node Predefined type predicates
1388 @appendixsec Predefined type predicates
1389
1390 @include type-predicates.tely
1391
1392
1393 @node Scheme functions
1394 @appendixsec Scheme functions
1395
1396 @include scheme-functions.tely
1397