]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc: Added note for users in LM about \new Score
authorJames Lowe <james.lowe@datacore.com>
Tue, 5 Oct 2010 16:26:22 +0000 (17:26 +0100)
committerTrevor Daniels <t.daniels@treda.co.uk>
Tue, 5 Oct 2010 19:18:06 +0000 (20:18 +0100)
Tracker 1033

Documentation/learning/fundamental.itely

index fbd0778c84ea44685a4c89fe4d8b0100090f72f1..d6ec260df85b47da11b71950726b901c441b99bf 100644 (file)
@@ -1460,16 +1460,12 @@ where @var{type} is a context name (like @code{Staff} or
 @code{Voice}).  This command creates a new context, and starts
 interpreting the @var{music-expression} within that context.
 
-(Note that a @code{\new Score} command is not normally required,
-as the essential top-level @code{Score} context is created
-automatically when the music expression within the @code{\score}
-block is interpreted.  The only reason for creating a @code{Score}
-context explicitly using @code{\new Score} is to introduce a
-@code{\with} block in which one or more score-wide default values
-of context properties may be specified.  Information on using
-@code{\with} blocks can be found under the heading
-@qq{Setting context properties with @code{\\with} } in
-@ref{Modifying context properties}.)
+@warning{@bs{}@code{new Score} should not be used as the essential
+top-level @code{Score} context is created automatically when the music
+expression within the @bs{}@code{score} block is interpreted.  Score-wide
+default values of context properties can be changed within the
+@bs{}@code{layout} block.
+See @rlearning{Changing all contexts of the same type}}
 
 You have seen many practical examples which created new
 @code{Staff} and @code{Voice} contexts in earlier sections, but