* Another grand 2003 update.

[lilypond.git] / Documentation / user / lilypond.tely

diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely
index e14e543fbe1f4d965a669775e03a4fd1dd0390cc..69f48c53cc885bf8faf97c024fbbd9d381ff5f44 100644 (file)
--- a/Documentation/user/lilypond.tely
+++ b/Documentation/user/lilypond.tely
@@ -6,23 +6,76 @@
 <!--- @@WEB-TITLE@@=User Manual --->
 @end html
 
+@ignore
+Distributions will want to install lilypond.info doing:
 
+    ./install-info --info-dir=/usr/share/info out/lilypond.info
+    
+@end ignore
 @dircategory GNU music project
 @direntry
 @c    ;; prepend GNU for dir, must be unique
-* GNU LilyPond: (lilypond).          The GNU music typesetter.
-@c * install-info: (texinfo)Invoking install-info. Update info/dir entries.
-@c * texi2dvi: (texinfo)Format with texi2dvi.      Print Texinfo documents.
+* GNU LilyPond: (lilypond).                    The GNU music typesetter.
+* ly2dvi: (lilypond)Invoking ly2dvi::          Titling LilyPond scores.
+* Glossary: (music-glossary).                  Glossary of music terms.
+* convert-ly: (lilypond)Invoking convert-ly::  Older LilyPond versions.
+* midi2ly: (lilypond)Invoking midi2ly::        Importing MIDI.
+* etf2ly: (lilypond)Invoking etf2ly::          Importing Finale.
+* abc2ly: (lilypond)Invoking abc2ly::          Importing ABC.          
+* pmx2ly: (lilypond)Invoking pmx2ly::          Importing PMX.
+* musedata2ly: (lilypond)Invoking musedata2ly::
+                                               Importing Musedata.
+* mup2ly: (lilypond)Invoking mup2ly::          Importing MUP. 
 @end direntry
 
 
+@ignore
+@omfcreator Han-Wen Nienhuys and Jan Nieuwenhuizen
+@omfdescription User manual  of the LilyPond music engraving system
+@omftype user manual
+@omfcategory Music
+@omflanguage English
+@end ignore
+
+@c don't remove this comment.
+
+@ignore
+
+HINTS FOR STYLE
+
+* don't refer to LilyPond in the text. The reader knows what the
+manual is about
+
+* don't explicitly refer to the reader/user.  There is no one else
+besides the reader and the writer.
+
+* don't use abbreviations (don't, won't, etc.)
+
+* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'') 
+
+* avoid long stretches of input code. Noone is go to read  them in
+print. Instead refer to an example input file (@inputfileref), these
+are clickable in HTML.
+
+@end ignore
+
+@ifhtml
+This document is also available in @uref{../lilypond.ps.gz,gzipped
+PostScript} and @uref{../lilypond.pdf,PDF}.
+@end ifhtml
+
+
 @titlepage
 @title GNU LilyPond
 @subtitle The music typesetter
-@author    
+@author Han-Wen Nienhuys
+@author Jan Nieuwenhuizen
+@author J@"{u}gen Reuter
+@author Rune Zedeler
+
 
 
-Copyright @copyright{} 1999--2002 by the authors
+Copyright @copyright{} 1999--2003 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
@@ -34,11 +87,11 @@ Copyright @copyright{} 1999--2002 by the authors
 
 @end titlepage
 
-@ifinfo
+
+@ifnottex
 This file documents GNU LilyPond.
 
-Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen, Adrian Mariano
-Tom Cato Amundsen.
+Copyright 1999--2003 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
@@ -47,21 +100,16 @@ Tom Cato Amundsen.
   A copy of the license is included in the section entitled ``GNU
   Free Documentation License''.
 
-@end ifinfo
+@end ifnottex
 
 
 @ifnottex
 @node Top
 @top
 
-@ifhtml
-This document is also available as a @uref{../lilypond.ps.gz,gzipped
-postscript file} and @uref{../lilypond.pdf,PDF}.
-@end ifhtml
-
 @chapter GNU LilyPond --- The music typesetter
 
-This is the user manual for GNU LilyPond 1.6.0.
+This is the user manual for GNU LilyPond 1.7.16.
 
 @cindex web site
 
@@ -74,18 +122,16 @@ this and other documentation.
 @menu
 * Preface::                        Preface.
 * Introduction::                   What, Why, How.
-* Tutorial::                       A tutorial introduction to
-LilyPond.
+* Tutorial::                       A tutorial introduction to LilyPond.
 * Reference Manual::               Reference Manual.
-* Advanced Topics::                      How it all works.
+* Advanced Topics::                How it all works.
 * Invoking LilyPond::              Operation.
-* Converting from other formats::        Converting to lilypond source format.
-* Merging text and music with lilypond-book::
-                                   The lilypond-book manual.
+* Converting from other formats::  Converting to lilypond source format.
+* lilypond-book manual::           Integrating text and music with lilypond-book.
 * Literature::                     Additional reading material.
 * Index::                          Unified index.
-* Refman appendix::
-* GNU Free Documentation License::     FDL.
+* Reference manual details::                
+* GNU Free Documentation License:: FDL.
 @end menu
 @end ifnottex
 
@@ -97,12 +143,11 @@ LilyPond.
 @mbinclude introduction.itely 
 @mbinclude tutorial.itely
 @mbinclude refman.itely
+@mbinclude literature.itely
 @mbinclude internals.itely
 @mbinclude invoking.itexi
-@mbinclude ly2dvi.itexi
 @mbinclude lilypond-book.itely
 @mbinclude converters.itely
-@mbinclude literature.itely
 
 
 @c FIXME: Index has two alphabetically sorted lists @code vs plain?