@table @code
@item The GNU + Cygnus tools, 1.1.7 or newer.
Check out the @uref{http://sources.redhat.com/cygwin,Cygwin webpage}.
-@item GUILE 1.4, or newer.
-Check out the @uref{http://www.gnu.org/software/guile.html,GUILE webpage}
-@end table
-
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
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.
-
+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
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.tar.gz,cross
+@uref{http://appel.lilypond.org/lilypond/gnu-windows/cross-1.1.8.tar.gz,cross
compilation scripts}.
@section Windows running requirements
@item GUILE
Included in binary installation.
@item TeX
-A full TeX installation. See /usr/share/doc/tetex-beta for details.
-@item GSView
-Click @uref{ftp://ftp.cs.wisc.edu/ghost/ghostgum/gsv36w32.exe,here} to
-install GSView (GhostView for Windows), or visit
+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.
+@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
+
@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}.
+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
[..]
@end example
-you should try adding @file{/usr/lilypond-x.y.z/bin} to your path, do:
+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
[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
+* GUILE errors, simple guile test
-* TEX errors
+* TEX errors, simple tex test
]
--- /dev/null
+\input texinfo @c -*-texinfo-*-
+@setfilename babysit.info
+@settitle Babysit Windows Install Wizard
+
+@node Top
+@top
+
+@chapter Babysit Windows Install Wizard
+
+If, after installing LilyPond, it doesn't run: don't panic -- don't
+complain. Our Q+A team has devised an easy and well tested solution.
+We advise you to reinstall Windows, and this time follow the
+instructions of the wizard minutely. You can't go wrong. Good luck!
+
+@example
+Desktop
+ :Netscape(1) :Netscape(2)
+Netscape
+ :Bookmarks(3) :www.lilypond.org(4)
+ :Windows Unstable(5)
+ :setup.exe(6)
+Netscape download
+ Unknown file type
+ :Save file(7)
+Save as
+ :Drop-down(8) :Select Desktop(9)@footnote{
+You could save the file where the dialog box suggests, ie,
+the almost at random place wherever you happened to save some
+previous file, but we're not in the business of saving clicks,
+and chances are you can't find it lateron, so we don't do that.}
+Save as
+ :Save(10)
+Save as
+ C:\WINDOWS\Desktop\setup.exe already exist
+ Do you want to replace it? :Yes(11)
+Desktop
+ :setup.exe(12) :setup.exe(13)
+GNU LilyPond Setup
+ Setup.exe version 2.40 :Next(14)
+ :X(15) Install from internet :Next(16)
+ Local Package Directory
+ :Browse(17) :C:\tmp(18) :Ok(19)@footnote{
+You could download everything on the desktop, but that will
+clutter it to a degree that your helpdesk will
+probably tell you that you need to reinstall windows, so
+we don't do that.} :Next(20)
+ Select install root directory
+ C:/cygwin :Next(21)
+ :X Direct internet connection(22) :Next(23)
+ Select Download Site
+ :http://appel.lilypond.org(24) :Next(25)
+ Select Packages to install (all) :Next(26)@footnote{
+You can get a lot of @emph{additional free clicks} here,
+by deselecting some packages, but the installation would
+be broken if you don't install everything, so we don't do that.}
+ :X Create Desktop Icon(27)
+ :X Add to Start Menu(28) :Next(29)
+ Installation Complete :Ok(30)
+Desktop
+ :GNU LilyPond(31):GNU LilyPond(32)
+@end example
+
+
+@bye
--- /dev/null
+\input texinfo @c -*-texinfo-*-
+@setfilename lily-wins.info
+@settitle LilyPond for Windows.
+
+@node Top
+@top
+
+@chapter Lily Wins on Windows
+
+
+@subsubsection ---FOR-IMMEDIATE-RELEASE---
+
+
+Until now, installing LilyPond on Windows was
+@uref{http://mail.gnu.org/pipermail/help-gnu-music/2001-April/000620.html,
+almost} a dull process that could easily be @uref{
+ftp://appel.lilypond.org/pub/gnu-windows/cygwin-1.1.7/bin/tar/lily-install-0.6-i686-cygwin.bin.tar.gz,
+automated} and scripted. This meant that you would have more time left
+for actual work, and we all know that's not what computers were designed
+for.
+
+Well, that kind of scary automating is no longer necessary!
+Also, it's no longer needed to @uref{http://www.gnu.org/software/wget,
+download}
+@uref{http://appel.lilypond.org/gnu-windows/tar/lilypond/lilypond-1.3.147-1.tar.gz,tarballs}
+or move @uref{http://www.gnu.org/software/guile, all sorts of files}
+@uref{http://www.mail-archive.com/gnu-music-discuss@@gnu.org/msg04380.html,
+around}. Sometimes, the @uref{http://www.winzip.com,automagical
+breaking while unpacking} process would even install flawlessly, and you
+had to
+@uref{http://mail.gnu.org/pipermail/gnu-music-discuss/2000-October/000517.html,
+break it yourself by flattening} the
+@uref{http://www.lilypond.org,LilyPond} tarball.
+
+Our specially formed Windows support task force has, after thoroughly
+investigating your particular needs as an individual user, formuled the
+revolutionary new concept of one-size-fits-all software, and delivered
+@uref{http://www.mail-archive.com/gnu-music-discuss%40gnu.org/msg03647.html,
+way before schedule}.
+
+With the upcoming @uref{
+http://mail.gnu.org/pipermail/info-gnu-music/2001-April/000060.html,
+LilyPond-1.4} release, we have innovated agressively, by copying and
+@uref{
+http://appel.lilypond.org/lilypond/gnu-windows/cygwin-installer.patch,
+mutilating } @uref{http://sources.redhat.com/cygwin,Cygwin}'s
+@uref{
+ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/mirrors/cygnus/snapshots/cygwin-src-20010410.tar.bz2,
+Windows installer}.
+No
+@uref{http://appel.lilypond.org/lilypond/gnu-windows/tar/lilypond/md5.sum,
+difficult checksums} or signatures. Enjoy the the thrills of running
+@uref{http://appel.lilypond.org/lilypond/gnu-windows/setup.exe,
+untrusted binaries} with adminstrator rights, on your painfully
+firewalled intranet.
+
+We proudly present our @emph{Gourmet-click-de-luxe} install: offering at
+least @uref{babysit.html, 32 totally unnecessary clicks}, before you can
+actually run LilyPond. This includes a nice and warm welcome click:
+@example
+GNU LilyPond Setup
+
+ Version x.y
+ (C) Red Hat and us
+
+ [N]ext->
+@end example
+and of course, especially for all people with an exceptionally fine
+developed Windows taste, the maybe even more hollow message that tells
+us there's nothing to be told, really:
+@example
+GNU LilyPond Setup
+
+ Installation completed.
+
+ [O]k
+@end example
+Yes, that's right. Farewell @uref{http://www.lilypond.org/auto, smooth
+nightly upgrades}. Even a click at the @emph{very end} is required, so
+that you actually feel very useful babysitting the whole process. Try
+it. You will agree that with this new innovative installer we have
+truly reached the holy grail of user friendliness.
+
+
+@bye