From 5ea293832eaaa5ae284c8515f255167f8f2881cd Mon Sep 17 00:00:00 2001 From: David Kastrup Date: Sun, 3 Nov 2013 17:28:36 +0100 Subject: [PATCH] Document in-piece use of \partial --- Documentation/notation/rhythms.itely | 43 ++++++++++++++++------------ 1 file changed, 24 insertions(+), 19 deletions(-) diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely index e3abf55239..32d82db04b 100644 --- a/Documentation/notation/rhythms.itely +++ b/Documentation/notation/rhythms.itely @@ -1443,12 +1443,30 @@ So the first example above could be written: e8 | a4 c8 b c4 | @end lilypond -The property @code{measurePosition} contains a rational number, which -is usually positive and indicates how much of the measure has passed -at this point. The @code{\partial @var{duration}} command sets it to -a negative number, when it has a different meaning: it then says that -the current (first) bar will be @emph{preceded} by a bar 0 (the partial -bar) with a duration given by @var{duration}. +The property @code{measurePosition} contains a rational number, +which is usually positive and indicates how much of the measure +has passed at this point. @code{\partial @var{duration}} is +defined such that no numbered bar gets created: when used at the +beginning of a measure, @code{measurePosition} is set to a +negative number, implying that the current bar will be +@emph{preceded} by additional material. When used after a measure +has already started, however, it moves the requested distance +before the @emph{end} of the bar. + +@lilypond[quote,verbatim,relative=1] +\set Score.barNumberVisibility = #all-bar-numbers-visible +\override Score.BarNumber.break-visibility = + #end-of-line-invisible +\time 6/8 +\partial 8 +e8 | a4 c8 b[ c b] | +\partial 4 +r8 e,8 | a4 \bar "||" +\partial 4 +r8 e8 | a4 +c8 b[ c b] | +@end lilypond + @seealso Music Glossary: @@ -1463,19 +1481,6 @@ Snippets: Internal Reference: @rinternals{Timing_translator}. -@knownissues -The @code{\partial} command should be used only at the beginning of a -piece. If you use it after the beginning, warnings or problems may -occur, so use @code{\set Timing.measurePosition} instead. - -@lilypond[quote,verbatim,relative=1] -\time 6/8 -\partial 8 -e8 | a4 c8 b[ c b] | -\set Timing.measurePosition = #(ly:make-moment -1/4) -r8 e,8 | a4 c8 b[ c b] | -@end lilypond - @node Unmetered music @unnumberedsubsubsec Unmetered music -- 2.39.5