Re: Doc: Improve documentation of \glissando. (issue 6529043)

[lemzwerg]

Reviewers: Graham Percival,

Message:
I agree with your argumentation.  However, I don't have time to fix the
patch.  Maybe a good soul from the documentation team can improve this.

Description:
Doc: Improve documentation of \glissando.

Based on work from Tiresia GIUNO <address@hidden>.

Please review this at http://codereview.appspot.com/6529043/

Affected files:
  M Documentation/notation/expressive.itely


Index: Documentation/notation/expressive.itely
diff --git a/Documentation/notation/expressive.itely  
b/Documentation/notation/expressive.itely
index  
25dbc81d798c75a3b3b1fef709d6fb2b7b66c2e8..528cdb2047c56e75470673e535f57d7b8a3849c4  
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