Re: Fixes boolean/SCM confusions, part 1. (issue 4875054)

[Graham Percival]

On Thu, Aug 18, 2011 at 09:43:38PM +0000, address@hidden wrote:
> I think we ought to have a comment somewhere that describes why we don't
> use scm_is_true.  But I can't figure out where to put it -- I guess it
> should be in the documentation that we hope will arise as a result of
> all this effort.

Yes, but let's not "hope" for this.

Bertrand: you're her mentor, so this is your job.  Add a section
to the CG chapter on "programming".  Make a new @section right
before "LilyPond miscellany".  You'll need to add it to the @menu
as well.  Check that the docs still compile by running "make", and
as long as that doesn't die, then push that change directly.  Just
write "stub" in the text for that @section.

Bertrand, second stage: write anything you want in there.  You
could copy portions of David's emails verbatim, or just copy bits
and pieces of emails and put them into an itemized list, or
whatever.  Or you could ask Cecile to write something.  Again,
push directly with no review as long as the documentation still
completes a plain old "make".

Everybody else: feel free to jump in and correct that part of the
CG if you notice anything that's incorrect or unclear.  No
reitveld reviews; just change something and push it if you're
certain, or send a question (in a new thread) to lilypond-devel if
you're uncertain.

Cheers,
- Graham