Documentation/windows/compiling.texi

   1 \input texinfo @c -*-texinfo-*-
   2 @setfilename compiling.info
   3 @settitle Compiling LilyPond on Windows
   4
   5 @html
   6 <!--- @@WEB-TITLE@@=Windows Compilation --->
   7 @end html
   8
   9 @section Obtaining LilyPond
  10
  11 The most convenient way of getting the LilyPond source, is to run
  12 @uref{http://cygwin.com/setup.exe,setup.exe} and check the
  13 @emph{source} option next to LilyPond in the Packages View dialogue window.
  14
  15 You can get the latest version of LilyPond at
  16 @uref{ftp://ftp.lilypond.org/pub/LilyPond/,
  17 ftp://ftp.lilypond.org/pub/LilyPond/}.
  18
  19 @section Windows build requirements
  20 You need the following packages to compile Lilypond on Windows (ie,
  21 for Cygwin).
  22
  23 @table @code
  24 @item The GNU + Cygnus tools, 1.3.10 or newer.
  25 Check out the @uref{http://cygwin.com,Cygwin webpage}.
  26 You can get the latest version of the GNU + Cygnus tools from a Cygwin
  27 @uref{http://cygwin.com/mirrors.html,mirror site}.
  28 @end table
  29
  30 @subsection Cross compiling
  31
  32 These binaries are cross compiled for Windows on a GNU/Linux box using
  33 mknetrel.  Get it from:
  34 @quotation
  35 @example
  36      cvs -d:pserver:anoncvs@@sources.redhat.com:/cvs/cygwin-apps co mknetrel
  37 @end example
  38 @end quotation
  39
  40 If your distribution does not include a Cygwin cross building
  41 environment, you can quite easily create one using mknetrel.
  42 Apply the
  43 @uref{http://lilypond.org/cygwin/mknetnel/mknetrel-cross-tools.patch,
  44 mknetrel-cross-tools patch}, and read @file{CROSS-TOOLS}.
  45
  46 Although mknetrel is well suited for this, the mknetrel maintainer
  47 does not see any reason to include this patch.
  48
  49 You can also get
  50 @uref{http://lilypond.org/lilypond/cygwin/i386-gnu-linux-x-i686-pc-cygwin,
  51 precompiled binaries for GNU/Linux ix68}.
  52
  53 @subsection Compiling on Windows
  54
  55 Compiling on Windows should be possible, but how should we know?  If
  56 you have any experiences you want to share, please do so at
  57 @uref{http://lilypond.org/wiki?CompilingOnWindows,Compiling on
  58 Windows}.  Or write to one of the mailing lists.
  59
  60 @section Windows installation specifics
  61
  62 Installing LilyPond on Windows is similar to a unix installation, but
  63 needs a number of extra tricks.  All code for these tricks can be
  64 found in LilyPond's mknetrel build script in the source package
  65 directory @file{cygwin/mknetrel} and @uref{../../cygwin/mknetrel,
  66 mknetrel:extra/lilypond}.
  67
  68 @section The LilyPond Installer RIP
  69
  70 As LilyPond is now included in the Cygwin distribution, the LilyPond
  71 installer is no more.  Use Cygwin's
  72 @uref{http://cygwin.com/setup.exe,setup.exe}.
  73