Doc: Issue 3324: Add explanation of clashing note columns warning

Doc: Issue 3324: Add explanation of clashing note columns warning

[Keith, 2014-10-22 05:58:54]

LGTM

Just for your interest, I have been thinking that when the user gives explicit
\voiceOne or \shiftOn to the voices, Lily should set those voices at the shifts
requested, even if two voices have the same shift
<https://codereview.appspot.com/132110043/>
Currently users are required to set 'ignore-note-collision in these cases, but
then that turns off all the other chord-collision code.

https://codereview.appspot.com/154640043/diff/1/Documentation/usage/running.i...
File Documentation/usage/running.itely (right):

https://codereview.appspot.com/154640043/diff/1/Documentation/usage/running.i...
Documentation/usage/running.itely:1112: (@code{\stemDown}, etc) or implicitly
(@code{\voiceOne}, etc.)
People tend to use \stemDown when they want \voiceTwo, so maybe skip mention of
\stemDown.  

I wish there were no shorthand for changing just the stem direction without the
other changes required for consistency.

[Trevor Daniels, 2014-10-23 09:43:56]

On 2014/10/22 05:58:54, Keith wrote:

> Just for your interest, I have been thinking that when the user gives explicit
> \voiceOne or \shiftOn to the voices, Lily should set those voices at the
shifts
> requested, even if two voices have the same shift

Not sure I understand this.  Doesn't \voiceThree already set the shifts?

> Currently users are required to set 'ignore-note-collision in these cases, but
> then that turns off all the other chord-collision code.

Yes, I don't think we should advocate this.
 
>
https://codereview.appspot.com/154640043/diff/1/Documentation/usage/running.i...
> Documentation/usage/running.itely:1112: (@code{\stemDown}, etc) or implicitly
> (@code{\voiceOne}, etc.)
> People tend to use \stemDown when they want \voiceTwo, so maybe skip mention
of
> \stemDown.  

Agreed.  I'll remove \stemDown.
 
> I wish there were no shorthand for changing just the stem direction without
the
> other changes required for consistency.

It's used 6 times in the LM and 9 times in the NR, and masses of times in the
regression tests.  Maybe we should try to reduce the number of times \stemDown
(and Up) is mentioned in the LM and NR.

[Trevor Daniels, 2014-10-23 21:33:30]

Remove mention of \stemsDown

[Keith, 2014-10-24 02:26:20]

On Thu, 23 Oct 2014 02:43:56 -0700, <tdanielsmusic@googlemail.com> wrote:

> On 2014/10/22 05:58:54, Keith wrote:
>
>> I have been thinking that when the user gives explicit \voiceOne or \shiftOn
to the voices, Lily should set those voices at the shifts requested, even if two
voices have the same shift

I had forgotten that I already pushed that patch.

> Not sure I understand this.  Doesn't \voiceThree already set the shifts?

Yes it does.
I was emphasizing the case where a user sets the same shift on two voices,
because I didn't realize that you had seen the patch that I was thinking of.

[Trevor Daniels, 2014-10-30 22:27:23]

Pushed to staging as
62b428826f37228ab4644dbaabac7935c17ecdcd

Author: Trevor Daniels <t.daniels@treda.co.uk>  2014-10-23 22:28:47
Committer: Trevor Daniels <t.daniels@treda.co.uk>  2014-10-30 22:21:11

    Doc: Issue 3324: Add explanation of clashing note columns warning

Closing ...