on a Microsoft Windows 95, 98, NT or 2000 machine.
This release is a free extra service of the developers to assist windows
-users. Please remember that we (the developers) rather dislike windows,
+users. Please remember that we (the developers) rather dislike windows,
and none of us use it. Don't complain to us that installing LilyPond is
-too difficult; rather, send us code that works better.
+too difficult; rather, if you know something about your Windows, send us
+code that works better (see @uref{compiling.html,compiling}).
-You must install the following software:
+@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
-@uref{ftp://ftp.lilypond.org/pub/LilyPond/gnu-windows/setup.exe, setup.exe}
+@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. 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}.
+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,
+Python 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.
-For example, download and install
-@uref{http://prdownloads.sourceforge.net/miktex/miktex-2.0-lvl-1.zip,MikTeX},
+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.
@uref{http://www.python.org,www.python.org}.
We have not tried using newer versions than 1.5.2.
-@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
-@example
-lilypond --help
-@end example
-
-If you don't see something similar to
-@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 table
-you should try adding @file{/usr/lilypond-x.y.z/bin} to your @var{PATH},
-do:
-@example
-PATH=/usr/lilypond-1.3.147/bin:$PATH
-@end example
-and try again.
[TODO:
* emacs-mode installation, figure out and describe proper
emacs-on-cygwin setup.
-* talk about /etc/profile.d/lilypond-profile.sh
-
-* GUILE errors, simple guile test
-
-* (La)TEX errors, simple tex test
+]
-]
@ignore
guile -v