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  do not list the `lilypond' node at toplevel, so that `info lilypond'
  19 @c  goes to Top.
  20 @c  * lilypond: (lilypond/lilypond)Invoking LilyPond.      Titling LilyPond scores.
  21 * GNU LilyPond: (lilypond/lilypond).           The GNU music typesetter.
  22 * convert-ly: (lilypond/lilypond)Invoking convert-ly.  Older LilyPond versions.
  23 * midi2ly: (lilypond/lilypond)Invoking midi2ly.        Importing MIDI.
  24 * etf2ly: (lilypond/lilypond)Invoking etf2ly.          Importing Finale.
  25 * abc2ly: (lilypond/lilypond)Invoking abc2ly.          Importing ABC.
  26 * musedata2ly: (lilypond/lilypond)Invoking musedata2ly.        Importing MuseData.
  27 * mup2ly: (lilypond/lilypond)Invoking mup2ly.          Importing Mup.
  28 @end direntry
  29
  30
  31 @ignore
  32 @omfcreator Han-Wen Nienhuys and Jan Nieuwenhuizen
  33 @omfdescription User manual  of the LilyPond music engraving system
  34 @omftype user manual
  35 @omfcategory Applications|Publishing
  36 @omflanguage English
  37 @end ignore
  38
  39 @c don't remove this comment.
  40
  41 @ignore
  42
  43 HINTS FOR STYLE
  44
  45 * Do not forget to create @cindex entries for new sections of text.
  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 * Colon usage
  69   0. Do not use a colon to introduce examples, sentences just continue
  70
  71       in the display material.
  72
  73   1. To introduce lists
  74   2. When beginning a quote: "So, he said,..."
  75      This usage is rarer.  Americans often just use a comma.
  76   3. When adding a defining example at the end of a sentence.
  77
  78 @end ignore
  79
  80 @ifhtml
  81 This document is also available in @uref{../lilypond.ps.gz,gzipped
  82 PostScript} and @uref{../lilypond.pdf,PDF}.
  83 @end ifhtml
  84
  85
  86 @titlepage
  87 @title GNU LilyPond
  88 @subtitle The music typesetter
  89 @author Han-Wen Nienhuys
  90 @author Jan Nieuwenhuizen
  91 @author J@"{u}rgen Reuter
  92 @author Rune Zedeler
  93
  94
  95
  96 Copyright @copyright{} 1999--2004 by the authors
  97
  98   Permission is granted to copy, distribute and/or modify this document
  99   under the terms of the GNU Free Documentation License, Version 1.1
 100   or any later version published by the Free Software Foundation;
 101   with no Invariant Sections.
 102   A copy of the license is included in the section entitled ``GNU
 103   Free Documentation License''.
 104
 105 @vskip 20pt
 106
 107 %% Not yet debugged or reported.  This crashes gs-8.01:
 108 %% compiling gs-8.01 right now... -- jcn
 109 @lilypond[raggedright]
 110 \score {
 111     \context Lyrics \notes {
 112         \override Score.RehearsalMark   #'self-alignment-X = #LEFT
 113         \mark #(ly:export (string-append
 114              "(For LilyPond version " (lilypond-version) ")"))
 115         s2
 116      }
 117      \paper {
 118          indent = 0.0\pt
 119          raggedright = ##t
 120      }
 121 }
 122 @end lilypond
 123
 124 @end titlepage
 125
 126
 127 @ifnottex
 128 This file documents GNU LilyPond.
 129
 130 Copyright 1999--2004 by the authors
 131
 132   Permission is granted to copy, distribute and/or modify this document
 133   under the terms of the GNU Free Documentation License, Version 1.1
 134   or any later version published by the Free Software Foundation;
 135   with no Invariant Sections.
 136   A copy of the license is included in the section entitled ``GNU
 137   Free Documentation License''.
 138
 139 @end ifnottex
 140
 141
 142 @ifnottex
 143 @node Top
 144 @top GNU LilyPond --- The music typesetter
 145 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
 146
 147 This is the user manual for GNU LilyPond 2.3.x series.
 148 @ifhtml
 149 (See the bottom of this page for the exact version number).
 150 @end ifhtml
 151
 152 @cindex web site
 153
 154 A further source of information is the website, which can be found at
 155 @uref{http://www.lilypond.org/}.  The website contains on-line copies of
 156 this and other documentation.
 157
 158 @include dedication.itely
 159
 160 @menu
 161 * Preface::                        Preface.
 162 * Introduction::                   What, Why, How.
 163 * Tutorial::                       A tutorial introduction.
 164 * Notation manual::                All notation supported, and how to
 165                                    produce it.
 166 * Changing defaults::              Tuning output.
 167 * Invoking LilyPond::              Operation.
 168 * Converting from other formats::  Converting to lilypond source format.
 169 * lilypond-book manual::           Integrating text and music with lilypond-book.
 170 * Unified index::
 171 * Notation manual details::
 172 * Literature list::
 173 * Interfaces for programmers::
 174 * Cheat sheet::
 175 * GNU Free Documentation License:: FDL.
 176 @end menu
 177 @end ifnottex
 178
 179 @contents
 180
 181
 182 @include macros.itexi
 183 @include preface.itely
 184 @include introduction.itely
 185 @include tutorial.itely
 186 @include notation.itely
 187 @include changing-defaults.itely
 188 @include invoking.itexi
 189 @include lilypond-book.itely
 190 @include converters.itely
 191
 192
 193 @c FIXME: Index has two alphabetically sorted lists @code vs plain?
 194 @node Unified index
 195 @unnumbered Unified index
 196
 197 @printindex cp
 198
 199 @include notation-appendices.itely
 200
 201 @include literature.itely
 202
 203 @include programming-interface.itely
 204
 205 @include cheatsheet.itely
 206
 207 @include fdl.itexi
 208
 209 @bye