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 c \minor; 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
  69 @uref{http://www.gnu.org/software/lilypond, on the GNU servers}. Big
  70 enhancements go into the latest odd numbered version (1.3), whose
  71 webpages are on @uref{http://www.cs.uu.nl/~hanwen/lilypond/,Han-Wen's
  72 site}.  Information on the latest and greatest features can be found in
  73 the @uref{Documentation/out-www/CHANGES.txt, Change Log}.
  74
  75 If want more information, you can browse the
  76 @uref{Documentation/user/out-www/lilypond.html, manual} or other
  77 @uref{Documentation/out-www/index.html, documentation}.
  78
  79
  80
  81 @html
  82 <a name="music">
  83 @end html
  84 @unnumberedsec Sheet music
  85
  86
  87 If you are interested in sheet music typeset by LilyPond, have a look at
  88 the examples included. We have @uref{short-examples.html,short
  89 examples} and @uref{long-examples.html,longer examples}. The
  90 examples include sound bites  in MIDI, pictures in PNG, printable scores
  91 in PostScript, and LilyPond input.
  92
  93 Others use LilyPond too.
  94 @uref{http://www.geocities.com/Vienna/Studio/1714/harpsichord.html,John
  95 Sankey}, harpsichordist to the internet, is typesetting the complete
  96 @uref{http://www.geocities.com/Vienna/Studio/1714/scarlattidwn.html,sonatas
  97 by Scarlatti}. Jeff Covey, guitar player and overall nice guy, is
  98 putting @uref{http://www4.smart.net/~jcovey/scores/,guitar music} on the
  99 net. The @uref{http://sca.uwaterloo.ca/Mutopia/,Mutopia project} is a
 100 large archive of public domain sheet music under construction. Dirk
 101 Lattermann also put some works
 102 @uref{http://www.alqualonde.de/lilypond.html,on the web}.
 103
 104 @html
 105 <a name="download">
 106 @end html
 107 @unnumberedsec Download
 108
 109 If you want to compile LilyPond from source, download here:
 110 @itemize @bullet
 111 @item Download stable releases at
 112 @uref{ftp://ftp.gnu.org/gnu/lilypond/,GNU}
 113 @item Download development releases from
 114 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/,the source}
 115 @item @uref{http://sca.uwaterloo.ca/lilypond/, by http (Canadian
 116 mirror)} and
 117 @uref{ftp://sca.uwaterloo.ca/pub/, ftp (Canadian  mirror)}
 118 @item
 119 @uref{ftp://ftp.lilypond.org/pub/LilyPond/,mirror (Europe)}
 120 @end itemize
 121
 122 Installing and compiling requires many additional packages, which are
 123 listed in the @uref{Documentation/topdocs/out-www/INSTALL.html,
 124 installation instructions}.
 125
 126 Binaries are available, but are not updated for every version released.
 127 @itemize @bullet
 128 @item
 129 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/,RedHat-i386 and Linuxppc RPMs:}
 130 @item
 131 @uref{ftp://ftp.debian.org/pub/debian/dists/unstable/main/binary-i386/tex,
 132  Debian binary}
 133 @item @uref{http://home.austin.rr.com/jbr/jeff/lilypond/,Windows NT}
 134 @end itemize
 135
 136
 137 @html
 138 <a name="mailing-lists">
 139 @end html
 140 @unnumberedsec Mailing list
 141
 142 If you have questions, do write to the mailing lists!
 143  (But don't forget to read the @uref{Documentation/out-www/faq.html,
 144 Frequently Asked Questions} first.)
 145
 146
 147 @itemize @bullet
 148 @item @samp{info-gnu-music@@gnu.org} (@uref{http://www.mail-archive.com/info-gnu-music@@gnu.org,archive})
 149         is a moderated list for information on the GNU Music project, to
 150     subscribe: send mail with subject "subscribe" to
 151     info-gnu-music-request@@gnu.org.
 152     This list is moderated; ask
 153     @email{drl@@gnu.org, David R. Linn} or
 154     @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this
 155 list.
 156
 157
 158 @item @samp{help-gnu-music@@gnu.org} (@uref{http://www.mail-archive.com/help-gnu-music@@gnu.org,archive}).
 159     For help with LilyPond music project. To subscribe: send
 160     mail with subject "subscribe" to
 161     @email{help-gnu-music-request@@gnu.org}
 162
 163 @item @samp{bug-gnu-music@@gnu.org} (@uref{http://www.mail-archive.com/bug-gnu-music@@gnu.org,archive})
 164     If you have bugreports, you should send them to this list.  If you
 165 want to know about bugs, subscribe: send mail with subject "subscribe"
 166 to @email{bug-gnu-music-request@@gnu.org}.
 167
 168
 169         Please include in your bugreport the version of LilyPond that
 170 you experience the problem with, a description of your system and sample
 171 input to reproduce the problem. Do not send output files over the list,
 172 they tend to be very big and don't help with describing the problem.
 173
 174
 175 @item @samp{gnu-music-discuss@@gnu.org} (@uref{http://www.mail-archive.com/gnu-music-discuss@@gnu.org,archive})
 176     For discussions concerning LilyPond, to subscribe: send
 177     mail with subject "subscribe" to
 178     @email{gnu-music-discuss-request@@gnu.org}.
 179
 180
 181 @end itemize
 182
 183 If you want to unsubscribe use the same procedure as subscribing, but
 184 substitute @code{unsubscribe} where you would put @code{subscribe}.
 185
 186 @unnumberedsubsec Webmaster's Disclaimer
 187
 188 These pages were entirely created from a @strong{development snapshot}
 189 of the LilyPond package.  The version of this webpage is printed at the
 190 bottom.
 191
 192 @html
 193 <p align=center>
 194 [
 195     <a href="#download">Download</a>
 196     |
 197     <a href="Documentation/out-www/faq.html">FAQ</a>
 198     |
 199     <a href="Documentation/out-www/index.html">Documentation</a>
 200     |
 201     <a href="#music">Music archives</a>
 202     |
 203     <a href="#mailing-lists">Mailing lists</a>
 204     |
 205     <a href="Documentation/out-www/CHANGES.txt">News</a>
 206 ]
 207 @end html
 208
 209 @bye