Re: Comments in GDP, Was: comments

[James E. Bailey]

On 28.02.2008, at 11:07, Mats Bengtsson wrote:

> Did you search for "Comment" in the index of the Tutorial?
>
> However, you are right that it seems to be missing in the NR,
> where it also should be included for completeness.
>
>  /Mats
>
> James E. Bailey wrote:
> > Maybe I'm still sleepy (it's early), but I'm not finding the  
> > section on comments in the new documentation. Specifically,  
> > something that deals with
> > http://lilypond.org/doc/v2.10/Documentation/user/lilypond/Working-on-text-files#Working-on-text-files
> > but in the documentation for 2.11. I realise is hasn't changed, but  
> > since I only ever download the current docs, it's just slightly  
> > more of a hassle to have to go to the website for it. (I just did a  
> > search for the word "comment" both in the pdf I downloaded and the  
> > "all in one big page" version of the 2.11 documentation).
> >
> >
> > _______________________________________________
> > lilypond-user mailing list
> > address@hidden
> > http://lists.gnu.org/mailman/listinfo/lilypond-user
>
> --
> =============================================
>         Mats Bengtsson
>         Signal Processing
>         School of Electrical Engineering
>         Royal Institute of Technology (KTH)
>         SE-100 44  STOCKHOLM
>         Sweden
>         Phone: (+46) 8 790 8463                         
>       Fax:   (+46) 8 790 7260
>         Email: address@hidden
>         WWW: http://www.s3.kth.se/~mabe
> =============================================

Learning manual. Gotcha. Just out of curiosity, why are these split  
up? It took a while for me to figure out which of the various manuals  
had the information I usually need, but it seems to me that in  
separating out different sections from what was "everything about  
lilypond" there are various manuals that deal with specific topics  
but, and I realise this is a goal of the GDP, the titles don't always  
communicate the contents of the manual to me.

For example, what is the difference between a "user manual" and a  
"learning manual"? Naturally and user would need to learn how to use  
the program, so I would assume that the two would be one and the same.  
To the same end, "program usage" and "user manual", to my brain, would  
both tell the user how to use the program. While I appreciate the  
completeness of the new documentation, having to search three  
different manuals, while the older documentation keeps everything in  
one place, makes life a bit difficult, especially for someone who only  
pulls out lilypond to engrave  a score every couple of weeks. I don't  
really use the program on a daily basis except when I have a project  
due.

Sorry, just some thoughts while I was writing the email. Learning  
manual. I'll download that now.