Re: Some "Cheat cheet" nitpicks

[Graham Percival]

On Tue, Dec 15, 2009 at 09:55:10AM +0100, Werner LEMBERG wrote:
> 
> [all lilypond documentation snippets running through lilypond-book get
> a horizontal offset of 3mm to the right]
> 
> > We have code that detects if the example is a single line; if so, it
> > adds ragged-right=##t.
> 
> I think you are wrong; at least I haven't found anything into this
> direction in lilypond-book.  It only suppresses ragged-right output if
> a line width is given.

It's part of the lilypond binary (or scheme functions) itself, not
lilypond-book.

http://lists.gnu.org/archive/html/lilypond-devel/2008-03/msg00097.html

I don't know exactly when it was implemented, but we spent a lot
of time removing [ragged-right] from the docs, so it definitely
*was* implemented.

> > That same piece of code could set left-padding to 0.
> 
> `This piece of code' has to be written yet, I believe.  However, I
> think it's a bad idea in general since it means that you have to run
> lilypond twice on a single snippet: the first time to find out whether
> there is more than a single line, and the second time to apply
> left-padding.

I have no clue how Joe worked his magic, but I trust that he did
it the proper way.  :)   (or else he and Han-Wen decided that the
initial spacing could be done fast enough that it wouldn't matter)

> The best solution is probably to add a new command line option
> `--default-left-padding' to lilypond-book (which is then used in the
> Makefile with value 0mm to override the default setting of 3mm), and
> adding a snippet option `left-padding' to the lilypond environments
> (within lilypond-book) to override the default left padding if
> necessary.

No.  We're not adding that option to 90% of the snippets in the
docs.  It can't be done automatically, and it's way too much work
to do it manually.

Cheers,
- Graham