Re: Problem with 'transparent doc-snippet

[Urs Liska]

Am 29.04.2013 16:57, schrieb Trevor Daniels:
> Urs Liska wrote Monday, April 29, 2013 2:26 PM
>
>
> > 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.
> Agreed.
>
> > 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.
> This snippet is in the LSR, so changes should be made by amending the
> snippet there, otherwise it remains wrong in the LSR.
Do I recall correctly having read that _now_ (whatever this is) Flags 
are treated as separate objects while _earlier_ they were part of the stem?
In the LSR the snippet displays correctly, whereas in the docs we have 
the 'floating' Flags.

What to do about that?
I think it is 'correct' in the LSR but not in the docs, so it should 
either be removed from the docs (i.e. the doc tag removed) or updated 
separately in the docs.

But I would suggest to remove this snippet from the docs because it's 
not the right thing to do anyway.
>   
> > 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
> OK, but just submit a replacement snippet to the LSR.  Anyone can
> do that.
What should I exactly do to submit a snippet to the LSR with the 
intention to adding it to the docs?

Urs
> Trevor