X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fnotation-appendices.itely;h=0669a5933e35c637147f27b3eeb5cf3409d634b4;hb=1b832d794f1444033f10465971e97d33f76fe310;hp=801cd923e3e09a216ebb85dcd75a21da2c5f4bcc;hpb=578994684826bc66b9e1e3156d454a98a3c25232;p=lilypond.git diff --git a/Documentation/notation/notation-appendices.itely b/Documentation/notation/notation-appendices.itely index 801cd923e3..0669a5933e 100644 --- a/Documentation/notation/notation-appendices.itely +++ b/Documentation/notation/notation-appendices.itely @@ -4,32 +4,15 @@ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH When revising a translation, copy the HEAD committish of the - version that you are working on. See TRANSLATION for details. + version that you are working on. For details, see the Contributors' + Guide, node Updating translation committishes.. @end ignore -@c \version "2.12.0" +@c \version "2.13.36" @node Notation manual tables @appendix Notation manual tables -@c Please do not delete the following @ignore block. -@ignore -Note for editors and translators: In the following menu, two entries -are needed to link to a pair of automatically generated sections. -Please keep them and, if using emacs, do not run -texinfo-all-menus-update without manually restoring them back. These -menu entries are: - -* Text markup commands:: -* Text markup list commands:: - -and they should go just after -* Note head styles:: - -and just before -* List of articulations:: -@end ignore - @menu * Chord name chart:: * Common chord modifiers:: @@ -46,6 +29,7 @@ and just before * All context properties:: * Layout properties:: * Available music functions:: +* Predefined type predicates:: * Scheme functions:: @end menu @@ -212,11 +196,11 @@ Minor-major seventh @tab Minor triad, major seventh @tab -@code{maj7.5-} +@code{m7+} @tab @lilypond[line-width=3\cm,noragged-right, notime] \chordmode { - c1:maj7.5- + c1:m7+ } @end lilypond @@ -402,21 +386,54 @@ Perfect fourth, perfect fifth } @end lilypond +@item +Power chord (two-voiced) +@tab +Perfect fifth +@tab +@code{1.5} +@tab +@lilypond[line-width=3\cm,noragged-right, notime] +\chordmode { + \powerChords + c1:1.5 +} +@end lilypond + +@item +Power chord (three-voiced) +@tab +Perfect fifth, octave +@tab +@code{1.5.8} +@tab +@lilypond[line-width=3\cm,noragged-right, notime] +\chordmode { + \powerChords + c1:1.5.8 +} +@end lilypond @end multitable @node Predefined fretboard diagrams @appendixsec Predefined fretboard diagrams -The chart below shows the predefined fretboard diagrams. +The chart below shows the predefined fretboard diagrams for guitar. @lilypondfile{display-predefined-fretboards.ly} +The chart below shows the predefined fretboard diagrams for ukulele. + +@lilypondfile{display-predefined-ukulele-fretboards.ly} + @node MIDI instruments @appendixsec MIDI instruments The following is a list of names that can be used for the -@code{midiInstrument} property. +@code{midiInstrument} property. The order of the instruments +below, starting in the left-hand column moving down, corresponds +to the General MIDI Standard's 128 Program Numbers. @example acoustic grand contrabass lead 7 (fifths) @@ -845,45 +862,142 @@ The following styles may be used for note heads. @lilypondfile[noindent]{note-head-style.ly} + +@node Text markup commands +@appendixsec Text markup commands + @include markup-commands.tely + +@node Text markup list commands +@appendixsec Text markup list commands + +The following commands can all be used with @code{\markuplines}: + @include markup-list-commands.tely + @node List of articulations @appendixsec List of articulations + @cindex accent -@cindex marcato -@cindex staccatissimo +@cindex accentus +@cindex circulus +@cindex coda +@cindex downbow +@cindex downmordent +@cindex downprall @cindex espressivo @cindex fermata -@cindex stopped -@cindex staccato -@cindex portato -@cindex tenuto -@cindex upbow -@cindex downbow -@cindex foot marks -@cindex organ pedal marks -@cindex turn -@cindex open -@cindex stopped @cindex flageolet -@cindex reverseturn -@cindex trill -@cindex prall +@cindex halfopen +@cindex ictus +@cindex lheel +@cindex lineprall +@cindex longfermata +@cindex ltoe +@cindex marcato @cindex mordent -@cindex prallprall +@cindex open +@cindex portato +@cindex prall +@cindex pralldown @cindex prallmordent -@cindex prall, up -@cindex prall, down -@cindex thumb marking +@cindex prallprall +@cindex prallup +@cindex reverseturn +@cindex rheel +@cindex rtoe @cindex segno -@cindex coda +@cindex semicirculus +@cindex shortfermata +@cindex signumcongruentiae +@cindex snappizzicato +@cindex staccatissimo +@cindex staccato +@cindex stopped +@cindex tenuto +@cindex thumb +@cindex trill +@cindex turn +@cindex upbow +@cindex upmordent +@cindex upprall @cindex varcoda +@cindex verylongfermata + +The following scripts are available in the Feta font and may be +attached to notes (eg. @samp{c\accent}). + +@c Articulations and ornamentations +@c Fingering instructions (for "thumb") +@c Common notation for unfretted strings +@c Bowing indications +@c Harmonics +@c Snap (Bartók) pizzicato +@c Custom percussion staves (for "halfopen" -- not yet funindexed) +@c References for wind instruments (for "open"/"stopped" -- not yet funindexed) -@lilypondfile[quote,texidoc]{script-chart.ly} +@menu +* Articulation scripts:: +* Ornament scripts:: +* Fermata scripts:: +* Instrument-specific scripts:: +* Repeat sign scripts:: +* Ancient scripts:: +@end menu + + +@node Articulation scripts +@unnumberedsubsec Articulation scripts + +@lilypond[quote] +\include "script-chart.ly" +\new RhythmicStaff { \scriptStaff #articulations } +@end lilypond + +@node Ornament scripts +@unnumberedsubsec Ornament scripts + +@lilypond[quote] +\include "script-chart.ly" +\new RhythmicStaff { \scriptStaff #ornaments } +@end lilypond + +@node Fermata scripts +@unnumberedsubsec Fermata scripts + +@lilypond[quote] +\include "script-chart.ly" +\new RhythmicStaff { \scriptStaff #fermatas } +@end lilypond + +@node Instrument-specific scripts +@unnumberedsubsec Instrument-specific scripts + +@lilypond[quote] +\include "script-chart.ly" +\new RhythmicStaff { \scriptStaff #instrument-specific } +@end lilypond + +@node Repeat sign scripts +@unnumberedsubsec Repeat sign scripts + +@lilypond[quote] +\include "script-chart.ly" +\new RhythmicStaff { \scriptStaff #repeats } +@end lilypond + +@node Ancient scripts +@unnumberedsubsec Ancient scripts + +@lilypond[quote] +\include "script-chart.ly" +\include "gregorian.ly" +\new VaticanaStaff { \scriptStaffAncient #ancient } +@end lilypond @node Percussion notes @@ -926,7 +1040,7 @@ or in the source code. An association list or @strong{alist} for short is a Scheme pair which associates a value with a key: @w{@code{(key . value)}}. For -example, in @file{scm/lily.scm}, the alist +example, in @file{scm/@/lily@/.scm}, the alist @w{@qq{type-p-name-alist}} associates certain type predicates (e.g.@tie{}@code{ly:music?}) with names (e.g.@tie{}@qq{music}) so that type-check failures can be reported with a console message that @@ -1067,10 +1181,10 @@ Internals Reference: A @strong{lexer} is a program which converts a sequence of characters into a sequence of tokens, a process called lexical analysis. The LilyPond lexer converts the stream obtained from an -input @file{.ly} file into a tokenized stream more suited to the +input @file{@/.ly} file into a tokenized stream more suited to the next stage of processing - parsing, for which see @ref{parser}. The LilyPond lexer is built with Flex from the lexer file -@file{lily/lexer.ll} which contains the lexical rules. This file +@file{lily/@/lexer@/.ll} which contains the lexical rules. This file is part of the source code and is not included in the LilyPond binary installation. @@ -1119,7 +1233,7 @@ tree of tokens whose root is the grammar's start symbol. If this cannot be achieved the file is invalid and an appropriate error message is produced. The syntactic groupings and the rules for constructing the groupings from their parts for the LilyPond syntax -are defined in @file{lily/parser.yy} and shown in Backus Normal Form +are defined in @file{lily/@/parser@/.yy} and shown in Backus Normal Form (BNF) in @ref{LilyPond grammar}. This file is used to build the parser during the program build by the parser generator, Bison. It is part of the source code and is not included in the LilyPond @@ -1149,7 +1263,7 @@ These are variables defined directly in Scheme. Their direct use by users is strongly discouraged, because their scoping semantics can be confusing. -When the value of such a variable is changed in a @code{.ly} file, +When the value of such a variable is changed in a @file{@/.ly} file, the change is global, and unless explicitly reverted, the new value will persist to the end of the file, affecting subsequent @code{\score} blocks as well as external files added with the @@ -1208,7 +1322,7 @@ smobs are created from C++ objects through macros. There are two types of smob objects: simple smobs, intended for simple immutable objects like numbers, and complex smobs, used for objects with identities. If you have access to the LilyPond sources, more -information can be found in @file{lily/includes/smob.hh}. +information can be found in @file{lily/@/includes/@/smob@/.hh}. @node stencil @unnumberedsubsec stencil @@ -1250,6 +1364,12 @@ Internals Reference: @include identifiers.tely +@node Predefined type predicates +@appendixsec Predefined type predicates + +@include type-predicates.tely + + @node Scheme functions @appendixsec Scheme functions