[Top][All Lists]
[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
- renaming "vertical spacing inside systems" props,
Mark Polesky <=