WINDOWS.txt

   1
   2
   3 WINDOWS - compiling and installing GNU LilyPond on Windows
   4 **********************************************************
   5
   6    This document is a supplement to INSTALL.txt, you may want to read
   7 that too.
   8
   9 Obtaining LilyPond
  10 ==================
  11
  12    You can get the latest version of LilyPond at
  13 ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/
  14 (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/).
  15
  16 Windows build requirements
  17 ==========================
  18
  19    You need the following packages to compile Lilypond on Windows.
  20
  21 `The GNU + Cygnus tools, 1.1.7 or newer.'
  22      Check out the Cygwin webpage (http://sources.redhat.com/cygwin).
  23      You can get the latest version of the GNU + Cygnus tools from
  24      cygnus mirror site (http://sources.redhat.com/cygwin/mirrors.html).
  25      Install everything, including tetex.
  26
  27 `GUILE 1.4, or newer.'
  28      Check out the GUILE webpage
  29      (http://www.gnu.org/software/guile.html).  You may need the patch
  30      `guile-1.4-gnu-windows.patch' included in LilyPond's source
  31      distribution.
  32
  33 Windows precompiled binaries
  34 ============================
  35
  36 `LilyPond'
  37      Click here
  38      (http://appel.lilypond.org/lilypond/gnu-windows/setup.exe) to
  39      install LilyPond, or visit LilyPond on Windows
  40      (http://appel.lilypond.org/lilypond/gnu-windows).
  41
  42      This will install the minimal set of cygwin tools needed to run
  43      LilyPond.  If you already have cygwin installed, don't worry:
  44      nothing will be installed twice.  To expand on this minimal set,
  45      click here (http://sources.redhat.com/cygwin/setup.exe), or visit
  46      a Cygwin mirror site
  47      (http://sources.redhat.com/cygwin/mirrors.html).
  48
  49    Note that none of the developers uses Windows, of course.  In fact,
  50 we recommend you to use GNU/Linux for running LilyPond.  We provide
  51 these binaries anyway, because it saves us the trouble of helping
  52 Windows users trying to compile LilyPond themselves.
  53
  54    These binaries are cross compiled for Windows on a GNU/Linux box.
  55 You may want to check out the cross compilation scripts
  56 (http://appel.lilypond.org/lilypond/gnu-windows/cross-1.1.8.tar.gz).
  57
  58 Windows running requirements
  59 ============================
  60
  61    GNU LilyPond does use a lot of resources. For operation you need the
  62 following software
  63
  64 `GUILE'
  65      Included in binary installation.
  66
  67 `TeX'
  68      A full TeX installation.  Click here
  69      (http://prdownloads.sourceforge.net/miktex/miktex-2.0-lvl-1.zip)
  70      to install basic MiKTeX commands, or visit www.miktex.org
  71      (http://www.miktex.org).
  72
  73 `PostScript tools'
  74
  75     `GSView-2.6, or'
  76           This old package has two advantages.  It has gsview and
  77           ghostscript bundeled, and it doesn't popup _Register
  78           Now|Cancel_ windows all the time.  It doesn't work together
  79           with Yap to display PostScript specials.
  80
  81           Click here
  82           (ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv26w32.exe) to
  83           install GSView-2.6 (GhostView for Windows), or visit
  84           ftp.cs.wisc.edu (ftp://ftp.cs.wisc.edu/ghost/ghostgum).
  85
  86     `GSView-3.6 and GhostScript-6.50'
  87           If you install both these packages, Yap will display
  88           PostScript specials.  You get annoying _Register Now|Cancel_
  89           popups, though.
  90
  91           Click here
  92           (ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe) for
  93           GSview and Click here
  94           (ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs650/gs650w32.exe)
  95           for GhostScript.  ftp.cs.wisc.edu
  96           (ftp://ftp.cs.wisc.edu/ghost/ghostgum).  or visit the
  97           Ghostview and GSview site.
  98
  99 `Python'
 100      Click here (http://www.python.org/ftp/python/win32/py152.exe) to
 101      install Python-1.5.2, or visit www.python.org
 102      (http://www.python.org).
 103
 104      Python > 1.5.2 has ugly licensing issues, so we only used and
 105      tested 1.5.2.
 106
 107 Windows running setup
 108 =====================
 109
 110    If you're lucky, after running `setup.exe' you're all set up.
 111
 112    Open a LilyPond shell (or any bash shell), and type
 113      lilypond --help
 114
 115    If you don't see something similar to
 116      Usage: lilypond [OPTION]... [FILE]...
 117
 118      Typeset music and or play MIDI from FILE
 119
 120      LilyPond is a music typesetter.  It produces beautiful sheet music
 121      using a high level description file as input.  LilyPond is part of
 122      the GNU Project.
 123
 124      Options:
 125        -h,--help             this help
 126      [..]
 127
 128    you should try adding `/usr/lilypond-x.y.z/bin' to your PATH, do:
 129      PATH=/usr/lilypond-1.3.147/bin:$PATH
 130
 131    and try again.
 132
 133    [TODO:
 134
 135    * politely ask windows users not to complain but rather send
 136 instructive bug reports along with patches.
 137
 138    * emacs-mode installation, figure out and describe proper
 139 emacs-on-cygwin setup.
 140
 141    * talk about /etc/profile.d/lilypond-profile.sh
 142
 143    * GUILE errors, simple guile test
 144
 145    * (La)TEX errors, simple tex test
 146
 147    ]
 148