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.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c \version "2.12.0"
  11
  12 @node Notation manual tables
  13 @appendix Notation manual tables
  14
  15 @c Please do not delete the following @ignore block.
  16 @ignore
  17 Note for editors and translators: In the following menu, two entries
  18 are needed to link to a pair of automatically generated sections.
  19 Please keep them and, if using emacs, do not run
  20 texinfo-all-menus-update without manually restoring them back. These
  21 menu entries are:
  22
  23 * Text markup commands::
  24 * Text markup list commands::
  25
  26 and they should go just after
  27 * Note head styles::
  28
  29 and just before
  30 * List of articulations::
  31 @end ignore
  32
  33 @menu
  34 * Chord name chart::
  35 * Common chord modifiers::
  36 * Predefined fretboard diagrams::
  37 * MIDI instruments::
  38 * List of colors::
  39 * The Feta font::
  40 * Note head styles::
  41 * Text markup commands::
  42 * Text markup list commands::
  43 * List of articulations::
  44 * Percussion notes::
  45 * Technical glossary::
  46 * All context properties::
  47 * Layout properties::
  48 * Available music functions::
  49 * Scheme functions::
  50 @end menu
  51
  52
  53
  54 @node Chord name chart
  55 @appendixsec Chord name chart
  56
  57 The following charts shows two standard systems for printing chord
  58 names, along with the pitches they represent.
  59
  60 @lilypondfile{chord-names-jazz.ly}
  61
  62 @node Common chord modifiers
  63 @appendixsec Common chord modifiers
  64
  65 The following table shows chord modifiers that can be used in
  66 @code{\chordmode} to generate standard chord structures.
  67
  68 @multitable @columnfractions .2 .3 .2 .2
  69
  70 @item
  71 @b{Chord type}
  72 @tab
  73 @b{Intervals}
  74 @tab
  75 @b{Modifier(s)}
  76 @tab
  77 @b{Example}
  78
  79
  80 @item
  81 Major
  82 @tab
  83 Major third, perfect fifth
  84 @tab
  85 @code{5} or nothing
  86 @tab
  87 @lilypond[line-width=3\cm,noragged-right, notime]
  88 \chordmode {
  89   c1:5
  90 }
  91 @end lilypond
  92
  93 @item
  94 Minor
  95 @tab
  96 Minor third, perfect fifth
  97 @tab
  98 @code{m} or @code{m5}
  99 @tab
 100 @lilypond[line-width=3\cm,noragged-right, notime]
 101 \chordmode {
 102   c1:m
 103 }
 104 @end lilypond
 105
 106 @item
 107 Augmented
 108 @tab
 109 Major third, augmented fifth
 110 @tab
 111 @code{aug}
 112 @tab
 113 @lilypond[line-width=3\cm,noragged-right, notime]
 114 \chordmode {
 115   c1:aug
 116 }
 117 @end lilypond
 118
 119 @item
 120 Diminished
 121 @tab
 122 Minor third, diminished fifth
 123 @tab
 124 @code{dim}
 125 @tab
 126 @lilypond[line-width=3\cm,noragged-right, notime]
 127 \chordmode {
 128   c1:dim
 129 }
 130 @end lilypond
 131
 132 @item
 133 Dominant seventh
 134 @tab
 135 Major triad, minor seventh
 136 @tab
 137 @code{7}
 138 @tab
 139 @lilypond[line-width=3\cm,noragged-right, notime]
 140 \chordmode {
 141   c1:7
 142 }
 143 @end lilypond
 144
 145 @item
 146 Major seventh
 147 @tab
 148 Major triad, major seventh
 149 @tab
 150 @code{maj7} or @code{maj}
 151 @tab
 152 @lilypond[line-width=3\cm,noragged-right, notime]
 153 \chordmode {
 154   c1:maj7
 155 }
 156 @end lilypond
 157
 158 @item
 159 Minor seventh
 160 @tab
 161 Minor triad, minor seventh
 162 @tab
 163 @code{m7}
 164 @tab
 165 @lilypond[line-width=3\cm,noragged-right, notime]
 166 \chordmode {
 167   c1:m7
 168 }
 169 @end lilypond
 170
 171 @item
 172 Diminished seventh
 173 @tab
 174 Diminished triad, diminished seventh
 175 @tab
 176 @code{dim7}
 177 @tab
 178 @lilypond[line-width=3\cm,noragged-right, notime]
 179 \chordmode {
 180   c1:dim7
 181 }
 182 @end lilypond
 183
 184 @item
 185 Augmented seventh
 186 @tab
 187 Augmented triad, minor seventh
 188 @tab
 189 @code{aug7}
 190 @tab
 191 @lilypond[line-width=3\cm,noragged-right, notime]
 192 \chordmode {
 193   c1:aug7
 194 }
 195 @end lilypond
 196
 197 @item
 198 Half-diminished seventh
 199 @tab
 200 Diminished triad, minor seventh
 201 @tab
 202 @code{m7.5-}
 203 @tab
 204 @lilypond[line-width=3\cm,noragged-right, notime]
 205 \chordmode {
 206   c1:m7.5-
 207 }
 208 @end lilypond
 209
 210 @item
 211 Minor-major seventh
 212 @tab
 213 Minor triad, major seventh
 214 @tab
 215 @code{maj7.5-}
 216 @tab
 217 @lilypond[line-width=3\cm,noragged-right, notime]
 218 \chordmode {
 219   c1:maj7.5-
 220 }
 221 @end lilypond
 222
 223 @item
 224 Major sixth
 225 @tab
 226 Major triad, sixth
 227 @tab
 228 @code{6}
 229 @tab
 230 @lilypond[line-width=3\cm,noragged-right, notime]
 231 \chordmode {
 232   c1:6
 233 }
 234 @end lilypond
 235
 236 @item
 237 Minor sixth
 238 @tab
 239 Minor triad, sixth
 240 @tab
 241 @code{m6}
 242 @tab
 243 @lilypond[line-width=3\cm,noragged-right, notime]
 244 \chordmode {
 245   c1:m6
 246 }
 247 @end lilypond
 248
 249 @item
 250 Dominant ninth
 251 @tab
 252 Dominant seventh, major ninth
 253 @tab
 254 @code{9}
 255 @tab
 256 @lilypond[line-width=3\cm,noragged-right, notime]
 257 \chordmode {
 258   c1:9
 259 }
 260 @end lilypond
 261
 262 @item
 263 Major ninth
 264 @tab
 265 Major seventh, major ninth
 266 @tab
 267 @code{maj9}
 268 @tab
 269 @lilypond[line-width=3\cm,noragged-right, notime]
 270 \chordmode {
 271   c1:maj9
 272 }
 273 @end lilypond
 274
 275 @item
 276 Minor ninth
 277 @tab
 278 Minor seventh, major ninth
 279 @tab
 280 @code{m9}
 281 @tab
 282 @lilypond[line-width=3\cm,noragged-right, notime]
 283 \chordmode {
 284   c1:m9
 285 }
 286 @end lilypond
 287
 288 @item
 289 Dominant eleventh
 290 @tab
 291 Dominant ninth, perfect eleventh
 292 @tab
 293 @code{11}
 294 @tab
 295 @lilypond[line-width=3\cm,noragged-right, notime]
 296 \chordmode {
 297   c1:11
 298 }
 299 @end lilypond
 300
 301 @item
 302 Major eleventh
 303 @tab
 304 Major ninth, perfect eleventh
 305 @tab
 306 @code{maj11}
 307 @tab
 308 @lilypond[line-width=3\cm,noragged-right, notime]
 309 \chordmode {
 310   c1:maj11
 311 }
 312 @end lilypond
 313
 314 @item
 315 Minor eleventh
 316 @tab
 317 Minor ninth, perfect eleventh
 318 @tab
 319 @code{m11}
 320 @tab
 321 @lilypond[line-width=3\cm,noragged-right, notime]
 322 \chordmode {
 323   c1:m11
 324 }
 325 @end lilypond
 326
 327 @item
 328 Dominant thirteenth
 329 @tab
 330 Dominant ninth, major thirteenth
 331 @tab
 332 @code{13}
 333 @tab
 334 @lilypond[line-width=3\cm,noragged-right, notime]
 335 \chordmode {
 336   c1:13
 337 }
 338 @end lilypond
 339
 340 @item
 341 Dominant thirteenth
 342 @tab
 343 Dominant eleventh, major thirteenth
 344 @tab
 345 @code{13.11}
 346 @tab
 347 @lilypond[line-width=3\cm,noragged-right, notime]
 348 \chordmode {
 349   c1:13.11
 350 }
 351 @end lilypond
 352
 353 @item
 354 Major thirteenth
 355 @tab
 356 Major eleventh, major thirteenth
 357 @tab
 358 @code{maj13.11}
 359 @tab
 360 @lilypond[line-width=3\cm,noragged-right, notime]
 361 \chordmode {
 362   c1:maj13.11
 363 }
 364 @end lilypond
 365
 366 @item
 367 Minor thirteenth
 368 @tab
 369 Minor eleventh, major thirteenth
 370 @tab
 371 @code{m13.11}
 372 @tab
 373 @lilypond[line-width=3\cm,noragged-right, notime]
 374 \chordmode {
 375   c1:m13.11
 376 }
 377 @end lilypond
 378
 379 @item
 380 Suspended second
 381 @tab
 382 Major second, perfect fifth
 383 @tab
 384 @code{sus2}
 385 @tab
 386 @lilypond[line-width=3\cm,noragged-right, notime]
 387 \chordmode {
 388   c1:sus2
 389 }
 390 @end lilypond
 391
 392 @item
 393 Suspended fourth
 394 @tab
 395 Perfect fourth, perfect fifth
 396 @tab
 397 @code{sus4}
 398 @tab
 399 @lilypond[line-width=3\cm,noragged-right, notime]
 400 \chordmode {
 401   c1:sus4
 402 }
 403 @end lilypond
 404
 405
 406 @end multitable
 407
 408 @node Predefined fretboard diagrams
 409 @appendixsec Predefined fretboard diagrams
 410
 411 The chart below shows the predefined fretboard diagrams.
 412
 413 @lilypondfile{display-predefined-fretboards.ly}
 414
 415 @node MIDI instruments
 416 @appendixsec MIDI instruments
 417
 418 The following is a list of names that can be used for the
 419 @code{midiInstrument} property.
 420
 421 @example
 422 acoustic grand            contrabass           lead 7 (fifths)
 423 bright acoustic           tremolo strings      lead 8 (bass+lead)
 424 electric grand            pizzicato strings    pad 1 (new age)
 425 honky-tonk                orchestral harp      pad 2 (warm)
 426 electric piano 1          timpani              pad 3 (polysynth)
 427 electric piano 2          string ensemble 1    pad 4 (choir)
 428 harpsichord               string ensemble 2    pad 5 (bowed)
 429 clav                      synthstrings 1       pad 6 (metallic)
 430 celesta                   synthstrings 2       pad 7 (halo)
 431 glockenspiel              choir aahs           pad 8 (sweep)
 432 music box                 voice oohs           fx 1 (rain)
 433 vibraphone                synth voice          fx 2 (soundtrack)
 434 marimba                   orchestra hit        fx 3 (crystal)
 435 xylophone                 trumpet              fx 4 (atmosphere)
 436 tubular bells             trombone             fx 5 (brightness)
 437 dulcimer                  tuba                 fx 6 (goblins)
 438 drawbar organ             muted trumpet        fx 7 (echoes)
 439 percussive organ          french horn          fx 8 (sci-fi)
 440 rock organ                brass section        sitar
 441 church organ              synthbrass 1         banjo
 442 reed organ                synthbrass 2         shamisen
 443 accordion                 soprano sax          koto
 444 harmonica                 alto sax             kalimba
 445 concertina                tenor sax            bagpipe
 446 acoustic guitar (nylon)   baritone sax         fiddle
 447 acoustic guitar (steel)   oboe                 shanai
 448 electric guitar (jazz)    english horn         tinkle bell
 449 electric guitar (clean)   bassoon              agogo
 450 electric guitar (muted)   clarinet             steel drums
 451 overdriven guitar         piccolo              woodblock
 452 distorted guitar          flute                taiko drum
 453 guitar harmonics          recorder             melodic tom
 454 acoustic bass             pan flute            synth drum
 455 electric bass (finger)    blown bottle         reverse cymbal
 456 electric bass (pick)      shakuhachi           guitar fret noise
 457 fretless bass             whistle              breath noise
 458 slap bass 1               ocarina              seashore
 459 slap bass 2               lead 1 (square)      bird tweet
 460 synth bass 1              lead 2 (sawtooth)    telephone ring
 461 synth bass 2              lead 3 (calliope)    helicopter
 462 violin                    lead 4 (chiff)       applause
 463 viola                     lead 5 (charang)     gunshot
 464 cello                     lead 6 (voice)
 465 @end example
 466
 467
 468 @node List of colors
 469 @appendixsec List of colors
 470
 471 @subsubheading Normal colors
 472
 473 Usage syntax is detailed in @ref{Coloring objects}.
 474
 475 @cindex List of colors
 476 @cindex Colors, list of
 477
 478 @verbatim
 479 black       white          red         green
 480 blue        cyan           magenta     yellow
 481 grey        darkred        darkgreen   darkblue
 482 darkcyan    darkmagenta    darkyellow
 483 @end verbatim
 484
 485
 486 @subsubheading X color names
 487
 488 X color names come several variants:
 489
 490 Any name that is spelled as a single word with capitalization
 491 (e.g. @q{LightSlateBlue}) can also be spelled as space separated
 492 words without capitalization (e.g. @q{light slate blue}).
 493
 494 The word @q{grey} can always be spelled @q{gray} (e.g. @q{DarkSlateGray}).
 495
 496 Some names can take a numerical suffix (e.g. @q{LightSalmon4}).
 497
 498
 499 @subsubheading Color Names without a numerical suffix:
 500
 501 @verbatim
 502 snow            GhostWhite      WhiteSmoke      gainsboro       FloralWhite
 503 OldLace         linen           AntiqueWhite    PapayaWhip      BlanchedAlmond
 504 bisque          PeachPuff       NavajoWhite     moccasin        cornsilk
 505 ivory           LemonChiffon    seashell        honeydew        MintCream
 506 azure           AliceBlue       lavender        LavenderBlush   MistyRose
 507 white           black           DarkSlateGrey   DimGrey         SlateGrey
 508 LightSlateGrey  grey            LightGrey       MidnightBlue    navy
 509 NavyBlue        CornflowerBlue  DarkSlateBlue   SlateBlue       MediumSlateBlue
 510 LightSlateBlue  MediumBlue      RoyalBlue       blue            DodgerBlue
 511 DeepSkyBlue     SkyBlue         LightSkyBlue    SteelBlue       LightSteelBlue
 512 LightBlue       PowderBlue      PaleTurquoise   DarkTurquoise   MediumTurquoise
 513 turquoise       cyan            LightCyan       CadetBlue       MediumAquamarine
 514 aquamarine      DarkGreen       DarkOliveGreen  DarkSeaGreen    SeaGreen
 515 MediumSeaGreen  LightSeaGreen   PaleGreen       SpringGreen     LawnGreen
 516 green           chartreuse      MediumSpringGreen       GreenYellow     LimeGreen
 517 YellowGreen     ForestGreen     OliveDrab       DarkKhaki       khaki
 518 PaleGoldenrod   LightGoldenrodYellow    LightYellow     yellow  gold
 519 LightGoldenrod  goldenrod       DarkGoldenrod   RosyBrown       IndianRed
 520 SaddleBrown     sienna          peru            burlywood       beige
 521 wheat           SandyBrown      tan             chocolate       firebrick
 522 brown           DarkSalmon      salmon          LightSalmon     orange
 523 DarkOrange      coral           LightCoral      tomato          OrangeRed
 524 red             HotPink         DeepPink        pink            LightPink
 525 PaleVioletRed   maroon          MediumVioletRed VioletRed       magenta
 526 violet          plum            orchid          MediumOrchid    DarkOrchid
 527 DarkViolet      BlueViolet      purple          MediumPurple    thistle
 528 DarkGrey        DarkBlue        DarkCyan        DarkMagenta     DarkRed
 529 LightGreen
 530 @end verbatim
 531
 532
 533 @subsubheading Color names with a numerical suffix
 534
 535 In the following names the suffix N can be a number in the range 1-4:
 536
 537 @verbatim
 538 snowN           seashellN       AntiqueWhiteN   bisqueN         PeachPuffN
 539 NavajoWhiteN    LemonChiffonN   cornsilkN       ivoryN          honeydewN
 540 LavenderBlushN  MistyRoseN      azureN          SlateBlueN      RoyalBlueN
 541 blueN           DodgerBlueN     SteelBlueN      DeepSkyBlueN    SkyBlueN
 542 LightSkyBlueN   LightSteelBlueN LightBlueN      LightCyanN      PaleTurquoiseN
 543 CadetBlueN      turquoiseN      cyanN           aquamarineN     DarkSeaGreenN
 544 SeaGreenN       PaleGreenN      SpringGreenN    greenN          chartreuseN
 545 OliveDrabN      DarkOliveGreenN khakiN          LightGoldenrodN LightYellowN
 546 yellowN         goldN           goldenrodN      DarkGoldenrodN  RosyBrownN
 547 IndianRedN      siennaN         burlywoodN      wheatN          tanN
 548 chocolateN      firebrickN      brownN          salmonN         LightSalmonN
 549 orangeN         DarkOrangeN     coralN          tomatoN         OrangeRedN
 550 redN            DeepPinkN       HotPinkN        pinkN           LightPinkN
 551 PaleVioletRedN  maroonN         VioletRedN      magentaN        orchidN
 552 plumN           MediumOrchidN   DarkOrchidN     purpleN         MediumPurpleN
 553 thistleN
 554 @end verbatim
 555
 556
 557 @subsubheading Grey Scale
 558
 559 A grey scale can be obtained using:
 560
 561 @example
 562 greyN
 563 @end example
 564
 565 @noindent
 566 Where N is in the range 0-100.
 567
 568
 569 @node The Feta font
 570 @appendixsec The Feta font
 571
 572 @cindex Feta font
 573 @cindex Font, Feta
 574
 575 The following symbols are available in the Emmentaler font and may be
 576 accessed directly using text markup with the name of the glyph
 577 as shown in the tables below,
 578 such as @code{g^\markup @{\musicglyph #"scripts.segno" @}} or
 579 @code{\markup @{\musicglyph #"five"@}}.  For more information,
 580 see @ref{Formatting text}.
 581
 582
 583 @menu
 584 * Clef glyphs::
 585 * Time Signature glyphs::
 586 * Number glyphs::
 587 * Accidental glyphs::
 588 * Default Notehead glyphs::
 589 * Special Notehead glyphs::
 590 * Shape-note Notehead glyphs::
 591 * Rest glyphs::
 592 * Flag glyphs::
 593 * Dot glyphs::
 594 * Dynamic glyphs::
 595 * Script glyphs::
 596 * Arrowhead glyphs::
 597 * Bracket-tip glyphs::
 598 * Pedal glyphs::
 599 * Accordion glyphs::
 600 * Vaticana glyphs::
 601 * Medicaea glyphs::
 602 * Hufnagel glyphs::
 603 * Mensural glyphs::
 604 * Neomensural glyphs::
 605 * Petrucci glyphs::
 606 * Solesmes glyphs::
 607 @end menu
 608
 609
 610 @node Clef glyphs
 611 @unnumberedsubsec Clef glyphs
 612
 613 @lilypond[quote]
 614 \include "font-table.ly"
 615 \markuplines \override-lines #'(word-space . 4)
 616              \doc-chars #clefs
 617 @end lilypond
 618
 619
 620 @node Time Signature glyphs
 621 @unnumberedsubsec Time Signature glyphs
 622
 623 @lilypond[quote]
 624 \include "font-table.ly"
 625 \markuplines \override-lines #'(word-space . 4)
 626              \doc-chars #timesig
 627 @end lilypond
 628
 629
 630 @node Number glyphs
 631 @unnumberedsubsec Number glyphs
 632
 633 @lilypond[quote]
 634 \include "font-table.ly"
 635 \markuplines \override-lines #'(word-space . 4)
 636              \doc-chars #numbers
 637 @end lilypond
 638
 639
 640 @node Accidental glyphs
 641 @unnumberedsubsec Accidental glyphs
 642
 643 @lilypond[quote]
 644 \include "font-table.ly"
 645 \markuplines \override-lines #'(word-space . 4)
 646              \doc-chars #accidentals
 647 @end lilypond
 648
 649
 650 @node Default Notehead glyphs
 651 @unnumberedsubsec Default Notehead glyphs
 652
 653 @lilypond[quote]
 654 \include "font-table.ly"
 655 \markuplines \override-lines #'(word-space . 4)
 656              \doc-chars #default-noteheads
 657 @end lilypond
 658
 659
 660 @node Special Notehead glyphs
 661 @unnumberedsubsec Special Notehead glyphs
 662
 663 @lilypond[quote]
 664 \include "font-table.ly"
 665 \markuplines \override-lines #'(word-space . 4)
 666              \doc-chars #special-noteheads
 667 @end lilypond
 668
 669
 670 @node Shape-note Notehead glyphs
 671 @unnumberedsubsec Shape-note Notehead glyphs
 672
 673 @lilypond[quote]
 674 \include "font-table.ly"
 675 \markuplines \override-lines #'(word-space . 4)
 676              \doc-chars #shape-note-noteheads
 677 @end lilypond
 678
 679
 680 @node Rest glyphs
 681 @unnumberedsubsec Rest glyphs
 682
 683 @lilypond[quote]
 684 \include "font-table.ly"
 685 \markuplines \override-lines #'(word-space . 4)
 686              \doc-chars #rests
 687 @end lilypond
 688
 689
 690 @node Flag glyphs
 691 @unnumberedsubsec Flag glyphs
 692
 693 @lilypond[quote]
 694 \include "font-table.ly"
 695 \markuplines \override-lines #'(word-space . 4)
 696              \doc-chars #flags
 697 @end lilypond
 698
 699
 700 @node Dot glyphs
 701 @unnumberedsubsec Dot glyphs
 702
 703 @lilypond[quote]
 704 \include "font-table.ly"
 705 \markuplines \override-lines #'(word-space . 4)
 706              \doc-chars #dots
 707 @end lilypond
 708
 709
 710 @node Dynamic glyphs
 711 @unnumberedsubsec Dynamic glyphs
 712
 713 @lilypond[quote]
 714 \include "font-table.ly"
 715 \markuplines \override-lines #'(word-space . 4)
 716              \doc-chars #dynamics
 717 @end lilypond
 718
 719
 720 @node Script glyphs
 721 @unnumberedsubsec Script glyphs
 722
 723 @lilypond[quote]
 724 \include "font-table.ly"
 725 \markuplines \override-lines #'(word-space . 4)
 726              \doc-chars #scripts
 727 @end lilypond
 728
 729
 730 @node Arrowhead glyphs
 731 @unnumberedsubsec Arrowhead glyphs
 732
 733 @lilypond[quote]
 734 \include "font-table.ly"
 735 \markuplines \override-lines #'(word-space . 4)
 736              \doc-chars #arrowheads
 737 @end lilypond
 738
 739
 740 @node Bracket-tip glyphs
 741 @unnumberedsubsec Bracket-tip glyphs
 742
 743 @lilypond[quote]
 744 \include "font-table.ly"
 745 \markuplines \override-lines #'(word-space . 4)
 746              \doc-chars #brackettips
 747 @end lilypond
 748
 749
 750 @node Pedal glyphs
 751 @unnumberedsubsec Pedal glyphs
 752
 753 @lilypond[quote]
 754 \include "font-table.ly"
 755 \markuplines \override-lines #'(word-space . 4)
 756              \doc-chars #pedal
 757 @end lilypond
 758
 759
 760 @node Accordion glyphs
 761 @unnumberedsubsec Accordion glyphs
 762
 763 @lilypond[quote]
 764 \include "font-table.ly"
 765 \markuplines \override-lines #'(word-space . 4)
 766              \doc-chars #accordion
 767 @end lilypond
 768
 769
 770 @node Vaticana glyphs
 771 @unnumberedsubsec Vaticana glyphs
 772
 773 @lilypond[quote]
 774 \include "font-table.ly"
 775 \markuplines \override-lines #'(word-space . 4)
 776              \doc-chars #vaticana
 777 @end lilypond
 778
 779
 780 @node Medicaea glyphs
 781 @unnumberedsubsec Medicaea glyphs
 782
 783 @lilypond[quote]
 784 \include "font-table.ly"
 785 \markuplines \override-lines #'(word-space . 4)
 786              \doc-chars #medicaea
 787 @end lilypond
 788
 789
 790 @node Hufnagel glyphs
 791 @unnumberedsubsec Hufnagel glyphs
 792
 793 @lilypond[quote]
 794 \include "font-table.ly"
 795 \markuplines \override-lines #'(word-space . 4)
 796              \doc-chars #hufnagel
 797 @end lilypond
 798
 799
 800 @node Mensural glyphs
 801 @unnumberedsubsec Mensural glyphs
 802
 803 @lilypond[quote]
 804 \include "font-table.ly"
 805 \markuplines \override-lines #'(word-space . 4)
 806              \doc-chars #mensural
 807 @end lilypond
 808
 809
 810 @node Neomensural glyphs
 811 @unnumberedsubsec Neomensural glyphs
 812
 813 @lilypond[quote]
 814 \include "font-table.ly"
 815 \markuplines \override-lines #'(word-space . 4)
 816              \doc-chars #neomensural
 817 @end lilypond
 818
 819
 820 @node Petrucci glyphs
 821 @unnumberedsubsec Petrucci glyphs
 822
 823 @lilypond[quote]
 824 \include "font-table.ly"
 825 \markuplines \override-lines #'(word-space . 4)
 826              \doc-chars #petrucci
 827 @end lilypond
 828
 829
 830 @node Solesmes glyphs
 831 @unnumberedsubsec Solesmes glyphs
 832
 833 @lilypond[quote]
 834 \include "font-table.ly"
 835 \markuplines \override-lines #'(word-space . 4)
 836              \doc-chars #solesmes
 837 @end lilypond
 838
 839
 840 @node Note head styles
 841 @appendixsec Note head styles
 842
 843 @cindex note head styles
 844 The following styles may be used for note heads.
 845
 846 @lilypondfile[noindent]{note-head-style.ly}
 847
 848 @include markup-commands.tely
 849
 850 @include markup-list-commands.tely
 851
 852 @node List of articulations
 853 @appendixsec List of articulations
 854
 855 @cindex accent
 856 @cindex marcato
 857 @cindex staccatissimo
 858 @cindex espressivo
 859 @cindex fermata
 860 @cindex stopped
 861 @cindex staccato
 862 @cindex portato
 863 @cindex tenuto
 864 @cindex upbow
 865 @cindex downbow
 866 @cindex foot marks
 867 @cindex organ pedal marks
 868 @cindex turn
 869 @cindex open
 870 @cindex stopped
 871 @cindex flageolet
 872 @cindex reverseturn
 873 @cindex trill
 874 @cindex prall
 875 @cindex mordent
 876 @cindex prallprall
 877 @cindex prallmordent
 878 @cindex prall, up
 879 @cindex prall, down
 880 @cindex thumb marking
 881 @cindex segno
 882 @cindex coda
 883 @cindex varcoda
 884
 885
 886 @lilypondfile[quote,texidoc]{script-chart.ly}
 887
 888
 889 @node Percussion notes
 890 @appendixsec Percussion notes
 891
 892 @lilypondfile[quote]{percussion-chart.ly}
 893
 894
 895 @node Technical glossary
 896 @appendixsec Technical glossary
 897
 898 A glossary of the technical terms and concepts used internally.
 899
 900 @menu
 901 * alist::
 902 * callback::
 903 * glyph::
 904 * grob::
 905 * interface::
 906 * lexer::
 907 * output-def::
 908 * parser::
 909 * parser variable::
 910 * prob::
 911 * simple-closure::
 912 * smob::
 913 * stencil::
 914 @end menu
 915
 916 @node alist
 917 @unnumberedsubsec alist
 918
 919 @cindex alist
 920 @cindex association list
 921
 922 An association list or @strong{alist} for short is a Scheme pair
 923 which associates a value with a key: @w{@code{(key . value)}}.  For
 924 example, in @file{scm/lily.scm}, the alist
 925 @w{@qq{type-p-name-alist}} associates certain type predicates
 926 (e.g.@tie{}@code{ly:music?}) with names (e.g.@tie{}@qq{music}) so
 927 that type-check failures can be reported with a console message that
 928 includes the name of the expected type predicate.
 929
 930 @node callback
 931 @unnumberedsubsec callback
 932
 933 @cindex callback
 934
 935 A @strong{callback} is a routine, function or method whose reference is
 936 passed as an argument in a call to another routine, so allowing
 937 the called routine to invoke it.  The technique enables a lower-
 938 level software layer to call a function defined in a higher
 939 layer.  Callbacks are used extensively in LilyPond to permit
 940 user-level Scheme code to define how many low-level actions are
 941 performed.
 942
 943 @node glyph
 944 @unnumberedsubsec glyph
 945
 946 @cindex glyph
 947 @cindex font
 948 @cindex typeface
 949
 950 A @strong{glyph} is a particular graphical representation of a typographic
 951 character, or a combination of two characters formating a ligature.
 952 A set of glyphs with a single style and shape comprise a font, and
 953 a set of fonts covering several styles and sizes comprise a typeface.
 954
 955
 956 @seealso
 957 Notation Reference:
 958 @ref{Fonts},
 959 @ref{Text encoding}.
 960
 961
 962 @node grob
 963 @unnumberedsubsec grob
 964
 965 @cindex grob
 966 @cindex layout objects
 967 @cindex graphical objects
 968
 969 LilyPond objects which represent items of notation in the printed
 970 output such as note heads, stems, slurs, ties, fingering, clefs,
 971 etc are called @q{Layout objects}, often known as @q{GRaphical
 972 OBjects}, or @strong{grobs} for short.
 973
 974
 975 @seealso
 976 Learning Manual:
 977 @rlearning{Objects and interfaces},
 978 @rlearning{Naming conventions of objects and properties},
 979 @rlearning{Properties of layout objects}.
 980
 981 Internals Reference:
 982 @rinternals{All layout objects}.
 983
 984
 985 @node interface
 986 @unnumberedsubsec interface
 987
 988 @cindex interface
 989 @cindex grob-interface
 990 @cindex graphical object interfaces
 991
 992 Actions and properties which are common to a number of grobs are
 993 grouped together in an object called a @code{grob-interface}, or
 994 just @q{interface} for short.
 995
 996
 997 @seealso
 998 Learning Manual:
 999 @rlearning{Objects and interfaces},
1000 @rlearning{Naming conventions of objects and properties},
1001 @rlearning{Properties found in interfaces}.
1002
1003 Notation Reference:
1004 @ref{Layout interfaces}.
1005
1006 Internals Reference:
1007 @rinternals{Graphical Object Interfaces}.
1008
1009
1010 @node lexer
1011 @unnumberedsubsec lexer
1012
1013 @cindex lexer
1014 @cindex Flex
1015
1016 A @strong{lexer} is a program which converts a sequence of
1017 characters into a sequence of tokens, a process called lexical
1018 analysis.  The LilyPond lexer converts the stream obtained from an
1019 input @file{.ly} file into a tokenized stream more suited to the
1020 next stage of processing - parsing, for which see @ref{parser}.
1021 The LilyPond lexer is built with Flex from the lexer file
1022 @file{lily/lexer.ll} which contains the lexical rules.  This file
1023 is part of the source code and is not included in the LilyPond
1024 binary installation.
1025
1026 @node output-def
1027 @unnumberedsubsec output-def
1028
1029 @cindex output-def
1030
1031 An instance of the @code{Output-def} class contains the methods and
1032 data structures associated with an output block.  Instances are
1033 created for midi, layout and paper blocks.
1034
1035 @node parser
1036 @unnumberedsubsec parser
1037
1038 @cindex parser
1039 @cindex Bison
1040 @cindex grammar for LilyPond
1041 @cindex BNF
1042
1043 A @strong{parser} analyzes the sequence of tokens produced by a
1044 lexer to determine its grammatical structure, grouping the tokens
1045 progressively into larger groupings according to the rules of the
1046 grammar.  If the sequence of tokens is valid the end product is a
1047 tree of tokens whose root is the grammar's start symbol.  If this
1048 cannot be achieved the file is invalid and an appropriate error
1049 message is produced.  The syntactic groupings and the rules for
1050 constructing the groupings from their parts for the LilyPond syntax
1051 are defined in @file{lily/parser.yy} and shown in Backus Normal Form
1052 (BNF) in @ref{LilyPond grammar}.  This file is used to build the
1053 parser during the program build by the parser generator, Bison.  It
1054 is part of the source code and is not included in the LilyPond
1055 binary installation.
1056
1057 @node parser variable
1058 @unnumberedsubsec parser variable
1059
1060 These are variables defined directly in Scheme.  Their direct
1061 use by users is strongly discouraged, because their scoping
1062 semantics can be confusing.
1063
1064 When the value of such a variable is changed in a @code{.ly} file,
1065 the change is global, and unless explicitly reverted, the new value
1066 will persist to the end of the file, affecting subsequent
1067 @code{\score} blocks as well as external files added with the
1068 @code{\include} command.  This can lead to unintended consequences
1069 and in complex typesetting projects the consequent errors can be
1070 difficult to track down.
1071
1072 LilyPond uses the following parser variables:
1073
1074 @itemize
1075 @item afterGraceFraction
1076 @item musicQuotes
1077 @item mode
1078 @item output-count
1079 @item output-suffix
1080 @item parseStringResult
1081 @item partCombineListener
1082 @item pitchnames
1083 @item toplevel-bookparts
1084 @item toplevel-scores
1085 @item showLastLength
1086 @item showFirstLength
1087 @end itemize
1088
1089 @node prob
1090 @unnumberedsubsec prob
1091 TODO
1092
1093 @node simple-closure
1094 @unnumberedsubsec simple-closure
1095 TODO
1096
1097 @node smob
1098 @unnumberedsubsec smob
1099 TODO
1100
1101 @node stencil
1102 @unnumberedsubsec stencil
1103 TODO
1104
1105
1106 @node All context properties
1107 @appendixsec All context properties
1108
1109 @include context-properties.tely
1110
1111
1112 @node Layout properties
1113 @appendixsec Layout properties
1114
1115 @include layout-properties.tely
1116
1117
1118 @node Available music functions
1119 @appendixsec Available music functions
1120
1121 @include identifiers.tely
1122
1123
1124 @node Scheme functions
1125 @appendixsec Scheme functions
1126
1127 @include scheme-functions.tely
1128