Re: bar number position (direction) numerical definitions overlap

[Paul Scott]

Mats Bengtsson wrote:
> Paul Scott wrote:
> > If it would lead to as much work as you say then at least a verbal 
> > description of what direction means should be included as it is for 
> > (most?) other properties.
>
> Please go ahead and suggest something, see 
> http://lilypond.org/web/devel/participating/documentation-adding
Not very easy to come with a one size fits all definition but maybe this 
would be help:

|direction| (direction):
   |1|

A value -1, 0 or 1 meaning whichever of (left, center or right) or 
(down, center or up) makes sense for this layout object.  #LEFT, 
#CENTER, #RIGHT and #DOWN, #CENTER, #UP may be used instead of the numbers.

I would also suggest adding something to the default values listed under 
the property name which would give a further hint to the meaning.

For example the property definition for the BarNumber layout object 
might read:

direction (direction)
1 (#UP)

A value -1, 0 or 1 meaning whichever of (left, center or right) or 
(down, center or up) makes sense for this layout object.  #LEFT=-1, 
#CENTER=0, #RIGHT=1 and #DOWN=-1, #CENTER=0, #UP=1 may be used instead 
of the numbers.

Paul