Re: GDP: renaming Program {usage, reference}

[ian_hulin]

I hope this contribution isn't too late, but here goes.  I'm commenting here
before I have a look closely at the PDFs and possibly get bogged down in
detail.

Isn't the purpose of the Internals Reference to show Lilypond users how to
customize/interpreter the compiler to produce source code which will
represent and produce music notation in a way that is convenient and
comprehensible to them?   Don't they then have the option of doing this by
programming at either one of two levels, i.e. using the Lilypond language
(variables, accessing Lilypond 'objects', 'attributes ' or 'methods'), or if
needed, dropping into Lilypond's internal macro language, Scheme.

If I understand correctly your Internals Reference needs to cover both these
levels of usage, and maybe a good title may be Customization and Internals
Reference Manual (CIR)?

Or have I missed several points in taking my helicopter view of the GPD
green fields site :-)?

Cheers,
 Ian Hulin
(Now off to have a look at the PDFs).


Graham Percival-2 wrote:
> 
> 
> 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
> 
> 
> _______________________________________________
> lilypond-user mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/lilypond-user
> 
> 

-- 
View this message in context: 
http://www.nabble.com/GDP%3A-renaming-Program-%7Busage%2C-reference%7D-tf4742154.html#a13665226
Sent from the Gnu - Lilypond - User mailing list archive at Nabble.com.