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 Notation Reference
  10 @documentencoding UTF-8
  11 @documentlanguage en
  12
  13 @include macros.itexi
  14
  15 @afourpaper
  16
  17 @c  Keep this here, since it pertains to the direntry below.
  18 @ignore
  19 Distributions will want to install lilypond.info in postinstall, doing:
  20
  21     install-info --info-dir=/usr/share/info out[-www]/lilypond.info
  22
  23   * Prepend GNU for dir, must be unique.
  24
  25   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
  26     goes to Top.
  27
  28   * List all commands in direntry.
  29
  30 @c  * lilypond: (lilypond/lilypond)Running LilyPond.      Invoking the
  31 @c    LilyPond  program.
  32 @end ignore
  33
  34
  35 @c
  36 @c Info files are no longer installed in a subdirectory, images are
  37 @c expected to be found in lilypond/ subdirectory.
  38 @dircategory GNU LilyPond --- the music typesetter
  39 @direntry
  40 * LilyPond Learning Manual: (lilypond-learning).  Start here.
  41 * Music Glossary: (music-glossary).               For non-English users.
  42 * LilyPond: (lilypond).                           LilyPond Notation Reference.
  43 * LilyPond Internals Reference: (lilypond-internals).  Definitions for tweaking.
  44 * LilyPond Application Usage: (lilypond-program). Installing and running applications.
  45 * abc2ly: (lilypond-program)Invoking abc2ly.      Importing ABC.
  46 * convert-ly: (lilypond-program)Updating files with convert-ly. Older LilyPond versions.
  47 * etf2ly: (lilypond-program)Invoking etf2ly.      Importing Finale.
  48 * lilypond-book: (lilypond-program)LilyPond-book. Integrating text and music.
  49 * midi2ly: (lilypond-program)Invoking midi2ly.    Importing MIDI.
  50 * musicxml2ly: (lilypond-program)Invoking musicxml2ly.  Importing MusicXML.
  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 Notation Reference of the LilyPond music engraving system
  57 @omftype user manual
  58 @omfcategory Applications|Publishing
  59 @omflanguage English
  60 @end ignore
  61
  62 @ifnottex
  63 @node Top
  64 @top GNU LilyPond --- Notation Reference
  65 @chapheading The music typesetter
  66 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
  67 @end ifnottex
  68
  69
  70 @ifhtml
  71 @ifclear bigpage
  72 This document is also available as a
  73 @uref{source/Documentation/user/lilypond.pdf,PDF} and as
  74 @uref{source/Documentation/user/lilypond-big-page.html,one big page}.
  75 @end ifclear
  76 @ifset bigpage
  77 This document is also available as a
  78 @uref{source/Documentation/user/lilypond.pdf,PDF} and as a
  79 @uref{source/Documentation/user/lilypond/index.html,HTML indexed multiple pages}.
  80 @end ifset
  81 @end ifhtml
  82
  83
  84 @c  This produces the unified index
  85 @syncodeindex fn cp
  86 @syncodeindex vr cp
  87
  88
  89 @finalout
  90
  91 @titlepage
  92 @title LilyPond
  93 @subtitle The music typesetter
  94 @titlefont{Notation Reference}
  95 @author The LilyPond development team
  96
  97 Copyright @copyright{} 1999--2009 by the authors
  98
  99 @quotation
 100 Permission is granted to copy, distribute and/or modify this document
 101 under the terms of the GNU Free Documentation License, Version 1.1
 102 or any later version published by the Free Software Foundation;
 103 with no Invariant Sections.
 104 A copy of the license is included in the section entitled ``GNU
 105 Free Documentation License''.
 106 @end quotation
 107
 108 @vskip 20pt
 109
 110 For LilyPond version @version{}
 111 @end titlepage
 112
 113 @copying
 114 Copyright @copyright{} 1999--2009 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--2009 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 This is the Notation Reference (NR) for GNU LilyPond version @version{}.
 143 For more information about how this fits with the other
 144 documentation, see @rlearning{About the documentation}.
 145
 146 @cindex web site
 147 @cindex URL
 148
 149 More information can be found at
 150 @uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
 151 of this and other documentation.
 152
 153 @include dedication.itely
 154
 155 @menu
 156 * Musical notation::               Musical notation.
 157 * Specialist notation::            Notation which is only used for
 158     specific purposes.
 159 * General input and output::       General information about
 160     LilyPond input and output.
 161 * Spacing issues::                 Display of output on paper.
 162 * Changing defaults::              Tuning output.
 163 * Interfaces for programmers::     Expert usage.
 164
 165 Appendices
 166
 167 * Literature list::                Reference works about music notation.
 168 * Notation manual tables::         Tables and charts.
 169 * Cheat sheet::                    Summary of LilyPond syntax.
 170 * LilyPond grammar::               Syntax diagram for LilyPond parser.
 171 * GNU Free Documentation License:: License of this document.
 172 * LilyPond command index::
 173 * LilyPond index::
 174 @end menu
 175 @end ifnottex
 176
 177 @contents
 178
 179
 180 @include notation.itely
 181 @include specialist.itely
 182
 183 @include input.itely
 184 @include spacing.itely
 185
 186 @include changing-defaults.itely
 187 @include programming-interface.itely
 188
 189
 190 @include literature.itely
 191 @include notation-appendices.itely
 192 @include cheatsheet.itely
 193
 194 @node LilyPond grammar
 195 @appendix LilyPond grammar
 196
 197 This appendix contains a description of the LilyPond grammar, as
 198 output from the parser.
 199
 200 @verbatiminclude ly-grammar.txt
 201
 202 @include fdl.itexi
 203
 204 @node LilyPond command index
 205 @appendix LilyPond command index
 206
 207 This index lists all the LilyPond commands and keywords with links
 208 to those sections of the manual which describe or discuss their
 209 use.  Each link is in two parts.  The first part points to the
 210 exact location in the manual where the command or keyword appears;
 211 the second part points to the start of the section of the manual
 212 in which the command or keyword appears.
 213
 214 @printindex ky
 215
 216 @node LilyPond index
 217 @appendix LilyPond index
 218
 219 In addition to all the LilyPond commands and keywords, this index
 220 lists musical terms and words which relate to each of them, with
 221 links to those sections of the manual which describe or discuss
 222 that topic.  Each link is in two parts.  The first part points to
 223 the exact location in the manual where the topic appears; the
 224 second part points to the start of the section of the manual where
 225 that topic is discussed.
 226
 227 @printindex cp
 228
 229 @bye