Re: Doc: improve documentation of Bézier curves (28 58) (issue 6561064)

[david . nalesnik]

Trevor--

Thank you so much for taking this on!  I've been pecking at documenting
this for awhile, but got hung up on finding the perfect examples... What
you have is clearer than what I cam up with.


https://codereview.appspot.com/6561064/diff/1/Documentation/notation/changing-defaults.itely
File Documentation/notation/changing-defaults.itely (right):

https://codereview.appspot.com/6561064/diff/1/Documentation/notation/changing-defaults.itely#newcode4027
Documentation/notation/changing-defaults.itely:4027:
Perhaps at this point it would be helpful to include an example of
\shape applied to a curve across a line break.  Something like this:

"The \shape function can also displace the control points of curves
which stretch across line breaks.  Each piece of the broken curve can
receive its own list of offsets.  In case changes to a particular
segment are not needed, the empty list can serve as a placeholder."

\relative c'' {
  % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
  \shape Slur #'(() ((0.5 . -1.5) (1 . 0.5) (0 . 0.5) (0 . -1.5)))
  c4( f g c
  \break
  d,4 c' f, c)
}

\layout {
  ragged-right = ##t
}

https://codereview.appspot.com/6561064/