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 @macro copyrightDeclare
  23 Copyright @copyright{}
  24 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
  25 by the authors.
  26 @end macro
  27
  28
  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 * abc2ly: (lilypond-application)Invoking abc2ly.      Importing ABC.
  60 * convert-ly: (lilypond-application)Updating files with convert-ly. Older LilyPond versions.
  61 * etf2ly: (lilypond-application)Invoking etf2ly.      Importing Finale.
  62 * lilypond-book: (lilypond-application)LilyPond-book. Integrating text and music.
  63 * midi2ly: (lilypond-application)Invoking midi2ly.    Importing MIDI.
  64 * musicxml2ly: (lilypond-application)Invoking musicxml2ly.  Importing MusicXML.
  65 @end direntry
  66
  67 @c don't remove this comment.
  68 @ignore
  69 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
  70 @omfdescription Notation Reference of the LilyPond music engraving system
  71 @omftype user manual
  72 @omfcategory Applications|Publishing
  73 @omflanguage English
  74 @end ignore
  75
  76
  77 @lilyTitlePage{Notation Reference}
  78
  79
  80 @ifnottex
  81
  82 @menu
  83 * Musical notation::               Notation which is used in
  84     almost all projects.
  85 * Specialist notation::            Notation which is only used for
  86     specific purposes.
  87 * General input and output::       General information about
  88     LilyPond input and output.
  89 * Spacing issues::                 Display of output on paper.
  90 * Changing defaults::              Tuning output.
  91 * Interfaces for programmers::     How to interface with scheme.
  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 @include notation/programming-interface.itely
 117
 118
 119 @include notation/notation-appendices.itely
 120 @include notation/cheatsheet.itely
 121
 122
 123
 124 @node LilyPond grammar
 125 @appendix LilyPond grammar
 126
 127 This appendix contains a description of the LilyPond grammar, as
 128 output from the parser.
 129
 130 @verbatiminclude ly-grammar.txt
 131
 132
 133 @include fdl.itexi
 134
 135
 136 @node LilyPond command index
 137 @appendix LilyPond command index
 138
 139 This index lists all the LilyPond commands and keywords with links
 140 to those sections of the manual which describe or discuss their
 141 use.  Each link is in two parts.  The first part points to the
 142 exact location in the manual where the command or keyword appears;
 143 the second part points to the start of the section of the manual
 144 in which the command or keyword appears.
 145
 146 @printindex ky
 147
 148 @node LilyPond index
 149 @appendix LilyPond index
 150
 151 In addition to all the LilyPond commands and keywords, this index
 152 lists musical terms and words which relate to each of them, with
 153 links to those sections of the manual which describe or discuss
 154 that topic.  Each link is in two parts.  The first part points to
 155 the exact location in the manual where the topic appears; the
 156 second part points to the start of the section of the manual where
 157 that topic is discussed.
 158
 159 @printindex cp
 160
 161 @bye