Implement \beamExceptions function fishing exceptions from beamed music.

Implement \beamExceptions function fishing exceptions from beamed music.


Also contains commits

Change documentation and regtests for \beamExceptions

Add unfold-repeats-fully function which will expand repeats in the data

[janek, 2013-12-01 12:32:34]

I very much like the simplification in the user interface!
If i understand correctly, this function will overwrite beamExceptions with the
pattern extracted from the music.

Would it be possible to instead have a function \addBeamException that would
take just one pattern and _add it_ to the current beamExceptions?  I think that
would make the user interface even better.

cheers,
Janek

PS I dedicate my code reviews to Graham Percival.

[dak, 2013-12-01 13:01:40]

On 2013/12/01 12:32:34, janek wrote:
> I very much like the simplification in the user interface!
> If i understand correctly, this function will overwrite beamExceptions with
the
> pattern extracted from the music.

No.  It converts the given music into a form that can be placed into the
beamExceptions property.  Examples and documentation are intended to be quite
clear about that.  Please point out where you consider it deficient.

> Would it be possible to instead have a function \addBeamException that would
> take just one pattern and _add it_ to the current beamExceptions?  I think
that
> would make the user interface even better.

There is no "instead".  What you do with the extracted data is your own choice. 
Assigning to beamExceptions via \set is one obvious use case.  Using it as an
argument in \overrideBeamSettings is another.  If you want to write a function
that will use applyContext for getting the existing setting and merging it with
something you may specify in Scheme or by using \beamExceptions, feel free to do
so in a separate issue.

I don't think that there is much of a point to it since beam exceptions act as a
set and having too many closely named functions for fiddling with beam settings
will confuse rather than help.