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
 146 FIXME FIXME FIXME
 147 @c @rlearning{About the documentation}.
 148
 149 @cindex web site
 150 @cindex URL
 151
 152 More information can be found at
 153 @uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
 154 of this and other documentation.
 155
 156
 157 @menu
 158 * Musical notation::               Notation which is used in
 159     almost all projects.
 160 * Specialist notation::            Notation which is only used for
 161     specific purposes.
 162 * General input and output::       General information about
 163     LilyPond input and output.
 164 * Spacing issues::                 Display of output on paper.
 165 * Changing defaults::              Tuning output.
 166 * Interfaces for programmers::     How to interface with scheme.
 167
 168 Appendices
 169
 170 * Notation manual tables::         Tables and charts.
 171 * Cheat sheet::                    Summary of LilyPond syntax.
 172 * LilyPond grammar::               Syntax diagram for LilyPond parser.
 173 * GNU Free Documentation License:: License of this document.
 174 * LilyPond command index::
 175 * LilyPond index::
 176 @end menu
 177 @end ifnottex
 178 @c * Literature list::                Reference works about music notation.
 179
 180 @contents
 181
 182
 183 @include notation/notation.itely
 184 @include notation/specialist.itely
 185
 186 @include notation/input.itely
 187 @include notation/spacing.itely
 188
 189 @include notation/changing-defaults.itely
 190 @include notation/programming-interface.itely
 191
 192
 193 @c @include notation/literature.itely
 194 @include notation/notation-appendices.itely
 195 @include notation/cheatsheet.itely
 196
 197 @node LilyPond grammar
 198 @appendix LilyPond grammar
 199
 200 This appendix contains a description of the LilyPond grammar, as
 201 output from the parser.
 202
 203 @verbatiminclude ly-grammar.txt
 204
 205 @include fdl.itexi
 206
 207 @node LilyPond command index
 208 @appendix LilyPond command index
 209
 210 This index lists all the LilyPond commands and keywords with links
 211 to those sections of the manual which describe or discuss their
 212 use.  Each link is in two parts.  The first part points to the
 213 exact location in the manual where the command or keyword appears;
 214 the second part points to the start of the section of the manual
 215 in which the command or keyword appears.
 216
 217 @printindex ky
 218
 219 @node LilyPond index
 220 @appendix LilyPond index
 221
 222 In addition to all the LilyPond commands and keywords, this index
 223 lists musical terms and words which relate to each of them, with
 224 links to those sections of the manual which describe or discuss
 225 that topic.  Each link is in two parts.  The first part points to
 226 the exact location in the manual where the topic appears; the
 227 second part points to the start of the section of the manual where
 228 that topic is discussed.
 229
 230 @printindex cp
 231
 232 @bye