-\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
+
@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
-
+
+ * Prepend GNU for dir, must be unique.
+
+ * 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
-@c do not list the `lilypond' node at toplevel, so that `info lilypond'
-@c goes to Top.
-@c * lilypond: (lilypond/lilypond)Invoking LilyPond. Titling LilyPond scores.
-* GNU LilyPond: (lilypond/lilypond). The GNU music typesetter.
+* LilyPond: (lilypond/lilypond). The GNU music typesetter.
+* abc2ly: (lilypond/lilypond)Invoking abc2ly. Importing ABC.
* convert-ly: (lilypond/lilypond)Invoking convert-ly. Older LilyPond versions.
-* midi2ly: (lilypond/lilypond)Invoking midi2ly. Importing MIDI.
* etf2ly: (lilypond/lilypond)Invoking etf2ly. Importing Finale.
-* abc2ly: (lilypond/lilypond)Invoking abc2ly. Importing ABC.
-* musedata2ly: (lilypond/lilypond)Invoking musedata2ly. Importing MuseData.
-* mup2ly: (lilypond/lilypond)Invoking mup2ly. Importing Mup.
+* lilypond-book: (lilypond/lilypond)LilyPond-book. Itegrating text and music.
+* midi2ly: (lilypond/lilypond)Invoking midi2ly. Importing MIDI.
+* mup2ly: (lilypond/lilypond)Invoking mup2ly. Importing Mup.
@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
-
-* Try not to use punctuation between introductocing sentence and
-display material (verbatim, music, example code).
-
-* Do not refer to LilyPond in the text. The reader knows what the
-manual is about.
-
-* If you do, capitalization is LilyPond.
-
-* Do not explicitly refer to the reader/user. There is no one else
-besides the reader and the writer.
-
-* Do not use abbreviations (don't, won't, etc.).
-
-* Avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
-
-* Avoid long stretches of input code. Noone is going 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.
-
-* Colon usage
- 0. Do not use a colon to introduce examples, sentences just continue
+@ifhtml
+This document is also available as a
+@uref{source/Documentation/user/lilypond.pdf,PDF}.
+@end ifhtml
- in the display material.
- 1. To introduce lists
- 2. When beginning a quote: "So, he said,..."
- This usage is rarer. Americans often just use a comma.
- 3. When adding a defining example at the end of a sentence.
+@c This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
-@end ignore
+@documentlanguage en
+@documentencoding utf-8
-@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
+@author The LilyPond development team
-Copyright @copyright{} 1999--2004 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
-%% Not yet debugged or reported. This crashes gs-8.01:
-%% compiling gs-8.01 right now... -- jcn
-@lilypond[raggedright]
+@lilypond[ragged-right]
\score {
- \context Lyrics \notes {
- \override Score.RehearsalMark #'self-alignment-X = #LEFT
- \mark #(ly:export (string-append
- "(For LilyPond version " (lilypond-version) ")"))
- s2
- }
- \paper {
- indent = 0.0\pt
- raggedright = ##t
- }
+ \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--2006 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--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
- 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--2006 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.3.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
@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.
@include dedication.itely
@menu
+Learning Manual
+
* Preface:: Preface.
* Introduction:: What, Why, How.
* Tutorial:: A tutorial introduction.
-* Notation manual:: All notation supported, and how to
- produce it.
+* 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.
* Changing defaults:: Tuning output.
-* Invoking LilyPond:: Operation.
+* Non-musical notation:: Output that is not musical notation.
+* Spacing issues:: Display of output on paper.
+* Interfaces for programmers:: Expert usage.
+
+Program usage
+
+* Running LilyPond:: Operation.
+* LilyPond-book:: Integrating text and music.
* Converting from other formats:: Converting to lilypond source format.
-* lilypond-book manual:: Integrating text and music with lilypond-book.
-* Unified index::
-* Notation manual details::
-* Literature list::
-* Interfaces for programmers::
-* Cheat sheet::
-* GNU Free Documentation License:: FDL.
+
+Appendices
+
+* Literature list:: Reference works about music notation.
+* Scheme tutorial:: Programming inside LilyPond.
+* Notation manual tables:: Tables and charts.
+* 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
@include macros.itexi
@include preface.itely
-@include introduction.itely
+@include introduction.itely
@include tutorial.itely
-@include notation.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 invoking.itexi
+@include non-music.itely
+@include spacing.itely
+@include programming-interface.itely
+
+@include running.itely
@include lilypond-book.itely
@include converters.itely
-@c FIXME: Index has two alphabetically sorted lists @code vs plain?
-@node Unified index
-@unnumbered Unified index
-
-@printindex cp
-
+@include literature.itely
+@include scheme-tutorial.itely
@include notation-appendices.itely
+@include templates.itely
+@include cheatsheet.itely
+@include fdl.itexi
-@include literature.itely
+@node LilyPond command index
+@appendix LilyPond command index
-@include programming-interface.itely
+@printindex ky
-@include cheatsheet.itely
+@node LilyPond index
+@appendix LilyPond index
-@include fdl.itexi
+@printindex cp
@bye