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

[Federico Bruni]

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.

   {
     \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).

- 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')
}