From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Mon, 30 Aug 2010 08:22:29 +0000 (+0100)
Subject: Docs: NR 2.1 Vocal: Review References for choral
X-Git-Tag: release/2.13.32-1~16
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=e56d9ad4e09500e3d9bacab9fca2d9ecfca4b475;p=lilypond.git

Docs: NR 2.1 Vocal: Review References for choral

 - comments from Graham
 - add \voiceOne etc
---

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 156af2fa59..248f892f8b 100644
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -1367,8 +1367,9 @@ Choral music is usually notated on two, three or four staves within
 a @code{ChoirStaff} group.  Accompaniment, if required, is placed
 beneath in a @code{PianoStaff} group, which is usually reduced in
 size for @emph{a capella} choral works.  The notes for each vocal
-part are placed in a @code{Voice} context, with each either on a
-staff of its own or grouped in pairs on a single staff.
+part are placed in a @code{Voice} context, with each staff
+being given either a single vocal part (i.e., one @code{Voice}) or
+a pair of vocal parts (i.e., two @code{Voice}s).
 
 Words are placed in @code{Lyrics} contexts, either underneath each
 corresponding music staff, or one above and one below the music
@@ -1395,17 +1396,28 @@ For information about @code{ChoirStaff} and @code{PianoStaff} see
 Shape noteheads, as used in Sacred Harp and similar notation, are
 described in @ref{Shape note heads}.
 
+@item
+When two vocal parts share a staff the stems, ties, slurs, etc., of
+the higher part will be directed up and those of the lower part
+down.  To do this, use @code{\voiceOne} and @code{\voiceTwo}.  See
+@ref{Single-staff polyphony}.
+
 @end itemize
 
+@predefined
+@code{\voiceOne},
+@code{\voiceTwo}.
+
 @seealso
 Learning Manual:
 @rlearning{Four-part SATB vocal score},
 @rlearning{Vocal ensembles}.
 
 Notation Reference:
-@ref{Grouping staves},
 @ref{Context layout order},
-@ref{Shape note heads}.
+@ref{Grouping staves},
+@ref{Shape note heads},
+@ref{Single-staff polyphony}.
 
 Internals Reference:
 @rinternals{ChoirStaff},