Re: Issue 1775 in lilypond: LSR: add broken- and unbroken slur shaping function

[lilypond]

Comment #20 on issue 1775 by address@hidden: LSR: add broken- and  
unbroken slur shaping function
http://code.google.com/p/lilypond/issues/detail?id=1775

Thanks for making this available.
But I still find it confusing that the usage of the version for broken  
slurs isn't mentioned at all in the text of the snippet (but only in the  
source).
So I suggest a different text:
---------
If you want to adjust the shape of a slur, one way is to specify a new list  
of control-points. The function presented here offers a different approach  
by allowing you to adjust existing control-points. This is done by entering  
a list of offsets (in staff spaces) to the default coordinates: \shapeSlur  
#'(x1 y1 x2 y2 x3 y3 x4 y4) Setting a value to 0 leaves the default  
coordinate unchanged, so it is easy to maintain a slur's attachment-points  
while changing its interior.
This version of the function is also able to deal with slurs that are  
broken. You can shape the different parts of the broken slur by entering  
separate lists of offsets for each part:
\shapeSlur #'((x1 y1 x2 y2 x3 y3 x4 y4)
              (xx1 yy1 xx2 yy2 xx3 yy3 xx4 yy4)
              (xxx1 yyy1 xxx2 yyy2 xxx3 yyy3 xxx4 yyy4)
             )
If you use an empty bracket the corresponding part of the slur isn't  
changed at all from LilyPond's default decision.
This snippet is a revised version, by David Nalesnik, of the original  
(snippet 639).
--------------------

Is this too long for a snippet?
If no, could it just changed on LSR? Should the issue be reopened or just  
corrected?