Re: Doc: NR 4.1: Reorganize, clarify details. (issue2758042)

[k-ohara5a5a]

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode209
Documentation/notation/spacing.itely:209: by setting @code{paper-height}
or @code{paper-width}, even though
Too much warning for a user to remember unless he has already had the
problem.
Consider just identifying the affected dimensions, as at line 226, then
"Note that the set-*-paper-size functions will scale all these
variables, even those that you set yourself earlier in the \paper block.
In most cases you want to set these variables after set-*-paper-size"

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode275
Documentation/notation/spacing.itely:275: @c TODO: why? -mp
On 2010/10/28 13:29:57, Carl wrote:
> [rather] than spread out among all the staves in the system.
This space can also be put between the two or three systems, where it is
helpful, and 2.13 can do a good job with an override.
The same advice existed in the 2.12 manual; I learned to disregard it.

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode280
Documentation/notation/spacing.itely:280: @c TODO: pieces that amply
fill two pages... "true"->"false"? -mp
Yes to the change. ragged-last-bottom=##f for the amply-filling case

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode303
Documentation/notation/spacing.itely:303: Inter-system spacing is
controlled by grob properties, with
Inter means between.  Intra means within.  They are often confused, and
I think this is the wrong, one but it strains my brain too much to
figure out.  I strongly recommend Within- / Between- in general.

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode339
Documentation/notation/spacing.itely:339: @item @code{stretchability} --
a unitless measure of the
Drop 'unitless' One word that could be a big distraction.  I read the
thread and know what you mean, but users don't care. In the analogous
TeX glue, stretchability has units of length and the pulling force is
quietly taken to be dimensionless.  Note that the default value (space -
minimum-distance) has units of staff spaces.

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode854
Documentation/notation/spacing.itely:854: @funindex
page-limit-inter-system-space
Confirmed that setting it has no effect in 2.13.37, while it did in
2.12.3

http://codereview.appspot.com/2758042/diff/1/Documentation/notation/spacing.itely#newcode861
Documentation/notation/spacing.itely:861: @funindex
page-limit-inter-system-space-factor
confirming, gone

http://codereview.appspot.com/2758042/