Re: Macro pre-processing?

[Graham Percival]

On 9-Apr-06, at 11:04 AM, Geoff Horton wrote:

> > I think the following messages to lilypond-users (as well as my own
> > complete inability to understand music functions) suggest that the
> > manual could use some work in this area.
>
> A problem endemic to manuals, and one that I have no idea how to fix,
> is that they're usually crystal-clear to someone who already knows the
> answer.

And a problem endemic to the lilypond manual, and one that I have a few 
ideas how to fix, is that the person maintaining the docs doesn't 
understand a all the material.

In the case of scheme (chapter 11), I can honestly say that I do not 
fully understand a single section of the docs.  But I'm swamped with 
other doc issues, so I never have time to sit down and really learn it. 
 And if I don't understand the material, I certainly can't write docs 
about it.  Rest assured that I've saved Nicholas' email, so some day 
when I've finished more pressing doc issues, I'll revisit this issue.

In a few days, I'll be making a big push to get more people involved in 
the docs.  If you'd like to see the manual improved, please think about 
offering to do some of the jobs -- if other people do simple jobs, I 
can concentrate on learning (and then improving the docs) on simple 
things.  If other people offer to do complicated jobs, I can work on 
simple things.  If both areas are covered, I'm certain I can find other 
doc stuff to do.

Cheers,
- Graham