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