Documentation/topdocs/index.tely

   1 i\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 <img src="Documentation/pictures/out-www/lelie-logo.png" alt="[logo]">
  11 @end html
  12
  13
  14 @unnumberedsec What is LilyPond?
  15
  16 @c also use keywords: music notation software
  17 LilyPond is a music typesetter.  It produces beautiful sheet music
  18 using a high level description file as input. It excels at typesetting
  19 classical music, but you can also print pop-songs.  With LilyPond we
  20 hope to make music publication software available to anyone on the
  21 internet.
  22
  23 @unnumberedsec Why should I use it?
  24
  25 The input to LilyPond is plain text. So, you can use your favorite text
  26 editor to enter it, you can put it in mail or embed it in an article like
  27 this:
  28
  29
  30 @lilypond[fragment,verbatim]
  31 \relative c'' { \key c \minor; r8 c16 b c8 g as c16 b c8 d | g,4 }
  32 @end lilypond
  33
  34 The output looks very good: the font and the layout algorithms were
  35 inspired by engraved music, so you can expect that same clear and
  36 elegant look from your LilyPond output.  And if you don't like the
  37 looks, you can tweak almost everything.
  38
  39 The program also has limited MIDI functionality: you can write MIDI
  40 files with lilypond. You can also import files in PMX, MUP, MIDI, ABC,
  41 Finale and Musedata format.
  42
  43 LilyPond is free software. It is licensed under GNU General Public
  44 License, so you can use, modify and redistribute the program with
  45 almost no restrictions.  LilyPond is part of the
  46 @uref{http://www.gnu.org/,GNU Project}.
  47
  48 The version numbers are in Linux-kernel style: even numbered versions
  49 are `stable'. The webpages for the stable version (1.2) reside
  50 @uref{http://www.gnu.org/software/lilypond, on the GNU servers}. Big
  51 enhancements go into the latest odd numbered version (1.3), whose
  52 webpages are on @uref{http://www.cs.uu.nl/~hanwen/lilypond/,Han-Wen's
  53 site}.  Information on the latest and greatest features can be found in
  54 the @uref{Documentation/out-www/CHANGES.html, Change Log}.
  55
  56 If want more information, you can browse the
  57 @uref{Documentation/user/out-www/lilypond.html, manual} or other
  58 @uref{Documentation/out-www/index.html, documentation}.
  59
  60 @html
  61 <a name="music">
  62 @end html
  63 @unnumberedsec Sheet music
  64
  65
  66 If you are interested in sheet music typeset by LilyPond, have a look at
  67 the examples included. We have @uref{short-examples.html,short
  68 examples} and @uref{long-examples.html,longer examples}. The
  69 examples include sound bites  in MIDI, pictures in PNG, printable scores
  70 in PostScript, and LilyPond input. Others use LilyPond too, and have put
  71 scores on the web. Head over to @uref{http://appel.lilypond.org/wiki?DownloadLilyPondScores}
  72
  73 @html
  74 <a name="download-source">
  75 @end html
  76 @unnumberedsec Download
  77
  78 If you want to compile LilyPond from source, download here:
  79 @itemize @bullet
  80 @item Download stable releases at
  81 @uref{ftp://ftp.gnu.org/gnu/lilypond/,GNU}
  82 @item Download development releases from
  83 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/,the source}
  84 @item @uref{http://sca.uwaterloo.ca/lilypond/, by http (Canadian
  85 mirror)} and
  86 @uref{ftp://sca.uwaterloo.ca/pub/, ftp (Canadian mirror)}
  87 @item
  88 @uref{ftp://ftp.lilypond.org/pub/LilyPond/, mirror (Europe)}
  89 @end itemize
  90
  91 Installing and compiling requires many additional packages, which are
  92 listed in the @uref{Documentation/topdocs/out-www/INSTALL.html,
  93 installation instructions}.
  94
  95 @html
  96 <a name="download-binary">
  97 @end html
  98 Binaries are available, but are not updated for every version released.
  99 @itemize @bullet
 100 @item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/, RedHat i386}
 101 @item @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/ppc, LinuxPPC}
 102 @item
 103 @uref{ftp://ftp.debian.org/debian/pool/main/l/lilypond,
 104 Debian GNU/Linux Stable}
 105 @item
 106 @uref{ftp://ftp.debian.org/debian/pool/main/l/lilypond1.3,
 107 Debian GNU/Linux Unstable}
 108 @item @uref{http://home.austin.rr.com/jbr/jeff/lilypond/, Windows Stable}
 109 @item @uref{http://appel.lilypond.org/lilypond/gnu-windows, Windows
 110 Testing}
 111 @end itemize
 112
 113
 114 @html
 115 <a name="mailing-lists">
 116 @end html
 117 @unnumberedsec Mailing lists
 118
 119 If you have questions, do write to the mailing lists.  But don't forget
 120 to read the @uref{Documentation/topdocs/out-www/FAQ.html,Very Frequently
 121 Asked Questions} and @uref{http://appel.dyndns.org/wiki?LilyPondFaqs,
 122 Frequently Asked Questions} first.
 123
 124
 125 @itemize @bullet
 126 @item @uref{http://mail.gnu.org/mailman/listinfo/info-gnu-music,info-gnu-music@@gnu.org}
 127 is a low-volume list for information on the GNU Music project.
 128     This list is moderated; ask
 129     @email{drl@@gnu.org, David R. Linn} or
 130     @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this list.
 131 @item @uref{http://mail.gnu.org/mailman/listinfo/help-gnu-music,help-gnu-music@@gnu.org}
 132     For help with using LilyPond.
 133 @item @uref{http://mail.gnu.org/mailman/listinfo/bug-gnu-music,bug-gnu-music@@gnu.org}
 134 If you have bugreports, you should send them to this list.
 135
 136
 137
 138         Please include in your bugreport the version of LilyPond that
 139 you experience the problem with, a description of your system and sample
 140 input to reproduce the problem. Do not send output files over the list,
 141 they tend to be very big and don't help with describing the problem.
 142
 143
 144 @item @uref{http://mail.gnu.org/mailman/listinfo/gnu-music-discuss,gnu-music-discuss@@gnu.org}
 145     For discussions concerning LilyPond.
 146 @end itemize
 147
 148 These pages were entirely created from a @strong{development snapshot}
 149 of the LilyPond package.  The version of this webpage is printed at the
 150 bottom.
 151
 152 @bye