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
   9 @setfilename lilypond-notation.info
  10 @settitle LilyPond Notation Reference
  11 @documentencoding UTF-8
  12 @documentlanguage en
  13 @afourpaper
  14
  15 @macro manualIntro
  16 This manual provides a reference for all notation that can be
  17 produced with LilyPond version @version{}.  It assumes that
  18 the reader is familiar with the material in the
  19 @rlearningnamed{Top, Learning Manual}.
  20 @end macro
  21
  22 @c `Notation Reference' was born 1999-10-11 with git commit 940dda0...
  23 @macro copyrightDeclare
  24 Copyright @copyright{} 1999--2009 by the authors.
  25 @end macro
  26
  27
  28 @set FDL
  29 @include macros.itexi
  30
  31 @c  TODO: all the direntry stuff should be moved to general.texi
  32 @c  Keep this here, since it pertains to the direntry below.
  33 @ignore
  34 Distributions will want to install lilypond.info in postinstall, doing:
  35
  36     install-info --info-dir=/usr/share/info out[-www]/lilypond.info
  37
  38   * Prepend GNU for dir, must be unique.
  39
  40   * Do not list the `lilypond' node at toplevel, so that `info lilypond'
  41     goes to Top.
  42
  43   * List all commands in direntry.
  44
  45 @c  * lilypond: (lilypond-application)Running LilyPond.      Invoking the
  46 @c    LilyPond  program.
  47 @end ignore
  48
  49 @c Info files are no longer installed in a subdirectory, images are
  50 @c expected to be found in lilypond/ subdirectory.
  51 @dircategory GNU LilyPond --- the music typesetter
  52 @direntry
  53 * LilyPond Learning Manual: (lilypond-learning).  Start here.
  54 * Music Glossary: (music-glossary).               For non-English users.
  55 * LilyPond: (lilypond-notation).                           LilyPond Notation Reference.
  56 * LilyPond Snippets: (lilypond-snippets).         Short tricks, tips, and examples.
  57 * LilyPond Internals Reference: (lilypond-internals).  Definitions for tweaking.
  58 * LilyPond Application Usage: (lilypond-application). Installing and running applications.
  59 * LilyPond Website: (lilypond-general).    Preview of new website.
  60 * abc2ly: (lilypond-application)Invoking abc2ly.      Importing ABC.
  61 * convert-ly: (lilypond-application)Updating files with convert-ly. Older LilyPond versions.
  62 * etf2ly: (lilypond-application)Invoking etf2ly.      Importing Finale.
  63 * lilypond-book: (lilypond-application)LilyPond-book. Integrating text and music.
  64 * midi2ly: (lilypond-application)Invoking midi2ly.    Importing MIDI.
  65 * musicxml2ly: (lilypond-application)Invoking musicxml2ly.  Importing MusicXML.
  66 @end direntry
  67
  68 @c don't remove this comment.
  69 @ignore
  70 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
  71 @omfdescription Notation Reference of the LilyPond music engraving system
  72 @omftype user manual
  73 @omfcategory Applications|Publishing
  74 @omflanguage English
  75 @end ignore
  76
  77
  78 @lilyTitlePage{Notation Reference}
  79
  80
  81 @ifnottex
  82
  83 @menu
  84 * Musical notation::               Notation which is used in
  85     almost all projects.
  86 * Specialist notation::            Notation which is only used for
  87     specific purposes.
  88 * General input and output::       General information about
  89     LilyPond input and output.
  90 * Spacing issues::                 Display of output on paper.
  91 * Changing defaults::              Tuning output.
  92
  93 Appendices
  94
  95 * Notation manual tables::         Tables and charts.
  96 * Cheat sheet::                    Summary of LilyPond syntax.
  97 * LilyPond grammar::               Syntax diagram for LilyPond parser.
  98 * GNU Free Documentation License:: License of this document.
  99 * LilyPond command index::
 100 * LilyPond index::
 101 @end menu
 102
 103 @docMain
 104 @end ifnottex
 105
 106 @contents
 107
 108
 109 @include notation/notation.itely
 110 @include notation/specialist.itely
 111
 112 @include notation/input.itely
 113 @include notation/spacing.itely
 114
 115 @include notation/changing-defaults.itely
 116
 117
 118 @include notation/notation-appendices.itely
 119 @include notation/cheatsheet.itely
 120
 121
 122
 123 @node LilyPond grammar
 124 @appendix LilyPond grammar
 125
 126 This appendix contains a description of the LilyPond grammar, as
 127 output from the parser.
 128
 129 @verbatiminclude ly-grammar.txt
 130
 131
 132 @include fdl.itexi
 133
 134
 135 @node LilyPond command index
 136 @appendix LilyPond command index
 137
 138 This index lists all the LilyPond commands and keywords with links
 139 to those sections of the manual which describe or discuss their
 140 use.  Each link is in two parts.  The first part points to the
 141 exact location in the manual where the command or keyword appears;
 142 the second part points to the start of the section of the manual
 143 in which the command or keyword appears.
 144
 145 @printindex ky
 146
 147 @node LilyPond index
 148 @appendix LilyPond index
 149
 150 In addition to all the LilyPond commands and keywords, this index
 151 lists musical terms and words which relate to each of them, with
 152 links to those sections of the manual which describe or discuss
 153 that topic.  Each link is in two parts.  The first part points to
 154 the exact location in the manual where the topic appears; the
 155 second part points to the start of the section of the manual where
 156 that topic is discussed.
 157
 158 @printindex cp
 159
 160 @bye