Re: doc reorg (especially Usage) possibly finished

2009-09-29 Thread Graham Percival
On Mon, Sep 28, 2009 at 09:08:46PM -0600, Andrew Hawryluk wrote: > On Sun, Sep 27, 2009 at 6:57 AM, Graham Percival > wrote: > > What do people think about the doc reorg shown in: > > http://kainhofer.com/~lilypond/Documentation/general/Manuals.html > > (and the actual manual pages, of course) >

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Andrew Hawryluk
On Sun, Sep 27, 2009 at 6:57 AM, Graham Percival wrote: > What do people think about the doc reorg shown in: > http://kainhofer.com/~lilypond/Documentation/general/Manuals.html > (and the actual manual pages, of course) Is it worth mentioning in the essay page that the detailed typographical exam

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Neil Puttock
2009/9/28 Graham Percival : > Really?  I could have sworn that I did the "touch > Documentation/*.te??" test... or maybe this doesn't trigger a full > rebuild after all? That won't rebuild the translations though, will it? Here's the error message I got: make[3]: *** No rule to make target `/ho

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Graham Percival
On Mon, Sep 28, 2009 at 05:56:27PM +0100, Neil Puttock wrote: > 2009/9/27 John Mandereau : > > > A few files have been moved in English docs, could somebody do the same > > for translated docs?  I'm asking just in case somebody may volunteer, > > otherwise I'll do this after October 5th and not be

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Neil Puttock
2009/9/27 John Mandereau : > A few files have been moved in English docs, could somebody do the same > for translated docs?  I'm asking just in case somebody may volunteer, > otherwise I'll do this after October 5th and not before I get an > Internet connection at home. Ah, this probably explains

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Graham Percival
On Mon, Sep 28, 2009 at 06:23:12PM +0200, Mats Bengtsson wrote: > Quoting John Mandereau : > >> Le dimanche 27 septembre 2009 à 19:08 +0100, Graham Percival a écrit : >>> I'm wondering if we can call them "Function index" and "Concept >>> index". Or something like that. It just seems weird to hav

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Mats Bengtsson
Quoting John Mandereau : Le dimanche 27 septembre 2009 à 19:08 +0100, Graham Percival a écrit : I'm wondering if we can call them "Function index" and "Concept index". Or something like that. It just seems weird to have a "LilyPond index" for every manual. Maybe "Function and concept index"

Re: doc reorg (especially Usage) possibly finished

2009-09-28 Thread Graham Percival
On Sun, Sep 27, 2009 at 08:12:26PM +0200, John Mandereau wrote: > Le dimanche 27 septembre 2009 à 13:57 +0100, Graham Percival a écrit : > > What do people think about the doc reorg shown in: > > http://kainhofer.com/~lilypond/Documentation/general/Manuals.html > > (and the actual manual pages, of

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread Carl Sorensen
On 9/27/09 11:55 AM, "John Mandereau" wrote: > Le dimanche 27 septembre 2009 à 17:37 +0100, Graham Percival a écrit : >> How much of scheme do we get into, though? I mean, what about >> moving it back into Notation? > > This would be wrong: even if we expanded it up to make a big chapter, it

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread John Mandereau
Le dimanche 27 septembre 2009 à 19:08 +0100, Graham Percival a écrit : > I'm wondering if we can call them "Function index" and "Concept > index". Or something like that. It just seems weird to have a > "LilyPond index" for every manual. Maybe "Function and concept index", as this index actually

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread John Mandereau
Le dimanche 27 septembre 2009 à 13:57 +0100, Graham Percival a écrit : > What do people think about the doc reorg shown in: > http://kainhofer.com/~lilypond/Documentation/general/Manuals.html > (and the actual manual pages, of course) I think the frame "Read it now" is superfluous, a simple link "

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread Graham Percival
On Sun, Sep 27, 2009 at 07:55:32PM +0200, John Mandereau wrote: > Le dimanche 27 septembre 2009 à 17:37 +0100, Graham Percival a écrit : > > As far as I'm concerned, as long as newbies know that it's > > *possible* to do all sorts of funky stuff with this magical scheme > > stuff, that's all they n

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread John Mandereau
Le dimanche 27 septembre 2009 à 17:37 +0100, Graham Percival a écrit : > How much of scheme do we get into, though? I mean, what about > moving it back into Notation? This would be wrong: even if we expanded it up to make a big chapter, it would not become reference documentation (we alreadhy hav

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread Graham Percival
On Sun, Sep 27, 2009 at 10:15:30AM -0600, Carl Sorensen wrote: > > On 9/27/09 6:57 AM, "Graham Percival" wrote: > > > 1) Learning B. Scheme tutorial -- do we want to keep this here, or > > integrate into Learning 4? Or _possibly_ make a Learning 5 > > Programming inside LilyPond? > > I don't t

Re: doc reorg (especially Usage) possibly finished

2009-09-27 Thread Carl Sorensen
On 9/27/09 6:57 AM, "Graham Percival" wrote: > What do people think about the doc reorg shown in: > http://kainhofer.com/~lilypond/Documentation/general/Manuals.html > (and the actual manual pages, of course) > > > I think I have the balance between Learning and Usage good now. > The only re