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