]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/learning/tweaks.itely
Issue 5167/6: Changes: show \markup xxx = ... \etc assignments
[lilypond.git] / Documentation / learning / tweaks.itely
index d5d5951b1255d811a58b441252088d33ebba2bc3..b014ee5b47146d0feb11d6e98a555fcc0628f6bb 100644 (file)
@@ -109,7 +109,7 @@ shape.  Objects with an extended shape like these are called
 
 Spanners cannot be tweaked after their creation.  This includes both
 @code{StaffSymbol} and @code{LedgerLineSpanner} which continue
-throughout the score (except if they are terminated by the
+throughout the scoreexcept if they are terminated by the
 @code{\stopStaff} command and then recreated using @code{\startStaff}
 command.
 
@@ -207,7 +207,6 @@ Notation Reference:
 @cindex override syntax
 
 @funindex \override
-@funindex override
 
 We have already met the commands @code{\set} and @code{\with}, used to
 change the properties of @strong{contexts} and to remove and add
@@ -280,7 +279,6 @@ color of the note head:
 @cindex revert command
 
 @funindex \revert
-@funindex revert
 
 Once overridden, the property retains its new value until it is
 overridden again or a @code{\revert} command is encountered.
@@ -318,9 +316,8 @@ of the note head to the default value for the final two notes:
 @unnumberedsubsubsec The @code{@bs{}once} prefix
 
 @funindex \once
-@funindex once
 
-@code{\override}, @code{\revert}. @code{\set}, and @code{\unset}
+@code{\override}, @code{\revert}, @code{\set}, and @code{\unset}
 commands may be prefixed with @code{\once}.  This causes such a
 command to be effective only during the current musical
 moment before the property reverts back to its previous value (this can
@@ -365,7 +362,6 @@ predefined commands to limit their effect to one musical moment:
 @cindex overrideProperty command
 
 @funindex \overrideProperty
-@funindex overrideProperty
 
 There is another form of the override command,
 @code{\overrideProperty}, which is occasionally required.
@@ -380,7 +376,6 @@ We mention it here for completeness, but for details see
 @cindex tweak command
 
 @funindex \tweak
-@funindex tweak
 
 The final tweaking command which is available is @code{\tweak}.  This
 should be used when several objects occur at the same musical moment,
@@ -697,9 +692,9 @@ through them looking for a property that might control the heaviness of
 slurs, and you should find
 
 @example
-@code{thickness} (number)
-     @code{1.2}
-     Line thickness, generally measured in @code{line-thickness}
+thickness (number)
+     1.2
+     Line thickness, generally measured in line-thickness
 @end example
 
 This looks a good bet to change the heaviness.  It tells us that
@@ -787,7 +782,6 @@ location.
 @cindex once override
 
 @funindex \once
-@funindex once
 
 As you can see, @emph{all} the slurs are thicker in the final example
 above.  But what if we wanted just the first slur to be thicker?  This
@@ -832,7 +826,6 @@ command.
 @cindex default properties, reverting to
 
 @funindex \revert
-@funindex revert
 
 Finally, what if we wanted just the first two slurs to be
 heavier?  Well, we could use two commands, each preceded by
@@ -2061,7 +2054,7 @@ individual notes in a chord is possible by using the
 command is:
 
 @example
-@code{\set fingeringOrientations = #'([up] [left/right] [down])}
+\set fingeringOrientations = #'([up] [left/right] [down])
 @end example
 
 @noindent
@@ -2179,7 +2172,7 @@ change @code{outside-staff-priority} of the associated
 placed at the start of the spanner, which might include several
 linked hairpins and dynamics.
 
-@multitable @columnfractions .3 .3 .3
+@multitable @columnfractions .3 .15 .45
 @headitem Layout Object
   @tab Priority
   @tab Controls position of:
@@ -2189,15 +2182,33 @@ linked hairpins and dynamics.
 @item @code{MetronomeMark}
   @tab @code{1000}
   @tab Metronome marks
+@item @code{SostenutoPedalLineSpanner}
+  @tab @code{1000}
+  @tab Pedal indication
+@item @code{SustainPedalLineSpanner}
+  @tab @code{1000}
+  @tab
+@item @code{UnaCordaPedalLineSpanner}
+  @tab @code{1000}
+  @tab
+@item @code{MeasureCounter}
+  @tab @code{750}
+  @tab Measure number
 @item @code{VoltaBracketSpanner}
   @tab @code{600}
   @tab Volta brackets
+@item @code{InstrumentSwitch}
+  @tab @code{500}
+  @tab Instrument switch text
 @item @code{TextScript}
   @tab @code{450}
   @tab Markup text
 @item @code{MultiMeasureRestText}
   @tab @code{450}
-  @tab Markup text over full-bar rests
+  @tab Markup text over multimeasure rests
+@item @code{CombineTextScript}
+  @tab @code{450}
+  @tab Part-combine text
 @item @code{OttavaBracket}
   @tab @code{400}
   @tab Ottava brackets
@@ -2208,11 +2219,14 @@ linked hairpins and dynamics.
   @tab @code{250}
   @tab All dynamic markings
 @item @code{BarNumber}
-  @tab @code{ 100}
+  @tab @code{100}
   @tab Bar numbers
 @item @code{TrillSpanner}
   @tab @code{50}
   @tab Spanning trills
+@item @code{AccidentalSuggestion}
+  @tab @code{0}
+  @tab Annotational accidentals
 @end multitable
 
 Here is an example showing the default placement of some of
@@ -2222,9 +2236,7 @@ these.
 @cindex ottava bracket
 
 @funindex \startTextSpan
-@funindex startTextSpan
 @funindex \stopTextSpan
-@funindex stopTextSpan
 
 @cindex TextSpanner, example of overriding
 @cindex bound-details property, example
@@ -2272,7 +2284,7 @@ the placing you want, the priority of any of the objects may be
 overridden.  Suppose we would like the ottava bracket to be placed
 below the text spanner in the example above.  All we need to do is to
 look up the priority of @code{OttavaBracket} in the IR or in the
-tables above, and reduce it to a value lower than that of a
+table above, and reduce it to a value lower than that of a
 @code{TextSpanner}, remembering that @code{OttavaBracket} is created
 in the @code{Staff} context:
 
@@ -2372,9 +2384,7 @@ command.
 @cindex notes, spreading out with text
 
 @funindex \textLengthOn
-@funindex textLengthOn
 @funindex \textLengthOff
-@funindex textLengthOff
 
 By default, text produced by markup takes up no horizontal space
 as far as laying out the music is concerned.  The @code{\textLengthOn}
@@ -2885,13 +2895,9 @@ and notes in different voices.
 @cindex collisions, notes
 @cindex shift commands
 @funindex \shiftOff
-@funindex shiftOff
 @funindex \shiftOn
-@funindex shiftOn
 @funindex \shiftOnn
-@funindex shiftOnn
 @funindex \shiftOnnn
-@funindex shiftOnnn
 
 Within a voice, all the notes occuring at the same musical moment are
 grouped into a note column, and a @code{NoteColumn} object is created
@@ -4060,11 +4066,11 @@ themselves prevents their use in simple variables.  As an
 alternative can we use @code{\override} and @code{\revert} commands?
 
 @example
-@code{\override Lyrics.LyricText.font-shape = #'italic}
-@code{\override Lyrics.LyricText.font-series = #'bold}
+\override Lyrics.LyricText.font-shape = #'italic
+\override Lyrics.LyricText.font-series = #'bold
 
-@code{\revert Lyrics.LyricText.font-shape}
-@code{\revert Lyrics.LyricText.font-series}
+\revert Lyrics.LyricText.font-shape
+\revert Lyrics.LyricText.font-series
 @end example
 
 These would also be extremely tedious to enter if there were many