Documentation/notation.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-notation.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-application)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-notation).                           LilyPond Notation Reference.
  43 * LilyPond Snippets: (lilypond-snippets).         Short tricks, tips, and examples.
  44 * LilyPond Internals Reference: (lilypond-internals).  Definitions for tweaking.
  45 * LilyPond Application Usage: (lilypond-application). Installing and running applications.
  46 * abc2ly: (lilypond-application)Invoking abc2ly.      Importing ABC.
  47 * convert-ly: (lilypond-application)Updating files with convert-ly. Older LilyPond versions.
  48 * etf2ly: (lilypond-application)Invoking etf2ly.      Importing Finale.
  49 * lilypond-book: (lilypond-application)LilyPond-book. Integrating text and music.
  50 * midi2ly: (lilypond-application)Invoking midi2ly.    Importing MIDI.
  51 * musicxml2ly: (lilypond-application)Invoking musicxml2ly.  Importing MusicXML.
  52 @end direntry
  53
  54 @c don't remove this comment.
  55 @ignore
  56 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
  57 @omfdescription Notation Reference of the LilyPond music engraving system
  58 @omftype user manual
  59 @omfcategory Applications|Publishing
  60 @omflanguage English
  61 @end ignore
  62
  63 @ifnottex
  64 @node Top
  65 @top GNU LilyPond --- Notation Reference
  66 @chapheading The music typesetter
  67 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
  68 @end ifnottex
  69
  70
  71 @ifhtml
  72 @ifclear bigpage
  73 This document is also available as a
  74 @uref{source/Documentation/notation.pdf,PDF} and as
  75 @uref{source/Documentation/notation-big-page.html,one big page}.
  76 @end ifclear
  77 @ifset bigpage
  78 This document is also available as a
  79 @uref{source/Documentation/notation.pdf,PDF} and as a
  80 @uref{source/Documentation/notation/index.html,HTML indexed multiple pages}.
  81 @end ifset
  82 @end ifhtml
  83
  84
  85 @c  This produces the unified index
  86 @syncodeindex fn cp
  87 @syncodeindex vr cp
  88
  89
  90 @finalout
  91
  92 @titlepage
  93 @title LilyPond
  94 @subtitle The music typesetter
  95 @titlefont{Notation Reference}
  96 @author The LilyPond development team
  97
  98 Copyright @copyright{} 1999--2009 by the authors
  99
 100 @quotation
 101 Permission is granted to copy, distribute and/or modify this document
 102 under the terms of the GNU Free Documentation License, Version 1.1
 103 or any later version published by the Free Software Foundation;
 104 with no Invariant Sections.
 105 A copy of the license is included in the section entitled ``GNU
 106 Free Documentation License''.
 107 @end quotation
 108
 109 @vskip 20pt
 110
 111 For LilyPond version @version{}
 112 @end titlepage
 113
 114 @copying
 115 Copyright @copyright{} 1999--2009 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 copying
 126
 127 @ifnottex
 128 This file documents GNU LilyPond.
 129
 130 Copyright 1999--2009 by the authors
 131
 132 @quotation
 133 Permission is granted to copy, distribute and/or modify this document
 134 under the terms of the GNU Free Documentation License, Version 1.1
 135 or any later version published by the Free Software Foundation;
 136 with no Invariant Sections.
 137 A copy of the license is included in the section entitled ``GNU
 138 Free Documentation License''.
 139 @end quotation
 140 @end ifnottex
 141
 142 @ifnottex
 143 This is the Notation Reference (NR) for GNU LilyPond version @version{}.
 144 For more information about how this fits with the other
 145 documentation, see @rlearning{About the documentation}.
 146
 147 @cindex web site
 148 @cindex URL
 149
 150 More information can be found at
 151 @uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
 152 of this and other documentation.
 153
 154 @include dedication.itely
 155
 156 @menu
 157 * Musical notation::               Musical notation.
 158 * Specialist notation::            Notation which is only used for
 159     specific purposes.
 160 * General input and output::       General information about
 161     LilyPond input and output.
 162 * Spacing issues::                 Display of output on paper.
 163 * Changing defaults::              Tuning output.
 164 * Interfaces for programmers::     Expert usage.
 165
 166 Appendices
 167
 168 * Literature list::                Reference works about music notation.
 169 * Notation manual tables::         Tables and charts.
 170 * Cheat sheet::                    Summary of LilyPond syntax.
 171 * LilyPond grammar::               Syntax diagram for LilyPond parser.
 172 * GNU Free Documentation License:: License of this document.
 173 * LilyPond command index::
 174 * LilyPond index::
 175 @end menu
 176 @end ifnottex
 177
 178 @contents
 179
 180
 181 @include notation/notation.itely
 182 @include notation/specialist.itely
 183
 184 @include notation/input.itely
 185 @include notation/spacing.itely
 186
 187 @include notation/changing-defaults.itely
 188 @include notation/programming-interface.itely
 189
 190
 191 @include notation/literature.itely
 192 @include notation/notation-appendices.itely
 193 @include notation/cheatsheet.itely
 194
 195 @node LilyPond grammar
 196 @appendix LilyPond grammar
 197
 198 This appendix contains a description of the LilyPond grammar, as
 199 output from the parser.
 200
 201 @verbatiminclude ly-grammar.txt
 202
 203 @include fdl.itexi
 204
 205 @node LilyPond command index
 206 @appendix LilyPond command index
 207
 208 This index lists all the LilyPond commands and keywords with links
 209 to those sections of the manual which describe or discuss their
 210 use.  Each link is in two parts.  The first part points to the
 211 exact location in the manual where the command or keyword appears;
 212 the second part points to the start of the section of the manual
 213 in which the command or keyword appears.
 214
 215 @printindex ky
 216
 217 @node LilyPond index
 218 @appendix LilyPond index
 219
 220 In addition to all the LilyPond commands and keywords, this index
 221 lists musical terms and words which relate to each of them, with
 222 links to those sections of the manual which describe or discuss
 223 that topic.  Each link is in two parts.  The first part points to
 224 the exact location in the manual where the topic appears; the
 225 second part points to the start of the section of the manual where
 226 that topic is discussed.
 227
 228 @printindex cp
 229
 230 @bye