\input texinfo @c -*-texinfo-*-
@setfilename installing.info
@settitle LilyPond on Windows

@node Top
@top

@chapter WINDOWS - Installing GNU LilyPond on Windows

This document explains how to install the binary release for windows
on a Microsoft Windows 95, 98, NT or 2000 machine.

This release is a free extra service of the developers to assist windows
users.  When reporting problems,  please keep in mind that we (the developers)
do not use Windows.  In fact,  if you know something about Windows, and
are able to write code, please send us code that works better (see
@uref{compiling.html,compiling}).

@section Windows binary setup 

Apart from LilyPond itself, you need Cygwin, GUILE, Python and a TeX
installation, but all this software be installed by running setup.exe:

@table @asis
@item LilyPond
Download and run
@c let's do http, so that people read the README
@uref{http://www.lilypond.org/gnu-windows/setup.exe, setup.exe}
to install LilyPond.

This will install the minimal set of cygwin tools needed to run
LilyPond.  Make sure to install in the default place, @file{c:/cygwin},
and install everything.

As of version 1.3.150, you also have the option to install MiKTeX and
GSView from this installer, which is recommended.  If you choose to
install these by hand (see below), make sure to install them
@strong{before} you install LilyPond, otherwise your LilyPond setup will
be broken.

If you already have cygwin installed, don't worry: nothing will be
installed twice.  To expand on this minimal set, click
@uref{http://sources.redhat.com/cygwin/setup.exe,here}, or visit a
Cygwin @uref{http://sources.redhat.com/cygwin/mirrors.html,mirror site}.
@end table


@section Windows running setup

If you're lucky, after running @file{setup.exe} you're all set up.

Open a LilyPond shell (or any bash shell), and type

@quotation
@example
lilypond --help
@end example
@end quotation

If you don't see something similar to

@quotation
@example
Usage: lilypond [OPTION]... [FILE]...

Typeset music and or play MIDI from FILE

LilyPond is a music typesetter.  It produces beautiful sheet music
using a high level description file as input.  LilyPond is part of 
the GNU Project.

Options:
  -h,--help             this help
[..]
@end example
@end quotation

you should try adding @file{/usr/lilypond-x.y.z/bin} to your @var{PATH},
do:

@quotation
@example
PATH=/usr/lilypond-1.4.2/bin:$PATH
@end example
@end quotation

and try again.


@subsection Trouble

For problems and solutions see
@uref{http://lilypond.org/wiki?TroubleshootingWindows,Troubleshooting
Windows}


@subsection Additional software

LilyPond needs a number of software packages to be really useful.  These
are included in the binary setup program (see above).

If you choose to install this additional software yourself, make sure
you install LilyPond last, otherwise the LilyPond setup will be broken.
Also note that this means that you will probably need to fix some PATH
and TEX environment variables yourself.  If you think you can handle
that, you may do so, but don't complain if it doesn't work.

These software packages are included in the LilyPond installation:

@table @asis
@item A full TeX installation.

Currently, only MikTeX is supported.  Download and install
@uref{http://downloads.sourceforge.net/miktex/miktex-2.0-lvl-1.zip,MikTeX},
or visit @uref{http://www.miktex.org,www.miktex.org}.
@c See @file{/usr/doc/cygwin/tetex-beta-20001218.README} for details.

@item Ghostview.

You can use GSView-2.6.  This old package has two advantages.  It has
gsview and ghostscript bundeled, and it doesn't popup @emph{Register
Now|Cancel} windows all the time.  It doesn't work together with Yap to
display PostScript specials.

Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv26w32.exe,here} to
install GSView-2.6 (GhostView for Windows), or visit
@uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum,ftp.cs.wisc.edu}.

You can also use the newer versions GSView-3.6 and GhostScript-6.50 If
you install both these packages, Yap will display PostScript specials.
You get annoying @emph{Register Now|Cancel} popups, though.

Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe,here} for
GSview and 
Click @uref{ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs650/gs650w32.exe
,here} for GhostScript.
@uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum,ftp.cs.wisc.edu}.
or visit the
@uref{http://www.cs.wisc.edu/~ghost/,Ghostscript, Ghostview and GSview site}.

@end table



[TODO:


* emacs-mode installation, figure out and describe proper
emacs-on-cygwin setup.

]


@ignore 

  guile -v
  Guile 1.4.1

  guile -e %load-path
  ERROR: Wrong type to apply: ("/usr/share/guile/site" /usr/share/guile/1.4.1")
  

  
Mats?

Let's take this step by step.

It should not be critical which MikTeX version you use.
Let's first verify that your MikTeX works as it should.
Open a DOS window. Run the commands
>> latex sample2e
 Should produce some lines of output
>> yap sample2e
 Should display a three page document.

Next step; verify that the geometry package is in place. 
Save the attached file to the directory where you run 
your DOS window. Run the commands
>> latex geometrytest
>> yap geometrytest
This one you should get a single page document with some text
in each corner.
]

@end ignore


