proving git release script isn't busted
[feisty_meow.git] / documentation / cygwin_install_list.txt
1
2 The cygwin setup app is available at: http://cygwin.com
3
4 The default packages selected by Cygwin are a good starting point for running
5 Feisty Meow on windows.  If you supplement this set with a few additional
6 packages, you can rely on the apt-cyg tool rather than having to run the
7 Cygwin setup program (which can be a little fiddly).  Here is a step by step
8 process to getting going with apt-cyg:
9
10 1) Install Cygwin.
11
12 Run the Cygwin setup exe from their website.  Keep all the default packages
13 that the installer suggests, but add the following additional ones (the
14 easiest way to add additional packages is to switch to the "Full" view for the
15 package list and then search for the terms below):
16
17   + lynx
18   + wget
19   + subversion
20
21 2) Install apt-cyg.
22
23 The apt-cyg program brings the convenience of the Debian and Ubuntu installer
24 application (apt) to Cygwin.  This program does require a couple of additional
25 setup steps.
26
27 This material is drawn from the apt-cyg home page:
28   https://github.com/transcode-open/apt-cyg
29
30 Start the cygwin bash prompt (there should be a desktop icon or start menu
31 icon for it called something like "cygwin64") and run the following
32 commands (omitting the '#' in front):
33
34   # lynx -source rawgit.com/transcode-open/apt-cyg/master/apt-cyg > apt-cyg
35   # install apt-cyg /bin
36
37 3) Install the basic set of cygwin apps and libraries.
38
39 These tools are not necessarily needed by the Feisty Meow scripts, but they
40 are all required to create a sane and useful Unix or Linux environment on
41 MS-Windows.  You may find you will want additional packages installed in the
42 future, and you can use this same approach.
43
44 In the cygwin bash prompt, type this command:
45
46 # apt-cyg install bc crypt cygutils emacs email expect gcc-g++ git gitk \
47   gvim inetutils less lynx make mutt ncftp openssh perl procps python \
48   sharutils shutdown subversion time unzip util-linux vim wget xinit \
49   xterm zip
50
51 You may have cleverly spotted that we repeated some package names that were
52 already installed using the Cygwin setup program in step 1.  That is fine and
53 should just fetch the latest versions.
54
55 Later, to update the apt-cyg package datebase to the latest available on the
56 internet, you can run this command:
57
58 # apt-cyg update
59
60 We don't currently know of an analog in apt-cyg of the "apt dist-upgrade"
61 command, which fetches all updated versions of the installed packages.  We
62 think the install command above will upgrade packages when there are new ones
63 available.  Also, the cygwin setup tool (bless its heart) may automatically
64 update packages if you run it again (you don't need to select anything again,
65 but just run through the install process to get the latest).
66
67 ==> hmmm: verify above claims.
68
69