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