Documentation/user/lilypond.tely

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