]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/lilypond.tely
Merge branch 'master' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond
[lilypond.git] / Documentation / user / lilypond.tely
index e736bee6c869611d0160e242977f266b660b48fb..0631951f5ae237ab2a5e22c3f9c1008e4eea1073 100644 (file)
@@ -1,15 +1,29 @@
 \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
+    install-info --info-dir=/usr/share/info out[-www]/lilypond.info
 
   * Prepend GNU for dir, must be unique.
 
@@ -22,18 +36,25 @@ Distributions will want to install lilypond.info in postinstall, doing:
 @c    LilyPond  program.
 @end ignore
 
-@dircategory GNU music project
+
+@c
+@c Info files are no longer installed in a subdirectory, images are
+@c expected to be found in lilypond/ subdirectory.
+@dircategory GNU LilyPond --- the music typesetter
 @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 Learning Manual: (lilypond-learning).  Start here.
+* Music Glossary: (music-glossary).               For non-English users.
+* LilyPond: (lilypond).                           LilyPond Notation Reference.
+* LilyPond Internals Reference: (lilypond-internals).  Definitions for tweaking.
+* LilyPond Application Usage: (lilypond-program). Installing and running applications.
+* abc2ly: (lilypond-program)Invoking abc2ly.      Importing ABC.      
+* convert-ly: (lilypond-program)Updating files with convert-ly. Older LilyPond versions.
+* etf2ly: (lilypond-program)Invoking etf2ly.      Importing Finale.
+* lilypond-book: (lilypond-program)LilyPond-book. Integrating text and music.
+* midi2ly: (lilypond-program)Invoking midi2ly.    Importing MIDI.
+* musicxml2ly: (lilypond-program)Invoking musicxml2ly.  Importing MusicXML.
 @end direntry
 
-
 @c don't remove this comment.
 @ignore
 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
@@ -46,18 +67,13 @@ Distributions will want to install lilypond.info in postinstall, doing:
 
 @ifhtml
 This document is also available as a
-@uref{source/Documentation/user/lilypond.pdf,PDF}.
+@uref{source/Documentation/user/lilypond.pdf,PDF} and as
+@uref{source/Documentation/user/lilypond-big-page.html,one big page}.
 @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
 
 
@@ -66,18 +82,19 @@ This document is also available as a
 @titlepage
 @title LilyPond
 @subtitle The music typesetter
+@titlefont{User manual}
 @author The LilyPond development team
 
+Copyright @copyright{} 1999--2007 by the authors
 
-
-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
 
@@ -98,28 +115,40 @@ Copyright @copyright{} 1999--2006 by the authors
 
 @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--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''.
+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 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.8.x series.
+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
@@ -134,38 +163,23 @@ of this and other documentation.
 @include dedication.itely
 
 @menu
-Learning Manual
-
-* Preface::                        Preface.
-* Introduction::                   What, Why, How.
-* Tutorial::                       A tutorial introduction.
-* 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
-
-* Basic notation::                 Standard musical notation.
-* Instrument-specific notation::   Specialized notation.
-* Advanced notation::              Less frequently used notation.
+* 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.
-* Global issues::                  What LilyPond produces.
 * Interfaces for programmers::     Expert usage.
 
-Technical Details
-
-* Running LilyPond::               Operation.
-* LilyPond-book::                  Integrating text and music.
-* Converting from other formats::  Converting to lilypond source format.
-
 Appendices
 
 * 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
@@ -174,37 +188,35 @@ Appendices
 
 
 @include macros.itexi
-@include preface.itely
-@include introduction.itely
-@include tutorial.itely
-@include putting.itely
-@include working.itely
-@include tweaks.itely
-
-@include basic-notation.itely
-@include instrument-notation.itely
-@include advanced-notation.itely
-@include changing-defaults.itely
-@include global.itely
-@include programming-interface.itely
 
-@include invoking.itely
-@include lilypond-book.itely
-@include converters.itely
+@include notation.itely
+@include specialist.itely
 
+@include input.itely
+@include non-music.itely
+@include spacing.itely
 
+@include changing-defaults.itely
+@include programming-interface.itely
 
 
 @include literature.itely
-@include scheme-tutorial.itely
 @include notation-appendices.itely
-@include examples.itely
 @include cheatsheet.itely
 @include fdl.itexi
 
+@node LilyPond command index
+@appendix LilyPond command index
+
+This index does blah blah blah.
+
+@printindex ky
+
 @node LilyPond index
 @appendix LilyPond index
 
+In contrast, this index does blaz blaz blaz.
+
 @printindex cp
 
 @bye