From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Fri, 1 Oct 2010 21:39:19 +0000 (+0100)
Subject: Doc: clarify use of durations with \skip
X-Git-Tag: release/2.13.36-1~71^2~8^2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=df359b39d28604e7060c54be8caaba0e45d1b94e;p=lilypond.git

Doc: clarify use of durations with \skip
---

diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely
index 5ff676c0b7..e0321d3058 100644
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -703,7 +703,9 @@ s2 c
 Spacer rests are available only in note mode and chord mode.  In
 other situations, for example, when entering lyrics, the
 command @code{\skip} is used to skip a musical moment.
-@code{\skip} requires an explicit duration.
+@code{\skip} requires an explicit duration, but this is ignored if
+the lyrics derive their durations from the notes in an associated
+melody through @code{\addlyrics} or @code{\lyricsto}.
 
 @lilypond[quote,verbatim,relative=2]
 <<
diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 7a3fce6c41..d4f84c28e3 100644
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -532,9 +532,11 @@ inserted by hand.
 
 Making a lyric line run slower than the melody can be achieved by
 inserting @code{\skip}s into the lyrics.  For every @code{\skip},
-the text will be delayed another note.  The @code{\skip} command
+the text will be delayed by another note.  The @code{\skip} command
 must be followed by a valid duration, but this is ignored when
-@code{\skip} is used in lyrics.
+@code{\skip} is used in lyrics which derive their durations from the
+notes in an associated melody through @code{\addlyrics} or
+@code{\lyricsto}.
 
 @lilypond[verbatim,ragged-right,quote]
 \relative c' { c c g' }
@@ -796,9 +798,10 @@ indicates a melisma and will cause the preceding syllable to be
 left-aligned.
 
 @warning{The @code{@bs{}skip} command must be followed by a number,
-but this number is ignored in lyric mode.  Each @code{@bs{}skip}
-skips a single note of any value, irrespective of the value of the
-following number.}
+but this number is ignored in lyrics which derive their durations
+from the notes in an associated melody through @code{\addlyrics} or
+@code{\lyricsto}.  Each @code{@bs{}skip} skips a single note of any
+value, irrespective of the value of the following number.}
 
 @lilypond[verbatim,quote]
 \score {