Doc: Issue 4221: Corrections to example of 'positions property

  See section 4.6.2 in LM

  - use relative rather than absolute
  - amend text to use correct voices
  - add revert (to show best practice)

diff --git a/Documentation/learning/tweaks.itely b/Documentation/learning/tweaks.itely
index b7597087080c33bce6e503cd78e735fdf6990bef..1ec7ca30ed148a7715780432df259254a0b31a87 100644 (file)
--- a/Documentation/learning/tweaks.itely
+++ b/Documentation/learning/tweaks.itely
@@ -3209,18 +3209,26 @@ do this, see @ruser{Modifying ties and slurs}.
 Here's a further example.  We see that the beams
 collide with the ties:
 
 Here's a further example.  We see that the beams
 collide with the ties:
 

-@lilypond[quote,verbatim,fragment,ragged-right]
+@lilypond[quote,verbatim,fragment,ragged-right,relative=1]

 {
   \time 4/2
   <<
 {
   \time 4/2
   <<

-    { c'1 ~ 2. e'8 f' }
+    { c1~ 2. e8 f }

     \\
     \\

-    { e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g'' }
+    {
+      e'8 e e e
+      e e e e
+      f2 g
+    }

   >>
   <<
   >>
   <<

-    { c'1 ~ 2. e'8 f' }
+    { c,,1~ 2. e8 f }

     \\
     \\

-    { e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g'' }
+    {
+      e'8 e e e
+      e e e e
+      f2 g
+    }

   >>
 }
 @end lilypond
   >>
 }
 @end lilypond


@@ -3233,29 +3241,37 @@ say, 1:
 @cindex Beam, example of overriding
 @cindex positions property, example
 
 @cindex Beam, example of overriding
 @cindex positions property, example
 

-@lilypond[quote,verbatim,fragment,ragged-right]
+@lilypond[quote,verbatim,ragged-right,relative=1]

 {
   \time 4/2
   <<
 {
   \time 4/2
   <<

-    { c'1 ~ 2. e'8 f' }
+    { c1~ 2. e8 f }

     \\
     {
       \override Beam.positions = #'(-1 . -1)
     \\
     {
       \override Beam.positions = #'(-1 . -1)

-      e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g''
+      e'8 e e e
+      e e e e
+      f2 g

     }
   >>
   <<
     }
   >>
   <<

-    { c'1 ~ 2. e'8 f' }
+    { c,,1~ 2. e8 f }

     \\
     \\

-    { e''8 e'' e'' e''  e'' e'' e'' e''  f''2 g'' }
+    {
+      e'8 e e e
+      e e e e
+      f2 g
+      \revert Beam.positions
+    }

   >>
 }
 @end lilypond
 
 @noindent
   >>
 }
 @end lilypond
 
 @noindent

-Note that the override continues to apply in the first voice of
+Note that the override continues to apply in the second voice of

 the second measure of eighth notes, but not to any of the beams in the
 the second measure of eighth notes, but not to any of the beams in the

-second voice.
+first voice, even those in the later second measure.  As soon as the
+override should no longer apply it should be reverted, as shown.

 
 @node The force-hshift property
 @unnumberedsubsubsec The @code{force-hshift} property
 
 @node The force-hshift property
 @unnumberedsubsubsec The @code{force-hshift} property