Re: GDP: renaming Program {usage, reference}

[Graham Percival]

Eyolf Østrem wrote:
> In other words: if it is a strong editorial decision that there should be
> one document which contains only the details about notational syntax and
> nothing else, then my suggestion of course falls flat. The document I'm
> talking about is broader: Everything You Need To Know To Produce A Score
> With Lilypond (Once It's Installed And Provided You Don't Need To Change
> Too Many Scheme Lists).

I see.  Well, as you mentioned, you could well make arguments in favor 
of including most of the AU in a "everything you need to know". 
Conversely, somebody could well argue that nobody needs to know about 
Bagpipe music.  :)

The strong editorial decision from a few months ago is this:

Notation Reference: defines the lilypond input syntax.

Application Usage: how to compile the syntax, how to convert to/from the 
syntax (including old versions), including the syntax in other programs, 
etc.

Internals Reference: defines the "under the hood" lilypond stuff.

Learning Manual: prepares users for those other manuals.

(this is explained at the top of policy.txt -- if it's not clear, please 
suggest a rewrite)


For people who like to print out PDFs, I expect them to print out the 
LM, NR, and AU.  If they want to save paper, by all means pick and 
choose -- for example, I wouldn't print out any of NR chapter 2, since 
I've never used any of the notation in it.  But there is certainly no 
"the NR is the only manual you should print out" thing.

Cheers,
- Graham