Reviewers: Trevor Daniels,
Message:
new patch uploaded
http://codereview.appspot.com/5754074/diff/1/Documentation/notation/changing-defaults.itely
File Documentation/notation/changing-defaults.itely (right):
http://codereview.appspot.com/5754074/diff/1/Documentation/notation/changing-defaults.itely#newcode2322
Documentation/notation/changing-defaults.itely:2322: @code{voice} than
changing an object's direction. For more information.
On 2012/03/11 15:27:56, Trevor Daniels wrote:
nitpick: 'than to change an' (use infinitive to match 'to specify')
Done.
Description:
Doc: NR: Polyphony - use voiceX not \xxxup/down
Issue 2388
NR 5.4.2
Explain that it is preferable to use \VoiceOne/Two etc, instead of
\xxxUp/Down/Neutral to specify object direction.
Added @seealso section, some inconsistency in syntax and formatting
cleaned
up.
Please review this at http://codereview.appspot.com/5754074/
Affected files:
M Documentation/notation/changing-defaults.itely
Index: Documentation/notation/changing-defaults.itely
diff --git a/Documentation/notation/changing-defaults.itely
b/Documentation/notation/changing-defaults.itely
index
fb19a18e387dd9c586547899a2c20b0bdeeb38e6..1e864ed069b9b5ee6d3c378d93f775621ddabd86
100644
--- a/Documentation/notation/changing-defaults.itely
+++ b/Documentation/notation/changing-defaults.itely
@@ -2274,31 +2274,29 @@ c2^( c)
@strong{The direction property}
-The position or direction of many layout objects is controlled
-by the @code{direction} property.
-
-The value of the @code{direction} property may be
-set to @code{1}, meaning @qq{up} or @qq{above}, or to @w{@code{-1}},
-meaning @qq{down} or @qq{below}. The symbols @code{UP} and
-@code{DOWN} may be used instead of @code{1} and @w{@code{-1}}
-respectively. The default direction may be specified by setting
-@code{direction} to @code{0} or @code{CENTER}. Alternatively,
-in many cases predefined commands
-exist to specify the direction. These are all of the form
+The position or direction of many layout objects is controlled by the
+@code{direction} property.
+
+The value of the @code{direction} property may be set to @code{1},
+meaning @qq{up} or @qq{above}, or to @w{@code{-1}}, meaning @qq{down} or
+@qq{below}. The symbols @code{UP} and @code{DOWN} may be used instead
+of @code{1} and @w{@code{-1}} respectively. The default direction may
+be specified by setting @code{direction} to @code{0} or @code{CENTER}.
+Alternatively, in many cases predefined commands exist to specify the
+direction. These are of the form
@noindent
-@code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
+@code{\xxxUp}, @code{\xxxDown} or @code{\xxxNeutral}
@noindent
-where @code{xxxNeutral} means @qq{use the default direction}.
+where @code{\xxxNeutral} means @qq{use the default} direction.
See @rlearning{Within-staff objects}.
-In a few cases, arpeggio being the only common example, the value
-of the @code{direction} property specifies whether the object
-is to be placed to the right or left of the parent object. In
-this case @w{@code{-1}} or @code{LEFT} means @qq{to the left} and
-@code{1} or @code{RIGHT} means @qq{to the right}. @code{0}
-or @code{CENTER} means @qq{use the default} direction, as before.
+In a few cases, arpeggio for example, the value of the @code{direction}
+property can specify whether the object is to be placed to the right or
+left of the parent. In this case @w{@code{-1}} or @code{LEFT} means
+@qq{to the left} and @code{1} or @code{RIGHT} means @qq{to the right}.
+@code{0} or @code{CENTER} means @qq{use the default} direction.
@ignore
These all have side-axis set to #X
@@ -2320,6 +2318,17 @@ c2( c)
c2( c)
@end lilypond
+In polyphonic music, it is generally better to specify an explicit
+@code{voice} than change an object's direction. For more information.
+See @ref{Multiple voices}.
+
+@seealso
+Learning Manual:
+@rlearning{Within-staff objects}.
+
+Notation Reference:
+@ref{Multiple voices}.
+
@node Distances and measurements
@subsection Distances and measurements
_______________________________________________
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel
