@documentlanguage en
@include macros.itexi
+@c This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
@afourpaper
-
@c don't remove this comment.
@ignore
@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
@end ignore
-@ifnottex
-@node Top
-@top GNU LilyPond --- Application Usage
-@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-@end ifnottex
+@copying
+Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005,
+2006, 2007, 2008, 2009 by the authors.
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end copying
-@ifhtml
-@ifclear bigpage
-This document is also available as a
-@uref{source/Documentation/application.pdf,PDF} and as
-@uref{source/Documentation/application-big-page.html,one big page}.
-@end ifclear
-@ifset bigpage
-This document is also available as a
-@uref{source/Documentation/application.pdf,PDF} and as
-@uref{source/Documentation/application/index.html,HTML indexed multiple pages}.
-@end ifset
-@end ifhtml
+@macro introText
+@cartouche
+This file explains how to execute the programs distributed with
+GNU LilyPond version @version{}. In addition, it suggests some
+@qq{best practices} for efficient usage.
+For more information about how this fits with the other
+documentation, or to read this manual in other formats, see
+@rgeneral{Manuals}.
+@end cartouche
+@end macro
-@c This produces the unified index
-@syncodeindex fn cp
-@syncodeindex vr cp
+@c TITLE PAGE
+@ifnottex
+@node Top
+@top GNU LilyPond --- Learning Manual
+@end ifnottex
@finalout
@titlepage
@title LilyPond
@subtitle The music typesetter
-@titlefont{Program usage}
+@titlefont{Learning Manual}
@author The LilyPond development team
+@vskip 100pt
-Copyright @copyright{} 1999--2009 by the authors
+@introText{}
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
+@vskip 0pt plus 1filll
+@c @vskip 20pt
-@vskip 20pt
+@insertcopying{}
For LilyPond version @version{}
@end titlepage
-@copying
-Copyright @copyright{} 1999--2009 by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end copying
-
-@ifnottex
-This file documents GNU LilyPond program usage.
-
-Copyright 1999--2009 by the authors
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end ifnottex
+@c TOC -- non-tex
@ifnottex
-This is the Application Usage (AU) manual for GNU LilyPond version @version{}.
-For more information about how this fits with the other
-documentation, see @rlearning{About the documentation}.
-
-@cindex web site
-@cindex URL
+@introText{}
-More information can be found at
-@uref{http://@/www@/.lilypond@/.org/}. The website contains on-line copies
-of this and other documentation.
+@c * Install:: How to install or compile.
+@c * Setup:: Using LilyPond with other programs.
+@c maybe add a "Tasks" or "Specific tasks" or something like
+@c that, after Suggestions -gp
@menu
-* Install:: How to install or compile.
-* Setup:: Using LilyPond with other programs.
-* Running LilyPond:: Operation.
-* LilyPond-book:: Integrating text and music.
+* Running lilypond:: Operation.
+* Updating files with convert-ly:: Updating input files.
+* lilypond-book:: Integrating text and music.
* Converting from other formats:: Converting to lilypond source format.
+* Working on LilyPond projects:: Working on non-working files.
+* Suggestions for writing files:: Best practices
Appendices
@contents
-@include application/install.itely
-@include application/setup.itely
+@c @include application/install.itely
+@c @include application/setup.itely
@include application/running.itely
+@include application/updating.itely
@include application/lilypond-book.itely
@include application/converters.itely
+@include application/working.itely
+@include application/suggestions.itely
@include fdl.itexi