]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/lilypond.tely
Update from Kurt.
[lilypond.git] / Documentation / user / lilypond.tely
index c891847585290ae91c10715444d73697aeed556d..dc8a5298337e7680cbb3085a36d011719214fe2c 100644 (file)
-\input texinfo @c -*-texinfo-*-
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
 @setfilename lilypond.info
-@settitle GNU LilyPond
+@settitle GNU LilyPond user manual
+@documentencoding UTF-8
+@documentlanguage en
+
 @iftex
 @afourpaper
+@c don't replace quotes with directed quotes
+@tex
+\gdef\SETtxicodequoteundirected{Foo}
+\gdef\SETtxicodequotebacktick{Bla}
+@end tex
 @end iftex
 
+@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
 
-@ignore
-Distributions will want to install lilypond.info doing:
+  * Prepend GNU for dir, must be unique.
 
-    ./install-info --info-dir=/usr/share/info out/lilypond.info
-    
+  * 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 GNU music project
+
+
+@c
+@c Info files are installed in subdirectories to allow images to be present. 
+@c 
+@dircategory LilyPond
 @direntry
-@c    ;; prepend GNU for dir, must be unique
-* 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. 
+* LilyPond: (lilypond/lilypond).           The GNU music typesetter.
+* abc2ly: (lilypond/lilypond-program)Invoking abc2ly.          Importing ABC.      
+* convert-ly: (lilypond/lilypond-program)Invoking convert-ly.  Older LilyPond versions.
+* etf2ly: (lilypond/lilypond-program)Invoking etf2ly.          Importing Finale.
+* lilypond-book: (lilypond/lilypond-program)LilyPond-book.     Integrating text and music.
+* midi2ly: (lilypond/lilypond-program)Invoking midi2ly.        Importing MIDI.
 @end direntry
 
-
+@c don't remove this comment.
 @ignore
-@omfcreator Han-Wen Nienhuys and Jan Nieuwenhuizen
-@omfdescription User manual  of the LilyPond music engraving system
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
+@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.
+@ifhtml
+This document is also available as a
+@uref{source/Documentation/user/lilypond.pdf,PDF} and as
+@uref{source/Documentation/user/lilypond-big-page.html,one big page}.
+@end ifhtml
 
-* abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
 
-@end ignore
+@c  This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
 
-@ifhtml
-This document is also available in @uref{../lilypond.ps.gz,gzipped
-PostScript} and @uref{../lilypond.pdf,PDF}.
-@end ifhtml
 
+@finalout
 
 @titlepage
-@title GNU LilyPond
+@title LilyPond
 @subtitle The music typesetter
-@author Han-Wen Nienhuys
-@author Jan Nieuwenhuizen
-@author J@"{u}rgen Reuter
-@author Rune Zedeler
-
+@titlefont{User manual}
+@author The LilyPond development team
 
+Copyright @copyright{} 1999--2007 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
-  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
 
-  
-@lilypond[singleline]
-\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 
- }
+@lilypond[ragged-right]
+\score {
+  \context Lyrics {
+    \override Score.RehearsalMark #'self-alignment-X = #LEFT
+    \override Score.RehearsalMark #'font-size = #-2
+    \mark #(ly:export (string-append
+      "(For LilyPond version " (lilypond-version) ")"))
+    s2
 }
+  \layout {
+    indent = 0.0\pt
 }
 }
 @end lilypond
-  
 
 @end titlepage
 
+@copying
+Copyright @copyright{} 1999--2007 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--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
-  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''.
+Copyright 1999--2007 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
 @node Top
-@top
-
-@chapter GNU LilyPond --- The music typesetter
+@top GNU LilyPond --- The music typesetter
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
 
-This is the user manual for GNU LilyPond 2.1.0.
+This is the user manual for GNU LilyPond 2.11.x series.
+@ifhtml
+(See the bottom of this page for the exact version number).
+@end ifhtml
 
 @cindex web site
+@cindex URL
 
-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.
+More information 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.
-* 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.
-* 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.
+* Musical notation::               Musical notation.
+* Specialist notation::            Notation which is only used for
+    specific purposes.
+* Input syntax::                   General information about
+    lilypond input files.
+* Non-musical notation::           Output that is not musical notation.
+* Spacing issues::                 Display of output on paper.
+* Changing defaults::              Tuning output.
+* Interfaces for programmers::     Expert usage.
+
+Appendices
+
+* Literature list::                Reference works about music notation.
+* Notation manual tables::         Tables and charts.
+* Cheat sheet::                    Summary of LilyPond syntax.
+* GNU Free Documentation License:: License of this document.
+* LilyPond command index::
+* LilyPond index::
 @end menu
 @end ifnottex
 
-
 @contents
 
-@mbinclude macros.itexi
-@mbinclude preface.itely
-@mbinclude introduction.itely 
-@mbinclude tutorial.itely
-@mbinclude refman.itely
-@mbinclude literature.itely
-@mbinclude internals.itely
-@mbinclude invoking.itexi
-@mbinclude lilypond-book.itely
-@mbinclude converters.itely
 
+@include macros.itexi
 
-@c FIXME: Index has two alphabetically sorted lists @code vs plain?
-@node Unified index
-@unnumbered Unified index
+@include notation.itely
+@include specialist.itely
+
+@include input.itely
+@include non-music.itely
+@include spacing.itely
+
+@include changing-defaults.itely
+@include programming-interface.itely
 
-@printindex cp
 
-@mbinclude appendices.itely
-@mbinclude cheatsheet.itely
-@mbinclude fdl.itexi
+@include literature.itely
+@include notation-appendices.itely
+@include cheatsheet.itely
+@include fdl.itexi
+
+@node LilyPond command index
+@appendix LilyPond command index
+
+@printindex ky
+
+@node LilyPond index
+@appendix LilyPond index
+
+@printindex cp
 
 @bye