Status: Accepted
Owner: ----
Labels: Type-Documentation
New issue 3094 by [email protected]: [DOC] NR 1.2.4 "Setting automatic
beam"
http://code.google.com/p/lilypond/issues/detail?id=3094
Reported by Federico Bruni:
http://lists.gnu.org/archive/html/bug-lilypond/2013-01/msg00048.html
I found three problems in the section "Setting automatic beam":
1) Can/Must confusion
"""
If a common time signature is being used, beamExceptions must be disabled
to enable beatStructure to work. The \set Timing.beamExceptions = #'()
command can always be included if beaming is being determined by
beatStructure.
"""
As it is, it may be a bit confusing, since first you say that you "must do"
then you say that you "can do". I understand that the two sentences want to
say two slightly different things, but it is not straightforward.
An user doesn't know yet that beamExceptions can't be empty if beaming is
to be defined by it (well, obvious, you'd say), which is what the second
sentence probably wants to say, IIUC. So I would rewrite the second
sentence as:
beamExceptions can and should be an empty list if beaming is being
determined by beatStructure.
2) Second comment: beatLength has been deprecated, right?
\time 3/4
% by default we beam in (6) due to beamExceptions
\repeat unfold 6 {a8} |
% This will beam (1 1 1) due to beatLength
\set Timing.beamExceptions = #'()
\repeat unfold 6 {a8}
3) typo in this sentence
"""
if a beam-ending rule is defined in beamExceptions for a longer beam-type,
use it to determined the valid places where beams may end, otherwise
"""
/s/determined/determine
