Documentation/windows/compiling.texi

   1 @section Obtaining LilyPond
   2
   3 You can get the latest version of LilyPond at
   4 @uref{ftp://ftp.lilypond.org/pub/LilyPond/,
   5 ftp://ftp.lilypond.org/pub/LilyPond/}.
   6
   7 @section Windows build requirements
   8 You need the following packages to compile Lilypond on Windows.
   9
  10 @table @code
  11 @item The GNU + Cygnus tools, 1.1.7 or newer.
  12 Check out the @uref{http://sources.redhat.com/cygwin,Cygwin webpage}.
  13 You can get the latest version of the GNU + Cygnus tools from cygnus
  14 @uref{http://sources.redhat.com/cygwin/mirrors.html,mirror site}.
  15 Install everything, including tetex.
  16 @item GUILE 1.4, or newer.
  17 Check out the @uref{http://www.gnu.org/software/guile.html,GUILE
  18 webpage}.  You may need the patch @file{guile-1.4-gnu-windows.patch}
  19 included in LilyPond's source distribution.
  20 @end table
  21
  22 @subsection Cross compiling
  23
  24 These binaries are cross compiled for Windows on a GNU/Linux box.  You
  25 may want to check out the
  26 @uref{http://www.lilypond.org/gnu-windows/cross.tar.gz,cross compilation
  27 scripts}.
  28
  29 @subsection Compiling on Windows
  30
  31 Compiling on Windows should be possible, but how should we now?  If you
  32 have any experiences you want to share, please do so at
  33 @uref{http://lilypond.org/wiki?CompilingOnWindows,Compiling on Windows}.
  34 Or write to one of the mailing lists.
  35
  36 @section Windows installation specifics
  37
  38 Installing LilyPond on Windows is similar to a unix installation, but
  39 needs a number of extra tricks.  All code for these tricks can be found
  40 in the source package directory @file{Documentation/windows}.
  41
  42 @table @asis
  43 @item @file{guile-1.4-gnu-windows.patch}
  44 You may (Cygwin gets better every day) need this patch to compile GUILE.
  45 @item @file{cygwin-installer.patch}
  46 Apply this patch to the @file{cinstall} directory of
  47 @file{winsup-src/cinstall}, to get the LilyPond installer.
  48
  49 Compiling @file{setup.exe} has been complicated a bit with the
  50 introduction of the bzip2 feature:
  51 @quotation
  52 @example
  53     tar xjf cygwin-src-20010531.tar.bz2
  54     tar xjf winsup-src-20010531.tar.bz2
  55     tar xzf mingw-20010424-1.tar.gz
  56     cd winsup/cinstall
  57     patch < ../../cygwin-installer.patch
  58     cd ../bz2lib
  59     MINGW32=yes CFLAGS='-mno-cygwin' ./configure
  60     make
  61     cd -
  62     MINGW32=yes CFLAGS='-mno-cygwin' ./configure
  63     cp /home/cygwin/cygwin-1.3.2/usr/lib/mingw/crt2.o .
  64     make w32api_lib=/home/cygwin/cygwin-1.3.2/usr/lib/w32api \
  65         CXX='g++ -L/home/cygwin/cygwin-1.3.2/usr/lib/mingw'
  66 @end example
  67 @end quotation
  68 @item @file{--prefix=/usr/lilypond-x.y.x}
  69 The standard binary installation installs LilyPond into its own prefix.
  70 We think it's silly, but do this is on special request of Windows users.
  71 @item @file{fix-suffixes.sh}
  72 Add @file{.exe} to binary executables, add @file{.py} to Python scripts.
  73 @item @file{python-wrapper.sh}
  74 All python scripts get a wrapper script to make direct invocation easier
  75 and to change file paths to DOS style, which is needed by non-Cygwin
  76 Python, that's currently used.
  77 @item @file{latex-wrapper.sh}
  78 TeX and LaTeX get a wrapper script that changes the TEX path variables
  79 to DOS style, which is needed by non-Cygwin TeX, that's currently used.
  80 @item @file{/etc/postinstall/}
  81 A number of post installation scripts try to set registry entries and
  82 symlinks that are needed for the additional windows packages.
  83 @item @file{/etc/profile.d/}
  84 A number of login profile scripts set environment vars, every time you
  85 start the LilyPond/Cygwin shell (or Bash, for that matter).
  86 @end table
  87
  88 These scripts and tricks are known to work in some cases, but are
  89 woefully incomplete.  If you find a bug, please send us your fix.
  90
  91 Windows users have indicated that a DOS style login (as supposed to the
  92 LilyPond/Cygwin shell), would be useful.  We don't enjoy DOS scripting,
  93 and think users should try the bash shell, which is better suited for
  94 typing in commands.  However, if you have written useful DOS login
  95 scripts, please send us your code.
  96