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