lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

renaming "vertical spacing inside systems" props


From: Mark Polesky
Subject: renaming "vertical spacing inside systems" props
Date: Fri, 29 Oct 2010 15:27:47 -0700 (PDT)

Guys,

Here are my proposals for renaming the properties related to
"Vertical spacing inside systems".

* * * * * * * * * * * * * * *

I've thought about it, and I think I slightly favor the term
"loose line" over "non-staff line"; the word "loose" is
distinctive and much less likely to get tangled up with the
word "staff" (in the user's head, that is).

On the other hand, "nonstaff-staff-spacing" may be more
intuitive than "loose-staff-spacing".  But if we call the
property "nonstaff-staff-spacing", I'd want to replace all
references to "loose lines" with "non-staff lines" (or maybe
"nonstaff lines", without the hyphen?).

Lastly, one property resists the "item1-item2-spacing" name
format: currently named 'between-staff-spacing, it controls
the spacing between staves within a staffgroup.  I don't
like the current name because it sounds like it controls the
spacing between ungrouped staves too, but it doesn't.  I'm
proposing 'inside-staffgroup-spacing, which is clearer (I
think) but not consistent with the "item1-item2-spacing"
format.

Please share your thoughts about these proposals.  I want
the prop names to be consistent and intuitive, and I'd like
to come as close as possible to a general consensus.
Hopefully this thread won't be as thorny as the last time:
http://lists.gnu.org/archive/html/lilypond-devel/2010-10/msg00070.html

If it helps, the current prop-names are explained in some
detail in this (unfinished) patch:
http://codereview.appspot.com/2642043/

Thanks!
- Mark

* * * * * * * * * * * * * * *

Except for the 'inside-staffgroup property, the names of
these properties follow the format "item1-item2-spacing".
Note that item2 is not necessarily below item1; for example,
'loose-staff-spacing will measure upwards from the loose
line if 'staff-affinity = #UP.

(I've omitted the "-spacing" suffix to save space.)

CURRENT NAME       PROPOSED NAME       ALTERNATE PROPOSAL
------------       -------------       ------------------
next-staff         staff-staff
default-next-staff default-staff-staff

inter-staff        loose-staff         [nonstaff-staff]
inter-loose-line   loose-loose         [nonstaff-nonstaff]
non-affinity       loose-nonaffinity   [nonstaff-nonaffinity]

between-staff      inside-staffgroup
after-last-staff   staffgroup-staff


      



reply via email to

[Prev in Thread] Current Thread [Next in Thread]