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
  24 `GUILE 1.4, or newer.'
  25      Check out the GUILE webpage
  26      (http://www.gnu.org/software/guile.html)
  27
  28    You can get the latest version of the GNU + Cygnus tools from cygnus
  29 mirror site (http://sources.redhat.com/cygwin/mirrors.html).
  30
  31 Windows precompiled binaries
  32 ============================
  33
  34 `LilyPond'
  35      Click here
  36      (http://appel.lilypond.org/lilypond/gnu-windows/setup.exe) to
  37      install LilyPond, or visit LilyPond on Windows
  38      (http://appel.lilypond.org/lilypond/gnu-windows).
  39
  40      This will install the minimal set of cygwin tools needed to run
  41      LilyPond.  If you already have cygwin installed, don't worry:
  42      nothing will be installed twice.
  43
  44    Note that none of the developers uses Windows, of course.  In fact,
  45 we recommend you to use GNU/Linux for running LilyPond.  We provide
  46 these binaries anyway, because it saves us the trouble of helping
  47 Windows users trying to compile LilyPond themselves.
  48
  49    These binaries are cross compiled for Windows on a GNU/Linux box.
  50 You may want to check out the cross compilation scripts
  51 (http://appel.lilypond.org/lilypond/gnu-windows/cross.tar.gz).
  52
  53 Windows running requirements
  54 ============================
  55
  56    GNU LilyPond does use a lot of resources. For operation you need the
  57 following software
  58
  59 `GUILE'
  60      Included in binary installation.
  61
  62 `TeX'
  63      A full TeX installation.  See /usr/share/doc/tetex-beta for
  64      details.
  65
  66 `GSView'
  67      Click  here (ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe) to
  68      install GSView (GhostView for Windows), or visit ftp.cs.wisc.edu
  69      (ftp://ftp.cs.wisc.edu/ghost/ghostgum).
  70
  71 `Python'
  72      Click here (http://www.python.org/ftp/python/win32/py152.exe) to
  73      install Python-1.5.2, or visit www.python.org
  74      (http://www.python.org).
  75
  76 Windows running setup
  77 =====================
  78
  79    If you're lucky, after running `setup.exe' you're all set up.
  80
  81    Open a LilyPond shell (or any bash shell), and type
  82      lilypond --help
  83
  84    If you don't see something similar to
  85      Usage: lilypond [OPTION]... [FILE]...
  86
  87      Typeset music and or play MIDI from FILE
  88
  89      LilyPond is a music typesetter.  It produces beautiful sheet music
  90      using a high level description file as input.  LilyPond is part of
  91      the GNU Project.
  92
  93      Options:
  94        -h,--help             this help
  95      [..]
  96
  97    you should try adding `/usr/lilypond-x.y.z/bin' to your path, do:
  98      PATH=/usr/lilypond-1.3.147/bin:$PATH
  99
 100    and try again.
 101
 102    [TODO:
 103
 104    * talk about /etc/profile.d/lilypond-profile.sh
 105
 106    * GUILE errors
 107
 108    * TEX errors
 109
 110    ]
 111