Re: Doc: NR: Polyphony - use voiceX not \xxxup/down (issue 5754074)

[pkx166h]

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 @address@hidden,
-meaning @qq{down} or @qq{below}.  The symbols @code{UP} and
address@hidden may be used instead of @code{1} and @address@hidden
-respectively.  The default direction may be specified by setting
address@hidden 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
address@hidden property.
+
+The value of the @code{direction} property may be set to @code{1},
+meaning @qq{up} or @qq{above}, or to @address@hidden, meaning @qq{down} or
address@hidden  The symbols @code{UP} and @code{DOWN} may be used instead
+of @code{1} and @address@hidden 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
address@hidden, @code{xxxDown}, @code{xxxNeutral}
address@hidden, @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 @address@hidden or @code{LEFT} means @qq{to the left} and
address@hidden 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 @address@hidden or @code{LEFT} means
address@hidden the left} and @code{1} or @code{RIGHT} means @qq{to the right}.
address@hidden 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
address@hidden than change an object's direction.  For more information.
+See @ref{Multiple voices}.
+
address@hidden
+Learning Manual:
address@hidden objects}.
+
+Notation Reference:
address@hidden voices}.
+

 @node Distances and measurements
 @subsection Distances and measurements