]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/lilypond.tely
*** empty log message ***
[lilypond.git] / Documentation / user / lilypond.tely
index 35f4a3f044e3f54ddebca2f2901b92e657fa0635..c80600f362d4fd4323045698550d51725f12b528 100644 (file)
@@ -5,18 +5,34 @@
 @afourpaper
 @end iftex
 
-@dircategory GNU music project
+@c  Keep this here, since it pertains to the direntry below.
+@ignore
+Distributions will want to install lilypond.info in postinstall, doing:
+
+    install-info --info-dir=/usr/share/info out/lilypond.info
+
+  * Prepend GNU for dir, must be unique.
+
+  * Do not list the `lilypond' node at toplevel, so that `info lilypond'
+    goes to Top.
+
+  * List all commands in direntry.
+
+@c  * lilypond: (lilypond/lilypond)Running LilyPond.      Invoking the
+@c    LilyPond  program.
+@end ignore
+
+@dircategory LilyPond
 @direntry
-* LilyPond: (lilypond/lilypond).           The GNU music typesetter.
-* abc2ly: (lilypond/lilypond)Invoking abc2ly.          Importing ABC.          
-* convert-ly: (lilypond/lilypond)Invoking convert-ly.  Older LilyPond versions.
-* etf2ly: (lilypond/lilypond)Invoking etf2ly.          Importing Finale.
-* lilypond-book: (lilypond/lilypond)LilyPond-book.     Itegrating text and music.
-* midi2ly: (lilypond/lilypond)Invoking midi2ly.        Importing MIDI.
-* mup2ly: (lilypond/lilypond)Invoking mup2ly.          Importing Mup. 
+* LilyPond: (lilypond).           The GNU music typesetter.
+* abc2ly: (lilypond)Invoking abc2ly.          Importing ABC.      
+* convert-ly: (lilypond)Invoking convert-ly.  Older LilyPond versions.
+* etf2ly: (lilypond)Invoking etf2ly.          Importing Finale.
+* lilypond-book: (lilypond)LilyPond-book.     Itegrating text and music.
+* midi2ly: (lilypond)Invoking midi2ly.        Importing MIDI.
+* mup2ly: (lilypond)Invoking mup2ly.          Importing Mup.
 @end direntry
 
-
 @c don't remove this comment.
 @ignore
 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
 
 
 @ifhtml
-This document is also available in @uref{source/Documentation/user/lilypond.pdf,PDF}.
+This document is also available as a
+@uref{source/Documentation/user/lilypond.pdf,PDF}.
 @end ifhtml
 
 
-@documentlanguage en
-@documentencoding utf-8
-
-@c FIXME: Index has two alphabetically sorted lists @code vs plain?
+@c  This produces the unified index
 @syncodeindex fn cp
-@syncodeindex ky cp
-@syncodeindex pg cp
-@syncodeindex tp cp
 @syncodeindex vr cp
 
+@documentlanguage en
+@documentencoding utf-8
+
 
 @finalout
 
@@ -54,12 +68,14 @@ This document is also available in @uref{source/Documentation/user/lilypond.pdf,
 
 Copyright @copyright{} 1999--2006 by the authors
 
-  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''.
+@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 20pt
 
@@ -67,7 +83,7 @@ Copyright @copyright{} 1999--2006 by the authors
 \score {
   \context Lyrics {
     \override Score.RehearsalMark #'self-alignment-X = #LEFT
-    \override Score.RehearsalMark #'font-size = #-2 
+    \override Score.RehearsalMark #'font-size = #-2
     \mark #(ly:export (string-append
       "(For LilyPond version " (lilypond-version) ")"))
     s2
@@ -80,22 +96,34 @@ Copyright @copyright{} 1999--2006 by the authors
 
 @end titlepage
 
+@copying
+Copyright @copyright{} 1999--2006 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.
 
 Copyright 1999--2006 by the authors
 
-  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''.
-
+@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
 @node Top
 @top GNU LilyPond --- The music typesetter
@@ -109,33 +137,33 @@ This is the user manual for GNU LilyPond 2.8.x series.
 @cindex web site
 @cindex URL
 
-A further source of information is the website, which can be found at
+More information can be found at
 @uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
 of this and other documentation.
 
 @include dedication.itely
 
 @menu
-Learning manual
+Learning Manual
 
 * Preface::                        Preface.
 * Introduction::                   What, Why, How.
 * Tutorial::                       A tutorial introduction.
-* Putting it all together:: Advanced tutorial?  FIXME title
-* Working on LilyPond projects::   Demonstrates real-life LilyPond usage.
-* Tweaking output:: Tutorial-style explanation of chapters 10 and 11. FIXME title
+* Putting it all together::        More explanation about LilyPond concepts.
+* Working on LilyPond projects::   Discusses real-life usage.
+* Tweaking output::                Introduction to modifying output.
 
-Notation reference
+Notation Reference
 
 * Basic notation::                 Standard musical notation.
-* Instrument-specific notation::   Notation that is only used for some
-                                   instruments.
+* Instrument-specific notation::   Specialized notation.
 * Advanced notation::              Less frequently used notation.
 * Changing defaults::              Tuning output.
-* Global issues::                  What LilyPond produces.
-* Interfaces for programmers::
+* Non-musical notation::           Output that is not musical notation.
+* Spacing issues::                 Display of output on paper.
+* Interfaces for programmers::     Expert usage.
 
-Technical details
+Program usage
 
 * Running LilyPond::               Operation.
 * LilyPond-book::                  Integrating text and music.
@@ -143,12 +171,13 @@ Technical details
 
 Appendices
 
-* Literature list::
-* Scheme tutorial::
-* Notation manual details::
-* Example templates::              Larger examples.
-* Cheat sheet::     
-* GNU Free Documentation License:: FDL.
+* Literature list::                Reference works about music notation.
+* Scheme tutorial::                Programming inside LilyPond.
+* Notation manual tables::         Tables and charts.
+* Example templates::              Ready-made templates.
+* Cheat sheet::                    Summary of LilyPond syntax.
+* GNU Free Documentation License:: License of this document.
+* LilyPond command index::
 * LilyPond index::
 @end menu
 @end ifnottex
@@ -158,7 +187,7 @@ Appendices
 
 @include macros.itexi
 @include preface.itely
-@include introduction.itely 
+@include introduction.itely
 @include tutorial.itely
 @include putting.itely
 @include working.itely
@@ -169,6 +198,7 @@ Appendices
 @include advanced-notation.itely
 @include changing-defaults.itely
 @include global.itely
+@include page.itely
 @include programming-interface.itely
 
 @include invoking.itely
@@ -176,8 +206,6 @@ Appendices
 @include converters.itely
 
 
-
-
 @include literature.itely
 @include scheme-tutorial.itely
 @include notation-appendices.itely
@@ -185,6 +213,11 @@ Appendices
 @include cheatsheet.itely
 @include fdl.itexi
 
+@node LilyPond command index
+@appendix LilyPond command index
+
+@printindex ky
+
 @node LilyPond index
 @appendix LilyPond index