Re: lilypond manual intro

[Graham Percival]

On Sat, Sep 08, 2012 at 06:20:09PM +0100, Trevor Daniels wrote:
> 
> Karl Berry wrote Friday, September 07, 2012 11:45 PM
> 
> > The first example there looks good (and is in fact what I sent her).
> > But then the second example, instead of showing how to typeset other
> > kinds of notation, goes into \relative.  Is this really the next thing
> > people want from a tutorial?  I would have expected to see how to choose
> > a different clef or time signature or type of note or ... anything but
> > that.
> 
> Again, a reasonable point to make, but as pretty well all the following 
> examples are in relative mode and as this is usually the best one for
> beginners to use it seemed best to get this out of the way early, rather
> than teaching absolute entry only to ditch it a few pages later.

Yes.  If anything, I think we should consider making the very
first example \relative.
(I'd also like to have an \absolute keyword so that doc examples
using it could be more explicit, but that would need to wait until
we have a good way to discuss syntax changes)

> > On another front: it seems suboptimal to me for that url to embed the
> > version number.  It means that when I give out the url, it is basically
> > never going to change.  What I really want to give out is the "current
> > tutorial" url, to take advantage of whatever improvements get made.
> 
> That's because there are always (at least) two versions of LilyPond
> available - the latest stable with an even number (14, 16) and the
> latest development with an odd number (17).  Best stick with even
> numbers at this stage.  They change quite slowly.

http://lilypond.org/doc/stable/Documentation/learning/index
"redirects" to
http://lilypond.org/doc/v2.16/Documentation/learning/index
The same is true of 
http://lilypond.org/doc/stable/

I use the word "redirects" because I don't know what the correct
apache / .http term is.  The .htaccess contains:

RedirectMatch ^/stable    /doc/stable
RedirectMatch ^/doc//*stable/*(.*)$ /doc/v2.16/$1

- Graham