Re: Doc addition to 8.1.2 "Text and line spanners" ... concerning \endSpanners

[Mats Bengtsson]

The only "documentation" of \endSpanners available in the LilyPond
distribution today is the regression test example called
music-function-end-spanners.ly

A quick look at the implementation reveals that the \endSpanner function
takes one argument, which is a music expression (and cannot be a sequence
of notes, just a single so-called EventChord), so Max's comment seems
correct.

  /Mats

Maximilian Albert wrote:
> Trevor Bača wrote:
>
> > So that's a brief explanation of the function. Could you please insert
> > the following at the very bottom of 8.1.2 "Text and line spanners",
> > immediately before the "see also"?
> >
> > %%% BEGIN DOC ADDITION %%%
> >
> > The music function \endSpanners terminates spanners and hairpins after
> > exactly one note.
> >
> >   \new Staff {
> >     \endSpanners
> >     c'2 \startTextSpan c'2
> >     c'2 \< c'2
> >   }
> >
> > When using \endSpanners it is not necessary to close \startTextSpan
> > with \stopTextSpan, nor is it necessary to close hairpins with \!.
> >
> > %%% END DOC ADDITION %%%
> >
> > One thing I realize now writing this update is that I don't know if
> > there is a way to turn \endSpanners *off* at some point in input and
> > return to specifying spanner (and hairpin) endpoints manually.
>
> Compiling your example (with version 2.11.34) results in the warning 
> "unterminated (de)crescendo", and the hairpin is not present in the 
> pdf output. After inserting \endSpanners *twice*, however, like so:
>
> %%% BEGIN CODE %%%
>
>    \new Staff {
>      \endSpanners
>      c'2 \startTextSpan c'2
>      \endSpanners
>      c'2 \< c'2
>    }
>
> %%% END CODE %%%
>
> ... the warning disappears and the hairpin is visible in the way you 
> described. Which leads me to think that \endSpanners only applies to 
> the spanner immediately following the command (similar to a "\once"). 
> It's just a guess, though, without having looked at the code.
>
> Best,
> Max (who should finally learn not to read emails while trying to get 
> his work done :))
>
>
> _______________________________________________
> lilypond-devel mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/lilypond-devel

--
=============================================
        Mats Bengtsson
        Signal Processing
        Signals, Sensors and Systems
        Royal Institute of Technology
        SE-100 44  STOCKHOLM
        Sweden
        Phone: (+46) 8 790 8463                         
       Fax:   (+46) 8 790 7260
        Email: address@hidden
        WWW: http://www.s3.kth.se/~mabe
=============================================