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

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index 846a27443a10c49d8f3a7dbdfcfee2de5abb0c6c..c0513c61ac8ba60f4db54a2f47159c0af57c6576 100644 (file)
--- 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 fa5b58f2b5daa20d0b5bbad397ce03f427757de9..08817cb519e9e0807e8c64ebd6de18c2feec6ceb 100644 (file)
--- 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}.