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