Problem with 'transparent doc-snippet

[Urs Liska]

I have two problems with the doc-snippet
http://www.lilypond.org/doc/v2.17/Documentation/snippets/rhythms#rhythms-making-an-object-invisible-with-the-_0027transparent-property

a)
I'm not sure if this snippet is adequate at all:
I think writing cross-voice curves by setting the 'transparent property 
isn't a good way because (as is mentioned in the snippet!) the blanked 
objects _do_ take part in collisions etc.
With ties this will especially lead to problems with the flags that 
often collide with ties -> the tie will try to avoid a flag that isn't 
there at all.
IMO this should be done by setting 'stencil =  ##f
So one should have either a different example for 'transparent or 
rewrite this example with 'stencil and label it accordingly.

b)
Independent of the opinion on a) the example has the flags still showing.
So the least to be done is to update the example to blank the flags too.
Which is done by attached patch.

b')
The example for creating cross-voice curves should be somewhat expanded 
because newbie usually take the examples literally.
In the case of the example it was the flag that was still present. But 
in a real application one has to blank/remove _all_ elements of the 
hidden voice: NoteHead, Stem, Flag, Beam, Dot.
So the example should be rewritten (taking the decision on a) into account.
If we find an agreement on a) I can do that and provide a patch

Urs

0001-doc-snippet-Fix-transparent-snippet.patch
Description: Text Data