From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Tue, 17 Feb 2009 16:00:12 +0000 (+0000)
Subject: Docs: NR 2.1, 2.2: link to Keeping contexts alive
X-Git-Tag: release/2.13.0-0~26
X-Git-Url: https://git.donarmstrong.com/lilypond.git?a=commitdiff_plain;h=8c8d80c09f0acdb886ff7eefc22b3be428bdc5b7;p=lilypond.git

Docs: NR 2.1, 2.2: link to Keeping contexts alive
---

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index 846a27443a..c0513c61ac 100644
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -168,6 +168,10 @@ the current voice from its current staff to the staff called
 @var{staffname}.  Typical values for @var{staffname} are
 @code{"up"} and @code{"down"}, or @code{"RH"} and @code{"LH"}.
 
+The staff to which the voice is being switched must exist at the
+time of the switch.  If necessary, staves should be @qq{kept alive},
+see @ref{Keeping contexts alive}.
+
 Cross-staff notes are beamed automatically:
 
 @lilypond[verbatim,quote]
@@ -203,7 +207,8 @@ Learning Manual:
 
 Notation Reference:
 @ref{Stems},
-@ref{Automatic beams}.
+@ref{Automatic beams},
+@ref{Keeping contexts alive}.
 
 Snippets:
 @rlsr{Keyboards}.
diff --git a/Documentation/user/vocal.itely b/Documentation/user/vocal.itely
index fa5b58f2b5..08817cb519 100644
--- a/Documentation/user/vocal.itely
+++ b/Documentation/user/vocal.itely
@@ -468,6 +468,13 @@ or by specifying the duration of each syllable
 explicitly, using @code{\lyricmode}
 @end itemize
 
+The @code{Voice} context containing the melody to which the lyrics
+are being aligned must not have @qq{died}, or the lyrics after that
+point will be lost.  This can happen if there are periods when that
+voice has nothing to do.  For methods of keeping contexts alive, see
+@ref{Keeping contexts alive}.
+
+
 @menu
 * Automatic syllable durations::
 * Manual syllable durations::
@@ -580,6 +587,9 @@ Here is an example demonstrating manual lyric durations,
 
 
 @seealso
+Notation Reference:
+@ref{Keeping contexts alive}.
+
 Internals Reference:
 @rinternals{Lyrics}.