]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/lilypond.tely
* Another grand 2003 update.
[lilypond.git] / Documentation / user / lilypond.tely
index 1c88efb3347faf465a491b07c90a336ef7094219..69f48c53cc885bf8faf97c024fbbd9d381ff5f44 100644 (file)
@@ -2,23 +2,80 @@
 @setfilename lilypond.info
 @settitle GNU LilyPond
 
+@html
+<!--- @@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--2001 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
@@ -30,11 +87,11 @@ Copyright @copyright{} 1999--2001 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
@@ -43,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}.
-@end ifhtml
-
 @chapter GNU LilyPond --- The music typesetter
 
-LilyPond produces sheet music from input files.  This document describes
-how to use LilyPond.
+This is the user manual for GNU LilyPond 1.7.16.
 
 @cindex web site
 
@@ -69,23 +121,17 @@ this and other documentation.
 
 @menu
 * Preface::                        Preface.
+* Introduction::                   What, Why, How.
 * Tutorial::                       A tutorial introduction to LilyPond.
 * Reference Manual::               Reference Manual.
-* Mutopia project::                Mutopia project.
+* Advanced Topics::                How it all works.
 * Invoking LilyPond::              Operation.
-* Bug reports::                    Where to report bugs.
-* ly2dvi::                         Generating nice output with titles.
-* convert-ly::                     Upgrading input files.
-* Conversion tools::               Converting to lilypond source format.
-* lilypond-book::                  Interleaving text with music.
-* Internals::                      How it all works.
-* Literature::                     Additional reading
-* Full Grob interface list::       Generated list of all Grob properties.
-* Index of internals:(lilypond-internals).  Auto generated detailed documentation.
+* 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.
-* Function Index::                 Function index.
-* Refman appendix::
-* GNU Free Documentation License::     FDL.
+* Reference manual details::                
+* GNU Free Documentation License:: FDL.
 @end menu
 @end ifnottex
 
@@ -94,18 +140,15 @@ this and other documentation.
 
 @mbinclude macros.itexi
 @mbinclude preface.itely
+@mbinclude introduction.itely 
 @mbinclude tutorial.itely
 @mbinclude refman.itely
-@mbinclude mutopia.itely
+@mbinclude literature.itely
 @mbinclude internals.itely
 @mbinclude invoking.itexi
-@mbinclude bugs.itexi
-@mbinclude ly2dvi.itexi
-@mbinclude convert-ly.itexi
 @mbinclude lilypond-book.itely
 @mbinclude converters.itely
-@mbinclude literature.itely
-@mbinclude interfaces.itexi
+
 
 @c FIXME: Index has two alphabetically sorted lists @code vs plain?
 @node Index
@@ -113,11 +156,6 @@ this and other documentation.
 
 @printindex cp
 
-@node Function Index
-@unnumbered Function Index
-
-@printindex fn
-
 @mbinclude appendices.itely
 @mbinclude fdl.itexi