This release is a free extra service of the developers to assist 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 need the following software (but read on):
+@section Windows binary setup
-@c list these first, because lilypond install scripts look for these
-@c packages
-@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}.
-
-@item Python
-Click @uref{http://www.python.org/ftp/python/win32/py152.exe,here} to
-install Python-1.5.2, or visit
-@uref{http://www.python.org,www.python.org}.
-
-We have not tried using newer versions than 1.5.2.
+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
to install LilyPond.
This will install the minimal set of cygwin tools needed to run
-LilyPond.
+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, but that's still somewhat
-experimental. If you choose to install these by hand (see above), make
-sure to install them @strong{before} you install LilyPond.
+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
@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]...
-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.3.147/bin:$PATH
+PATH=/usr/lilypond-1.4.2/bin:$PATH
@end example
+@end quotation
and try again.
-[TODO:
+@subsection Trouble
-* emacs-mode installation, figure out and describe proper
-emacs-on-cygwin setup.
+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).
-* talk about /etc/profile.d/lilypond-profile.sh
+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.
-* GUILE errors, simple guile test
+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}.
+
+@item Python
+Click @uref{http://www.python.org/ftp/python/win32/py152.exe,here} to
+install Python-1.5.2, or visit
+@uref{http://www.python.org,www.python.org}.
+
+We have not tried using newer versions than 1.5.2.
+
+@end table
+
+
+
+[TODO:
-* (La)TEX errors, simple tex test
+* emacs-mode installation, figure out and describe proper
+emacs-on-cygwin setup.
]
+
+
@ignore
guile -v
projects / lilypond.git / blobdiff