Doc: NR 4.1.2: Setting alist keys properly.

Doc: NR 4.1.2: Setting alist keys properly.

[Mark Polesky, 2010-10-22 07:16:11]

I was about to push this, but then I started thinking that
the change was big enough to ask you guys for approval.
Any opposition?  I'm aiming for clarity, accuracy, and
comprehensiveness.  The idea is to reduce the amount of
time users spend being confused, and reduce the number of
questions on the mailing list.

Comments?  Okay to push?

Thanks.
- Mark

[Carl, 2010-10-22 12:10:15]

I think it looks very nice.  Great job!

Carl

http://codereview.appspot.com/2670041/diff/11001/Documentation/notation/spaci...
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/2670041/diff/11001/Documentation/notation/spaci...
Documentation/notation/spacing.itely:232: @subsubheading Alist structure
Perhaps this would be better titled "Spacing alist"

http://codereview.appspot.com/2670041/diff/11001/Documentation/notation/spaci...
Documentation/notation/spacing.itely:244: @item @code{space} -- the default
vertical distance, measured in
I thought 'space was going to be renamed to 'base-distance or 'default-distance
or something similar.

http://codereview.appspot.com/2670041/diff/11001/Documentation/notation/spaci...
Documentation/notation/spacing.itely:289: @subsubheading Modifying alists
Modifying spacing alists

[Mark Polesky, 2010-10-22 13:07:27]

http://codereview.appspot.com/2670041/diff/11001/Documentation/notation/spaci...
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/2670041/diff/11001/Documentation/notation/spaci...
Documentation/notation/spacing.itely:244: @item @code{space} -- the default
vertical distance, measured in
On 2010/10/22 12:10:16, Carl wrote:
> I thought 'space was going to be renamed to
> 'base-distance or 'default-distance or something similar.

It will be, but that change is beyond me.  I'll need to ask
Joe to do it, but I wanted to clear up everything else that
I can do on my own first.  Besides, I've grown to dislike
even "base-distance" because it sounds too much like the
distance between "bases", however that might be
interpreted.  Even if that particular thought doesn't occur
to a user, it's still ambiguous.  What do you think about
"unstretched-distance"?

- Mark

[Carl, 2010-10-22 14:55:08]

On 2010/10/22 13:07:27, Mark Polesky wrote:
> 
> It will be, but that change is beyond me.  I'll need to ask
> Joe to do it, but I wanted to clear up everything else that
> I can do on my own first.  Besides, I've grown to dislike
> even "base-distance" because it sounds too much like the
> distance between "bases", however that might be
> interpreted.  Even if that particular thought doesn't occur
> to a user, it's still ambiguous.  What do you think about
> "unstretched-distance"?

I like it.

Carl