Documentation/topdocs/index.tely

   1 \input texinfo @c -*-texinfo-*-
   2 @setfilename index.info
   3 @settitle LilyPond homepage
   4
   5 @node Top, , , (dir)
   6 @top
   7
   8 @html
   9 <p align=center>
  10 [
  11     <a href="#download">Download</a>
  12     |
  13     <a href="Documentation/out-www/faq.html">FAQ</a>
  14     |
  15     <a href="Documentation/out-www/index.html">Documentation</a>
  16     |
  17     <a href="#music">Music archives</a>
  18     |
  19     <a href="#mailing-lists">Mailing lists</a>
  20     |
  21     <a href="Documentation/out-www/CHANGES.txt">News</a>
  22 ]
  23 @end html
  24
  25 @html
  26 <p align=center>
  27 <img src="Documentation/pictures/out-www/lelie-logo.png" alt="[logo]">
  28 @end html
  29 @unnumberedsec LilyPond -- The GNU Project Music Typesetter
  30
  31 @c something breaks on 3.12 f
  32
  33 @unnumberedsec What is LilyPond?
  34
  35 LilyPond is a music typesetter.  It produces beautiful sheet music using
  36 a high level description file as input. It excels at typesetting
  37 classical music, but you can also print pop-songs.  With LilyPond we
  38 hope to make music publication software available to anyone on the
  39 internet.
  40
  41 @unnumberedsec Why should I use it?
  42
  43 The input to LilyPond is plain text. So, you can use your favorite text
  44 editor to enter it, you can put it in mail or embed it in an article like
  45 this:
  46
  47 @quotation
  48 @mudela[fragment,verbatim]
  49         \relative c'' { \key es; r8 [c16 b] [c8 g] [as c16 b] [c8 d] | g,4 }
  50 @end mudela
  51 @end quotation
  52
  53 The output looks very good: the font and the layout algorithms were
  54 inspired by engraved music, so you can expect that same clear and
  55 elegant look from your LilyPond output.  And if you don't like the
  56 looks, you can tweak almost everything.
  57
  58 The program also has limited MIDI functionality: you can write MIDI
  59 files with lilypond, and we have a simple MIDI to lilypond conversion
  60 tool, @file{midi2ly}.
  61
  62 LilyPond is free software. It is licensed under GNU General Public
  63 License, so you can use, modify and redistribute the program with
  64 almost no restrictions.  LilyPond is part of the
  65 @uref{http://www.gnu.org/,GNU Project}.
  66
  67 The version numbers are in Linux-kernel style: even numbered versions
  68 are `stable'. The webpages for the stable version (1.2) reside at GNU,
  69 here: @uref{http://www.gnu.org/software/lilypond}. Big enhancements go
  70 into the latest odd numbered version (1.3); its  webpages are on
  71  @uref{http://www.cs.uu.nl/~hanwen/lilypond/,Han-Wen's site}.
  72
  73 If want more information, you can browse the
  74 @uref{Documentation/user/out-www/lilypond.html, manual} or other
  75 @uref{Documentation/out-www/index.html, documentation}.
  76
  77
  78 @unnumberedsec News
  79
  80 For the latest and greatest features, check out the
  81 @uref{Documentation/out-www/CHANGES.txt, Change Log}.
  82
  83
  84 @html
  85 <a name="music">
  86 @end html
  87 @unnumberedsec Sheet music
  88
  89
  90 If you are interested in sheet music typeset by LilyPond, have a look at
  91 the examples included. We have @uref{short-examples.html,short
  92 examples} and @uref{long-examples.html,longer examples}. The
  93 examples include sound bites  in MIDI, pictures in PNG, printable scores
  94 in PostScript, and LilyPond input.
  95
  96 Others use LilyPond too.
  97 @uref{http://www.geocities.com/Vienna/Studio/1714/harpsichord.html,John
  98 Sankey}, harpsichordist to the internet, is typesetting the complete
  99 @uref{http://www.geocities.com/Vienna/Studio/1714/scarlattidwn.html,sonatas
 100 by Scarlatti}. Jeff Covey, guitar player and overall nice guy, is
 101 putting @uref{http://www4.smart.net/~jcovey/scores/,guitar music} on the
 102 net. The @uref{http://sca.uwaterloo.ca/Mutopia/,Mutopia project} is a
 103 large archive of public domain sheet music under construction.
 104
 105 @html
 106 <a name="download">
 107 @end html
 108 @unnumberedsec Download
 109
 110 If you want to compile LilyPond from source, download here:
 111 @itemize @bullet
 112 @item Download stable releases at
 113 @uref{ftp://ftp.gnu.org/gnu/lilypond/}
 114 @item Download development releases at
 115 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/}
 116 @item Canadian mirror   @uref{http://sca.uwaterloo.ca/lilypond/} and @uref{ftp://sca.uwaterloo.ca/pub/}
 117 @item Another site in Europe
 118 @uref{ftp://ftp.lilypond.org/pub/LilyPond/}
 119 @end itemize
 120
 121 Installing and compiling requires many additional packages, which are
 122 listed in the @uref{Documentation/topdocs/out-www/INSTALL.html,
 123 installation instructions}.
 124
 125 There are binaries available, but alas they are not updated for every version released.
 126 @itemize @bullet
 127 @item RedHat-i386 and Linuxppc RPMs:
 128 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/}
 129 @item Debian binary @uref{ftp://ftp.debian.org/pub/debian/dists/unstable/main/binary-i386/tex}
 130 @item Windows NT: @uref{http://home.austin.rr.com/jbr/jeff/lilypond/}
 131 @end itemize
 132
 133
 134 @html
 135 <a name="mailing-lists">
 136 @end html
 137 @unnumberedsec Mailing list
 138
 139 If you have questions, do write to the mailing lists!
 140  (But don't forget to read the @uref{Documentation/out-www/faq.html,
 141 Frequently Asked Questions} first.)
 142
 143
 144 @table @samp
 145 @item info-gnu-music@@gnu.org
 146         is a moderated list for information on the GNU Music project, to
 147     subscribe: send mail with subject "subscribe" to
 148     info-gnu-music-request@@gnu.org.
 149
 150     As this list is moderated, normal people should ask to
 151     @email{drl@@gnu.org, David R. Linn} or
 152     @email{hanwen@@cs.uu.nl, Han-Wen} to forward announces instead of
 153     sending it to info-gnu-music@@gnu.org
 154
 155    This list is archived at
 156     @uref{http://www.mail-archive.com/info-gnu-music@@gnu.org}
 157
 158 @item help-gnu-music@@gnu.org
 159     For help with LilyPond music project. To subscribe: send
 160     mail with subject "subscribe" to
 161     @email{help-gnu-music-request@@gnu.org} The archive is at
 162   @uref{http://www.mail-archive.com/help-gnu-music@@gnu.org}.
 163
 164 @item bug-gnu-music@@gnu.org
 165     If you have bugreports, you should send them to this list.  If you
 166 want to know about bugs, subscribe: send mail with subject "subscribe"
 167 to @email{bug-gnu-music-request@@gnu.org}. The archive is at
 168 @uref{http://www.mail-archive.com/bug-gnu-music@@gnu.org}
 169
 170         Please include in your bugreport the version of LilyPond that
 171 you experience the problem with, a description of your system and sample
 172 input to reproduce the problem. Do not send output files over the list,
 173 they tend to be very big and don't help with describing the problem.
 174
 175
 176 @item gnu-music-discuss@@gnu.org,
 177     For discussions concerning LilyPond, to subscribe: send
 178     mail with subject "subscribe" to
 179     @email{gnu-music-discuss-request@@gnu.org}
 180         The archive is at
 181     @uref{http://www.mail-archive.com/gnu-music-discuss@@gnu.org}
 182 @end table
 183
 184 If you want to unsubscribe use the same procedure as subscribing, but
 185 substitute @code{unsubscribe} where you would put @code{subscribe}.
 186
 187 @unnumberedsubsec Webmaster's Disclaimer
 188
 189 These pages were entirely created from a @strong{development snapshots}
 190 of the LilyPond package.  The version of this webpage is printed at the
 191 bottom.
 192
 193 @html
 194 <p align=center>
 195 [
 196     <a href="#download">Download</a>
 197     |
 198     <a href="Documentation/out-www/faq.html">FAQ</a>
 199     |
 200     <a href="Documentation/out-www/index.html">Documentation</a>
 201     |
 202     <a href="#music">Music archives</a>
 203     |
 204     <a href="#mailing-lists">Mailing lists</a>
 205     |
 206     <a href="Documentation/out-www/CHANGES.txt">News</a>
 207 ]
 208 @end html
 209
 210 @bye