From 27661bd698d2f501ee621beb598dd9a3b48cdbb2 Mon Sep 17 00:00:00 2001 From: Trevor Daniels Date: Sun, 15 Jan 2017 17:47:54 +0000 Subject: [PATCH] Doc: Issue 5032: Using \with with \chords, \drums and \figures Document the use of \with with the short forms of the input-mode-specifying commands. --- .../notation/changing-defaults.itely | 26 +++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/Documentation/notation/changing-defaults.itely b/Documentation/notation/changing-defaults.itely index c8f9ebc510..8457f6dba0 100644 --- a/Documentation/notation/changing-defaults.itely +++ b/Documentation/notation/changing-defaults.itely @@ -1005,8 +1005,26 @@ command: @} @end example -Since such a @q{context modification} is specified inside of -music, it will affect @emph{all} outputs (typesetting @emph{and} +Alternatively, if the music is being entered using the short form of the +input mode-specifying commands, e.g. @code{\chords} rather than +@code{\chordmode}, the @code{\with} command must be placed immediately +after the mode-specifying command: + +@example +\chords \with @{ [context settings for this (implicit) context instance only] @} +@{ + @dots{} +@} +@end example + +@noindent +as it is the implicit context created by these short forms which should +be modified. The same consideration applies to the other input +mode-specifying short forms (@code{\drums}, @code{\figures}), see +@ref{Input modes}. + +Since context modifications specified in @code{\with} blocks are inside +music, they will affect @emph{all} outputs (typesetting @emph{and} Midi) as opposed to changes within an output definition. The following types of settings may be specified: @@ -1082,6 +1100,10 @@ A predefined command such as @code{\dynamicUp} @end itemize +@seealso +Notation Reference: +@ref{Input modes} + @node Order of precedence @unnumberedsubsubsec Order of precedence -- 2.39.2