]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/lilypond.tely
Imported sources
[lilypond.git] / Documentation / user / lilypond.tely
index 975ec859faa555b6ae7424d770d0cadb5d80f8ac..b83b0dc075d5a9191f1a24f8f10787fffd353d6c 100644 (file)
@@ -1,24 +1,85 @@
 \input texinfo @c -*-texinfo-*-
 @setfilename lilypond.info
 @settitle GNU LilyPond
+@iftex
+@afourpaper
+@end iftex
 
+@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.
+* lilypond: (lilypond)Invoking lilypond::      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 Applications|Publishing
+@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
+
+* if you do, capitalization is LilyPond.
+
+
+* 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.
+
+* abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
+
+@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 Han-Wen Nienhuys, Jan Nieuwenhuizen, Adrian Mariano,  Tom Cato Amundsen
+@author Han-Wen Nienhuys
+@author Jan Nieuwenhuizen
+@author J@"{u}rgen Reuter
+@author Rune Zedeler
 
 
-Copyright @copyright{} 1999--2001 by the authors
+
+Copyright @copyright{} 1999--2004 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
@@ -27,13 +88,32 @@ Copyright @copyright{} 1999--2001 by the authors
   A copy of the license is included in the section entitled ``GNU
   Free Documentation License''.
 
+@vskip 20pt
+
+  
+@lilypond[raggedright]
+\score {
+    \context LyricsVoice \notes {
+        \property Score.RehearsalMark \set #'self-alignment-X = #LEFT
+        \mark #(ly:export (string-append
+             "(For LilyPond version " (lilypond-version) ")"))
+        s2
+     }
+     \paper {
+         indent = 0.0\pt
+         raggedright = ##t
+     }
+}
+@end lilypond
+  
 
 @end titlepage
 
-@ifinfo
+
+@ifnottex
 This file documents GNU LilyPond.
 
-Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
+Copyright 1999--2004 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
@@ -42,21 +122,16 @@ Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
   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 2.1.0.
 
 @cindex web site
 
@@ -64,58 +139,49 @@ A further source of information is the website, which can be found at
 @uref{http://www.lilypond.org/}.  The website contains on-line copies of
 this and other documentation.
 
-@mbinclude dedication.itely
+@include dedication.itely
 
 @menu
-* Preface::                        Preface 
-* Tutorial::                       A tutorial introduction to LilyPond.
-* Reference Manual::               Reference Manual.
-* Tricks::                         Features, tips and tricks.
+* Preface::                        Preface.
+* Introduction::                   What, Why, How.
+* Tutorial::                       A tutorial introduction.
+* Notation manual::                All notation supported, and how to
+                                   produce it.
+* Literature list::                Books about notation and engraving.
+* Technical manual::               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
-* Index of internals:(lilypond-internals).  Auto generated detailed documentation.
-* Index::                          Unified index.
-* Function Index::                 Function index.
-* Refman appendix::
-* GNU Free Documentation License::     FDL.
+* Converting from other formats::  Converting to lilypond source format.
+* lilypond-book manual::           Integrating text and music with lilypond-book.
+* Unified index::                  
+* Reference manual details::
+* Cheat sheet::     
+* GNU Free Documentation License:: FDL.
 @end menu
 @end ifnottex
 
-
 @contents
 
-@mbinclude macros.itexi
-@mbinclude preface.itely
-@mbinclude tutorial.itely
-@mbinclude refman.itely
-@mbinclude tricks.itely
-@mbinclude internals.itely
-@mbinclude invoking.itexi
-@mbinclude bugs.itexi
-@mbinclude ly2dvi.itexi
-@mbinclude convert-ly.itexi
-@mbinclude lilypond-book.itely
-@mbinclude convertors.itely
-@mbinclude literature.itely
 
-@c FIXME: Index has two alphabetically sorted lists @code vs plain?
-@node Index
-@unnumbered Index
+@include macros.itexi
+@include preface.itely
+@include introduction.itely 
+@include tutorial.itely
+@include refman.itely
+@include literature.itely
+@include internals.itely
+@include invoking.itexi
+@include lilypond-book.itely
+@include converters.itely
 
-@printindex cp
 
-@node Function Index
-@unnumbered Function Index
+@c FIXME: Index has two alphabetically sorted lists @code vs plain?
+@node Unified index
+@unnumbered Unified index
 
-@printindex fn
+@printindex cp
 
-@mbinclude appendices.itely
-@mbinclude fdl.itexi
+@include appendices.itely
+@include cheatsheet.itely
+@include fdl.itexi
 
 @bye