-\input texinfo @c -*-texinfo-*-
-@setfilename WINDOWS.info
-@settitle WINDOWS - compiling and installing GNU LilyPond on Windows
-
-@node Top
-@top
-
-@chapter WINDOWS - compiling and installing GNU LilyPond on Windows
-
-This document is a supplement to INSTALL.txt, you may want to read
-that too.
-
-@section Obtaining LilyPond
-
-You can get the latest version of LilyPond at
-@uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/,
-ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/}.
-
-@section Windows build requirements
-You need the following packages to compile Lilypond on Windows.
-
-@table @code
-@item The GNU + Cygnus tools, 1.1.7 or newer.
-Check out the @uref{http://sources.redhat.com/cygwin,Cygwin webpage}.
-You can get the latest version of the GNU + Cygnus tools from cygnus
-@uref{http://sources.redhat.com/cygwin/mirrors.html,mirror site}.
-Install everything, including tetex.
-@item GUILE 1.4, or newer.
-Check out the @uref{http://www.gnu.org/software/guile.html,GUILE
-webpage}. You may need the patch @file{guile-1.4-gnu-windows.patch}
-included in LilyPond's source distribution.
-@end table
-
-
-@section Windows precompiled binaries
-
-@table @code
-@item LilyPond
-Click @uref{http://appel.lilypond.org/lilypond/gnu-windows/setup.exe,
-here} to install LilyPond, or visit @uref{http://appel.lilypond.org/lilypond/gnu-windows,
-LilyPond on Windows}.
-
-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}.
-@end table
-
-Note that none of the developers uses Windows, of course. In fact, we
-recommend you to use GNU/Linux for running LilyPond. We provide these
-binaries anyway, because it saves us the trouble of helping Windows
-users trying to compile LilyPond themselves.
-
-These binaries are cross compiled for Windows on a GNU/Linux box. You
-may want to check out the
-@uref{http://appel.lilypond.org/lilypond/gnu-windows/cross-1.1.8.tar.gz,cross
-compilation scripts}.
-
-@section Windows running requirements
-
-GNU LilyPond does use a lot of resources. For operation you need the
-following software
-
-@table @code
-@item GUILE
-Included in binary installation.
-@item TeX
-A full TeX installation.
-Click
-@uref{http://prdownloads.sourceforge.net/miktex/miktex-2.0-lvl-1.zip,here}
-to install basic MiKTeX commands,
-or visit @uref{http://www.miktex.org,www.miktex.org}.
-@c See @file{/usr/doc/cygwin/tetex-beta-20001218.README} for details.
-@item PostScript tools
-@table @code
-@item GSView-2.6, or
-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}.
-
-@item 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,
-or visit the
-@uref{http://www.cs.wisc.edu/~ghost/,Ghostscript, Ghostview and GSview site}.
-@end table
-
-@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}.
-
-Python > 1.5.2 has ugly licensing issues, so we only used and tested
-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
-
-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:
-
-* politely ask windows users not to complain but rather send instructive
-bug reports along with patches.
-
-* 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
- 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.
-]
-
-
-emacs
-
-http://cygwin.com/ml/cygwin/2000-08/msg01049.html
-http://www.cs.unc.edu/~juliano/my_emacs_files/cygwin32-mount.el
-http://cygwin.com/ml/cygwin/2000-02/msg00109.html
-http://sources.redhat.com/ml/cygwin/2001-01/msg00878/cygwin32-mount.el
-
- ;; setup Bash shell
- (setq exec-path (cons "C:/cygwin/bin" exec-path))
- (setenv "PATH" (concat "C:\\cygwin\\bin;" (getenv "PATH")))
- (setq process-coding-system-alist '(("bash" . undecided-unix)))
- (setq w32-quote-process-args ?\")
- (setq shell-file-name "bash")
- (setenv "SHELL" shell-file-name)
- (setq explicit-shell-file-name shell-file-name)
- (add-hook 'comint-output-filter-functions 'comint-strip-ctrl-m)
-
-@end ignore
-
-