Re: NR 5.3.6 The \offset command: confusion in describing the examples

[Federico Bruni]

Il giorno mer 7 giu 2017 alle 15:24, David Nalesnik 
<address@hidden> ha scritto:
> Hi Federico,
>
> On Wed, Jun 7, 2017 at 8:11 AM, Federico Bruni <address@hidden> 
> wrote:
> >  Hi all
> >
> >  While translating, I think I caught an error in the doc:
> >
> >  
> > http://lilypond.org/doc/v2.19/Documentation/notation/the-offset-command
> >
> >  """
> >  The following example displaces the ‘broken’ OttavaBracket 
> > object through
> >  its staff-padding property. Since the property takes a number, 
> > offsets is
> >  provided with a list of numbers to account for the two segments 
> > created by
> >  the line break. The slur piece on the first line is effectively 
> > untouched
> >  since 0 is added to its default value. The segment on the second 
> > line is
> >  raised two staff-spaces from its default height. The default height 
> > happens
> >  to be 2, though it is not __necesssary__ to know this.


another typo: "necesssary"


> >     {
> >       \offset staff-padding #'(0 3) Staff.OttavaBracket
> >       \ottava #1
> >       c'''2 c'''
> >       \break
> >       c'''2 c'''
> >     }
> >
> >  """
> >
> >
> >  - 1st problem: All the text from "The slur piece on the first line" 
> > do not
> >  refer to the OttavBracket example, which is what is supposed to be 
> > discussed
> >  in that paragraph, but to the example after that (the example which 
> > mimics
> >  the effect of the \shape command).
>
> No, the paragraph actually does refer to the OttavaBracket example.
> The problem is a simple typo: "the slur piece" ought to read "the
> bracket piece" or "the ottava bracket piece".  (Do you want to change
> this, or should I?)

Ok, it makes sense now.
Please take care of the change. I'm busy with updating the italian 
translation...

> >  - 2nd problem (maybe): I'm not even sure that the "slur on the 
> > second line
> >  is raised two staff-spaces from its default height". Isn't 1.5 for 
> > the
> >  endpoints? Here's the example:
> >
> >  {
> >   c'4-\offset control-points #'(
> >                ((0 . 0) (0 . 0) (0 . 0) (0 . 1))
> >                ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
> >               ) ( f'4 g' c''
> >   \break
> >   d'4 c'' f' c')
> >  }
>
> Again, this is remedied by fixing the typo.  The default value of
> OttavaBracket.staff-padding is 2.0.  (An issue could be raised with my
> referring to a setting which could be changed at some point making the
> reference inaccurate, but that's another issue!)

Ok, but I thought that in the OttavaBracket example the segment in the 
second line was raised by 3 (not 2) staff spaces.