]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/user/lilypond.tely
Split user manual by creating "program-usage" manual
[lilypond.git] / Documentation / user / lilypond.tely
1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  See TRANSLATION for details.
7 @end ignore
8 @setfilename lilypond.info
9 @settitle GNU LilyPond user manual
10
11 @iftex
12 @afourpaper
13 @c don't replace quotes with directed quotes
14 @tex
15 \gdef\SETtxicodequoteundirected{Foo}
16 \gdef\SETtxicodequotebacktick{Bla}
17 @end tex
18 @end iftex
19
20 @c  Keep this here, since it pertains to the direntry below.
21 @ignore
22 Distributions will want to install lilypond.info in postinstall, doing:
23
24     install-info --info-dir=/usr/share/info out/lilypond.info
25
26   * Prepend GNU for dir, must be unique.
27
28   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
29     goes to Top.
30
31   * List all commands in direntry.
32
33 @c  * lilypond: (lilypond/lilypond)Running LilyPond.      Invoking the
34 @c    LilyPond  program.
35 @end ignore
36
37
38 @c
39 @c Info files are installed in subdirectories to allow images to be present. 
40 @c 
41 @dircategory LilyPond
42 @direntry
43 * LilyPond: (lilypond/lilypond).           The GNU music typesetter.
44 * abc2ly: (lilypond/lilypond-program)Invoking abc2ly.          Importing ABC.      
45 * convert-ly: (lilypond/lilypond-program)Invoking convert-ly.  Older LilyPond versions.
46 * etf2ly: (lilypond/lilypond-program)Invoking etf2ly.          Importing Finale.
47 * lilypond-book: (lilypond/lilypond-program)LilyPond-book.     Itegrating text and music.
48 * midi2ly: (lilypond/lilypond-program)Invoking midi2ly.        Importing MIDI.
49 * mup2ly: (lilypond/lilypond-program)Invoking mup2ly.          Importing Mup.
50 @end direntry
51
52 @c don't remove this comment.
53 @ignore
54 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
55 @omfdescription User manual of the LilyPond music engraving system
56 @omftype user manual
57 @omfcategory Applications|Publishing
58 @omflanguage English
59 @end ignore
60
61
62 @ifhtml
63 This document is also available as a
64 @uref{source/Documentation/user/lilypond.pdf,PDF} and as
65 @uref{source/Documentation/user/lilypond-big-page.html,one big page}.
66 @end ifhtml
67
68
69 @c  This produces the unified index
70 @syncodeindex fn cp
71 @syncodeindex vr cp
72
73 @documentlanguage en
74 @documentencoding utf-8
75
76
77 @finalout
78
79 @titlepage
80 @title LilyPond
81 @subtitle The music typesetter
82 @titlefont{User manual}
83 @author The LilyPond development team
84
85 Copyright @copyright{} 1999--2006 by the authors
86
87 @quotation
88 Permission is granted to copy, distribute and/or modify this document
89 under the terms of the GNU Free Documentation License, Version 1.1
90 or any later version published by the Free Software Foundation;
91 with no Invariant Sections.
92 A copy of the license is included in the section entitled ``GNU
93 Free Documentation License''.
94 @end quotation
95
96 @vskip 20pt
97
98 @lilypond[ragged-right]
99 \score {
100   \context Lyrics {
101     \override Score.RehearsalMark #'self-alignment-X = #LEFT
102     \override Score.RehearsalMark #'font-size = #-2
103     \mark #(ly:export (string-append
104       "(For LilyPond version " (lilypond-version) ")"))
105     s2
106   }
107   \layout {
108     indent = 0.0\pt
109   }
110 }
111 @end lilypond
112
113 @end titlepage
114
115 @copying
116 Copyright @copyright{} 1999--2006 by the authors
117
118 @quotation
119 Permission is granted to copy, distribute and/or modify this document
120 under the terms of the GNU Free Documentation License, Version 1.1
121 or any later version published by the Free Software Foundation;
122 with no Invariant Sections.
123 A copy of the license is included in the section entitled ``GNU
124 Free Documentation License''.
125 @end quotation
126 @end copying
127
128 @ifnottex
129 This file documents GNU LilyPond.
130
131 Copyright 1999--2006 by the authors
132
133 @quotation
134 Permission is granted to copy, distribute and/or modify this document
135 under the terms of the GNU Free Documentation License, Version 1.1
136 or any later version published by the Free Software Foundation;
137 with no Invariant Sections.
138 A copy of the license is included in the section entitled ``GNU
139 Free Documentation License''.
140 @end quotation
141 @end ifnottex
142
143 @ifnottex
144 @node Top
145 @top GNU LilyPond --- The music typesetter
146 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
147
148 This is the user manual for GNU LilyPond 2.11.x series.
149 @ifhtml
150 (See the bottom of this page for the exact version number).
151 @end ifhtml
152
153 @cindex web site
154 @cindex URL
155
156 More information can be found at
157 @uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
158 of this and other documentation.
159
160 @include dedication.itely
161
162 @menu
163 Learning Manual
164
165 * Preface::                        Preface.
166 * Introduction::                   What, Why, How.
167 * Tutorial::                       A tutorial introduction.
168 * Putting it all together::        More explanation about LilyPond concepts.
169 * Working on LilyPond projects::   Discusses real-life usage.
170 * Tweaking output::                Introduction to modifying output.
171
172 Notation Reference
173
174 * Basic notation::                 Standard musical notation.
175 * Instrument-specific notation::   Specialized notation.
176 * Advanced notation::              Less frequently used notation.
177 * Changing defaults::              Tuning output.
178 * Non-musical notation::           Output that is not musical notation.
179 * Spacing issues::                 Display of output on paper.
180 * Interfaces for programmers::     Expert usage.
181
182 Appendices
183
184 * Literature list::                Reference works about music notation.
185 * Scheme tutorial::                Programming inside LilyPond.
186 * Notation manual tables::         Tables and charts.
187 * Templates::                      Ready-made templates.
188 * Cheat sheet::                    Summary of LilyPond syntax.
189 * GNU Free Documentation License:: License of this document.
190 * LilyPond command index::
191 * LilyPond index::
192 @end menu
193 @end ifnottex
194
195 @contents
196
197
198 @include macros.itexi
199 @include preface.itely
200 @include introduction.itely
201 @include tutorial.itely
202 @include putting.itely
203 @include working.itely
204 @include tweaks.itely
205
206 @include basic-notation.itely
207 @include instrument-notation.itely
208 @include advanced-notation.itely
209 @include changing-defaults.itely
210 @include non-music.itely
211 @include spacing.itely
212 @include programming-interface.itely
213
214
215 @include literature.itely
216 @include scheme-tutorial.itely
217 @include notation-appendices.itely
218 @include templates.itely
219 @include cheatsheet.itely
220 @include fdl.itexi
221
222 @node LilyPond command index
223 @appendix LilyPond command index
224
225 @printindex ky
226
227 @node LilyPond index
228 @appendix LilyPond index
229
230 @printindex cp
231
232 @bye