LSR: Local update.

[lilypond.git] / Documentation / application.tely

diff --git a/Documentation/application.tely b/Documentation/application.tely
index c1b38b71c627fd2465abb44ccd276800cc685156..f8c8d8ef1e580421b0c6812dd5f19c6379933baa 100644 (file)
--- a/Documentation/application.tely
+++ b/Documentation/application.tely
@@ -11,10 +11,12 @@
 @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
@@ -25,98 +27,64 @@
 @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
+@c TOC -- non-tex
 
 @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
-
-@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 
-FIXME FIXME FIXME
-@c @rlearning{About the documentation}.
-
-@cindex web site
-@cindex URL
-
-More information can be found at
-@uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
-of this and other documentation.
+@introText{}
 
 @c * Install::                        How to install or compile.
 @c * Setup::                          Using LilyPond with other programs.
@@ -128,6 +96,7 @@ of this and other documentation.
 * 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
@@ -146,6 +115,7 @@ Appendices
 @include application/updating.itely
 @include application/lilypond-book.itely
 @include application/converters.itely
+@include application/working.itely
 @include application/suggestions.itely
 
 @include fdl.itexi