X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fchanging-defaults.itely;h=edc5545759820ff4d39e2a623eac8a5a3117267e;hb=5a46a0878f5d8b89dd60280af3293e19e782b6f7;hp=2dc41815d7b503d48866c0f211ff9e37ed39bc63;hpb=452061ad2abca6da1d99413777be32891c2db3e1;p=lilypond.git diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely index 2dc41815d7..edc5545759 100644 --- a/Documentation/user/changing-defaults.itely +++ b/Documentation/user/changing-defaults.itely @@ -7,7 +7,7 @@ version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.61" +@c \version "2.11.65" @node Changing defaults @chapter Changing defaults @@ -108,7 +108,7 @@ further explanation and with links to the IR. @c TODO Describe propagation of property values -td -Contexts are arranged heirarchically: +Contexts are arranged hierarchically: @menu * Score - the master of all contexts:: @@ -138,67 +138,55 @@ executed. Groups staves while adding a bracket on the left side, grouping the staves together. The bar lines of the contained staves are -connected vertically. StaffGroup only consists of a collection +connected vertically. @code{StaffGroup} only consists of a collection of staves, with a bracket in front and spanning bar lines. @strong{@emph{ChoirStaff}} -Identical to StaffGroup except that the bar lines of the contained -staves are not connected vertically. +Identical to @code{StaffGroup} except that the bar lines of the +contained staves are not connected vertically. @strong{@emph{GrandStaff}} -A group of staves, with a brace on the left side, grouping -the staves together. The bar lines of the contained staves are +A group of staves, with a brace on the left side, grouping the +staves together. The bar lines of the contained staves are connected vertically. @strong{@emph{PianoStaff}} -@c TODO No longer correct? Check. -td -Just like GrandStaff but with a forced distance between the -staves, so cross staff beaming and slurring can be used. - -@ignore -@strong{@emph{InnerStaffGroup}} - -TODO -td - -@strong{@emph{InnerChoirStaff}} - -TODO -td - -@end ignore +Just like @code{GrandStaff}, but with support for instrument names +to the left of each system. @node Intermediate-level contexts - staves @unnumberedsubsubsec Intermediate-level contexts - staves @strong{@emph{Staff}} -Handles clefs, bar lines, keys, accidentals. It can contain -Voice contexts. +Handles clefs, bar lines, keys, accidentals. It can contain +@code{Voice} contexts. @strong{@emph{RhythmicStaff}} -Like Staff but for printing rhythms. Pitches are ignored; +Like @code{Staff} but for printing rhythms. Pitches are ignored; the notes are printed on one line. @strong{@emph{TabStaff}} -Context for generating tablature. By default lays the music +Context for generating tablature. By default lays the music expression out as a guitar tablature, printed on six lines. @strong{@emph{DrumStaff}} -Handles typesetting for percussion. Can contain DrumVoice +Handles typesetting for percussion. Can contain @code{DrumVoice} @strong{@emph{VaticanaStaff}} -Same as Staff, except that it is designed for typesetting +Same as @code{Staff}, except that it is designed for typesetting a piece in gregorian style. @strong{@emph{MensuralStaff}} -Same as Staff, except that it is designed for typesetting +Same as @code{Staff}, except that it is designed for typesetting a piece in mensural style. @node Bottom-level contexts - voices @@ -210,24 +198,24 @@ contain other contexts. @strong{@emph{Voice}} -Corresponds to a voice on a staff. This context handles the +Corresponds to a voice on a staff. This context handles the conversion of dynamic signs, stems, beams, super- and sub-scripts, slurs, ties, and rests. You have to instantiate this explicitly if you require multiple voices on the same staff. @strong{@emph{VaticanaVoice}} -Same as Voice, except that it is designed for typesetting a piece -in gregorian style. +Same as @code{Voice}, except that it is designed for typesetting +a piece in gregorian style. @strong{@emph{MensuralVoice}} -Same as Voice, with modifications for typesetting a piece in +Same as @code{Voice}, with modifications for typesetting a piece in mensural style. @strong{@emph{Lyrics}} -Corresponds to a voice with lyrics. Handles the printing of a +Corresponds to a voice with lyrics. Handles the printing of a single line of lyrics. @strong{@emph{DrumVoice}} @@ -236,13 +224,13 @@ The voice context used in a percussion staff. @strong{@emph{FiguredBass}} -The context in which BassFigure objects are created from +The context in which @code{BassFigure} objects are created from input entered in @code{\figuremode} mode. @strong{@emph{TabVoice}} -The voice context used within a TabStaff context. Usually left to -be created implicitly. +The voice context used within a @code{TabStaff} context. Usually +left to be created implicitly. @strong{@emph{ChordNames}} @@ -1267,7 +1255,7 @@ properties. To tweak those, use commands of the form such as @example -\override Stem #'details #'beamed-lengths = #'(4 4 3) +\override Stem #'(details beamed-lengths) = #'(4 4 3) @end example @@ -1434,7 +1422,7 @@ Some tweakable options are called @q{subproperties} and reside inside properties. To tweak those, use commands in the form @example -\override Stem #'details #'beamed-lengths = #'(4 4 3) +\override Stem #'(details beamed-lengths) = #'(4 4 3) @end example @cindex internal documentation @@ -2114,8 +2102,8 @@ the @code{\override} command is quite simple: @lilypond[relative=2,quote,verbatim] e2 \glissando b -\once \override Glissando #'bound-details #'left #'Y = #3 -\once \override Glissando #'bound-details #'right #'Y = #-2 +\once \override Glissando #'(bound-details left Y) = #3 +\once \override Glissando #'(bound-details right Y) = #-2 e2 \glissando b @end lilypond @@ -2134,7 +2122,7 @@ sub-lists of @code{bound-details}. For example: @lilypond[relative=2,ragged-right,verbatim,fragment] \override Glissando #'breakable = ##t -\override Glissando #'bound-details #'right-broken #'Y = #-3 +\override Glissando #'(bound-details right-broken Y) = #-3 c1 \glissando \break f1 @end lilypond @@ -2174,7 +2162,7 @@ This is a markup that is evaluated to yield the stencil. It is used to put @i{cresc.}, @i{tr} and other text on horizontal spanners. @lilypond[quote,ragged-right,fragment,relative=2,verbatim] -\override TextSpanner #'bound-details #'left #'text +\override TextSpanner #'(bound-details left text) = \markup { \small \bold Slower } c2\startTextSpan b c a\stopTextSpan @end lilypond @@ -2188,15 +2176,15 @@ or @code{stencil-offset} will move the symbol at the edge vertically relative to the end point of the line: @lilypond[relative=1,fragment,verbatim] -\override TextSpanner #'bound-details - #'left #'stencil-align-dir-y = #-2 -\override TextSpanner #'bound-details - #'right #'stencil-align-dir-y = #UP - -\override TextSpanner #'bound-details - #'left #'text = #"ggg" -\override TextSpanner #'bound-details - #'right #'text = #"hhh" +\override TextSpanner + #'(bound-details left stencil-align-dir-y) = #-2 +\override TextSpanner + #'(bound-details right stencil-align-dir-y) = #UP + +\override TextSpanner + #'(bound-details left text) = #"ggg" +\override TextSpanner + #'(bound-details right text) = #"hhh" c4^\startTextSpan c c c \stopTextSpan @end lilypond @@ -2620,7 +2608,7 @@ override these: @c FIXME Complete @lilypond[relative=2,ragged-right,verbatim,fragment] e2 \glissando f -\once \override Glissando #'bound-details #'right #'Y = #-2 +\once \override Glissando #'(bound-details right Y) = #-2 e2 \glissando f @end lilypond