Re: glissando in LP 2.16

[Werner LEMBERG]

[CCing devel instead of user, since this is a development
contribution.]

> you find attached 8 files: one .txt file containing seven
> documentation entries and seven .ly files for each entry.

I've now edited your contribution; attached is a patch.  Documentation
team, please comment and integrate if useful!

Thanks again!


    Werner

diff --git a/Documentation/notation/expressive.itely 
b/Documentation/notation/expressive.itely
index 25dbc81..528cdb2 100644
--- a/Documentation/notation/expressive.itely
+++ b/Documentation/notation/expressive.itely
@@ -1038,15 +1038,88 @@ g2\glissando g'
 c2\glissando c,
 @end lilypond
 
+It is possible to place an expression mark at a certain point within
+the glissando, usually indicated by a stem without a notehead:
+
address@hidden,quote,relative=2]
+f4\glissando\<
+\once \override NoteColumn #'glissando-skip = ##t
+\once \override NoteHead #'transparent = ##t
+a4\f\> a8\! r4.
address@hidden lilypond
+
address@hidden
+Setting @code{glissando-skip} to @code{#t} makes the glissando skip the
+inserted @code{NoteColumn} grob.  To hide the notehead, the
address@hidden property is set to @code{#t}.  If the stem doesn't
+align well with the glissando, it may need repositioning.
+
+The same works with more than one inserted grob:
+
address@hidden,quote,relative=2]
+r8 f2\glissando a8 r4 |
+r8 f8\glissando
+\override NoteColumn #'glissando-skip = ##t
+\override NoteHead #'transparent = ##t
+g4 a8
+\revert NoteColumn #'glissando-skip
+\revert NoteHead #'transparent
+a8 r4
address@hidden lilypond
+
+Setting the @code{breakable} property to @code{#t} in combination with
address@hidden allows to break a glissando if it occurs
+at a line break:
+
address@hidden,quote,relative=2,line-width=4.0\cm]
+\override Glissando #'breakable = ##t
+\override Glissando #'after-line-breaking = ##t
+
+f1\glissando | \break
+a4 r2. |
+f1\glissando \break
+\once \override NoteColumn #'glissando-skip = ##t
+\once \override NoteHead #'transparent = ##t
+a2 a4 r4 |
address@hidden lilypond
+
+A glissando can connect notes across staves:
+
address@hidden,quote]
+\new PianoStaff <<
+  \new Staff = "right" {
+    e'''2\glissando
+    \change Staff = "left"
+    a,,\glissando
+    \change Staff = "right"
+    b''8
+  }
+  \new Staff = "left" {
+    \clef bass s1 s8
+  }
+>>
address@hidden lilypond
+
+A glissando can occur between chords:
+
address@hidden,quote,relative=2]
+c1\glissando g'
+<c, e>1\glissando <g' b> \break
+
+\set glissandoMap = #'((0 . 1) (1 . 0))
+<c, g'>1\glissando <d a'>
+\set glissandoMap = #'((0 . 0) (0 . 1) (0 . 2))
+c1\glissando <d f a>
+\set glissandoMap = #'((2 . 0) (1 . 0) (0 . 1))
+<d f a>1\glissando <c c'>
address@hidden lilypond
+
 Different styles of glissandi can be created.  For details, see
 @ref{Line styles}.
 
 @snippets
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
-{glissandi-can-skip-grobs.ly}
-
address@hidden,quote,texidoc,doctitle]
 {contemporary-glissando.ly}
 
 @seealso