Re: Reading the fine manual.. hint [was Re: MultiMeasureRest - trying to be clever ...]

[Walter Hofmeister]

On 7/5/06 1:58 AM, "Simon Dahlbacka" <address@hidden> wrote:

> 
>> And no disrespect, but I think Thibault is spot on with his first
>> sentence. The lilypond documentation is the size of a small novel!
>> Finding what you're looking for isn't easy.
>
The size of the manual for any capable notation software that I have seen is
always sizeable. The capabilities that Lilypond has dictates that the manual
will be quite large.
    Like any other notation software package, you will need to spend some
time getting to know the software and this will make it easier to navigate
the manual. I have personally found the index to be a fast way to find
things. By changing things significantly, all of the time that longer time
users have spent learning where things are in the documentation will be
lost. Personally, I think that the documentation works pretty well as it is
organizationally.  
> Personally, I find it easier to work with the one page html version and just
> let the browser search for hopefully good keywords.
> (The pdf version does not work as well due to the search being slower and I
> cannot seem to copy text from it..)
> 
> 
> /Simon
> 
Some people have responded that they prefer the pdf version or the one large
html version, I personally prefer the html version not on one page (the
linked one). I think that the current method of delivery in the
documentation tarball satisfies all of these preferences.
    The section that I think needs improvement is the documentation to make
tweeks easier. Lilypond is a very powerful piece of software and I find that
where I spend the most time is trying to construct tweeks.

Just my 2 cents worth.

Walter Hofmeister