Documentation/user/lilypond.tely

   1 \input texinfo @c -*-texinfo-*-
   2 @setfilename lilypond.info
   3 @settitle GNU LilyPond
   4 @iftex
   5 @afourpaper
   6 @end iftex
   7
   8 @ignore
   9 Distributions will want to install lilypond.info in postinstall, doing:
  10
  11     install-info --info-dir=/usr/share/info out/lilypond.info
  12
  13 @end ignore
  14
  15 @dircategory GNU music project
  16 @direntry
  17 @c    ;; prepend GNU for dir, must be unique
  18 * GNU LilyPond: (lilypond/lilypond).           The GNU music typesetter.
  19 * lilypond: (lilypond/lilypond)Invoking LilyPond.      Titling LilyPond scores.
  20 * Glossary: (lilypond/music-glossary).                  Glossary of music terms.
  21 * convert-ly: (lilypond/lilypond)Invoking convert-ly.  Older LilyPond versions.
  22 * midi2ly: (lilypond/lilypond)Invoking midi2ly.        Importing MIDI.
  23 * etf2ly: (lilypond/lilypond)Invoking etf2ly.          Importing Finale.
  24 * abc2ly: (lilypond/lilypond)Invoking abc2ly.          Importing ABC.
  25 * musedata2ly: (lilypond/lilypond)Invoking musedata2ly.        Importing MuseData.
  26 * mup2ly: (lilypond/lilypond)Invoking mup2ly.          Importing Mup.
  27 @end direntry
  28
  29
  30 @ignore
  31 @omfcreator Han-Wen Nienhuys and Jan Nieuwenhuizen
  32 @omfdescription User manual  of the LilyPond music engraving system
  33 @omftype user manual
  34 @omfcategory Applications|Publishing
  35 @omflanguage English
  36 @end ignore
  37
  38 @c don't remove this comment.
  39
  40 @ignore
  41
  42 HINTS FOR STYLE
  43
  44 * Try not to use punctuation between introductocing sentence and
  45 display material (verbatim, music, example code).
  46
  47 * don't refer to LilyPond in the text. The reader knows what the
  48 manual is about
  49
  50 * if you do, capitalization is LilyPond.
  51
  52 * don't explicitly refer to the reader/user.  There is no one else
  53 besides the reader and the writer.
  54
  55 * don't use abbreviations (don't, won't, etc.)
  56
  57 * avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
  58
  59 * avoid long stretches of input code. Noone is go to read  them in
  60 print. Instead refer to an example input file (@inputfileref), these
  61 are clickable in HTML.
  62
  63 * abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
  64
  65 @end ignore
  66
  67 @ifhtml
  68 This document is also available in @uref{../lilypond.ps.gz,gzipped
  69 PostScript} and @uref{../lilypond.pdf,PDF}.
  70 @end ifhtml
  71
  72
  73 @titlepage
  74 @title GNU LilyPond
  75 @subtitle The music typesetter
  76 @author Han-Wen Nienhuys
  77 @author Jan Nieuwenhuizen
  78 @author J@"{u}rgen Reuter
  79 @author Rune Zedeler
  80
  81
  82
  83 Copyright @copyright{} 1999--2004 by the authors
  84
  85   Permission is granted to copy, distribute and/or modify this document
  86   under the terms of the GNU Free Documentation License, Version 1.1
  87   or any later version published by the Free Software Foundation;
  88   with no Invariant Sections.
  89   A copy of the license is included in the section entitled ``GNU
  90   Free Documentation License''.
  91
  92 @vskip 20pt
  93
  94
  95 @lilypond[raggedright]
  96 \score {
  97     \context Lyrics \notes {
  98         \override Score.RehearsalMark   #'self-alignment-X = #LEFT
  99         \mark #(ly:export (string-append
 100              "(For LilyPond version " (lilypond-version) ")"))
 101         s2
 102      }
 103      \paper {
 104          indent = 0.0\pt
 105          raggedright = ##t
 106      }
 107 }
 108 @end lilypond
 109
 110
 111 @end titlepage
 112
 113
 114 @ifnottex
 115 This file documents GNU LilyPond.
 116
 117 Copyright 1999--2004 by the authors
 118
 119   Permission is granted to copy, distribute and/or modify this document
 120   under the terms of the GNU Free Documentation License, Version 1.1
 121   or any later version published by the Free Software Foundation;
 122   with no Invariant Sections.
 123   A copy of the license is included in the section entitled ``GNU
 124   Free Documentation License''.
 125
 126 @end ifnottex
 127
 128
 129 @ifnottex
 130 @node Top
 131 @top GNU LilyPond --- The music typesetter
 132 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
 133
 134 This is the user manual for GNU LilyPond 2.1.x series.
 135 @ifhtml
 136 (See the bottom of this page for the exact version number).
 137 @end ifhtml
 138
 139 @cindex web site
 140
 141 A further source of information is the website, which can be found at
 142 @uref{http://www.lilypond.org/}.  The website contains on-line copies of
 143 this and other documentation.
 144
 145 @include dedication.itely
 146
 147 @menu
 148 * Preface::                        Preface.
 149 * Introduction::                   What, Why, How.
 150 * Tutorial::                       A tutorial introduction.
 151 * Notation manual::                All notation supported, and how to
 152                                    produce it.
 153 * Changing defaults::              Tuning output
 154 * Invoking LilyPond::              Operation.
 155 * Converting from other formats::  Converting to lilypond source format.
 156 * lilypond-book manual::           Integrating text and music with lilypond-book.
 157 * Unified index::
 158 * Notation manual details::
 159 * Literature list::
 160 * Interfaces for programmers::
 161 * Cheat sheet::
 162 * GNU Free Documentation License:: FDL.
 163 @end menu
 164 @end ifnottex
 165
 166 @contents
 167
 168
 169 @include macros.itexi
 170 @include preface.itely
 171 @include introduction.itely
 172 @include tutorial.itely
 173 @include notation.itely
 174 @include changing-defaults.itely
 175 @include invoking.itexi
 176 @include lilypond-book.itely
 177 @include converters.itely
 178
 179
 180 @c FIXME: Index has two alphabetically sorted lists @code vs plain?
 181 @node Unified index
 182 @unnumbered Unified index
 183
 184 @printindex cp
 185
 186 @include notation-appendices.itely
 187
 188 @include literature.itely
 189
 190 @include programming-interface.itely
 191
 192 @include cheatsheet.itely
 193
 194 @include fdl.itexi
 195
 196 @bye