more docs, much better cygwin info

diff --git a/documentation/cygwin_install_list.txt b/documentation/cygwin_install_list.txt
index acd8d7775c871f938d4a091a34bbb927dc43123a..cc8589d89d5c06443bc7e9ff271177836b583764 100644 (file)
--- a/documentation/cygwin_install_list.txt
+++ b/documentation/cygwin_install_list.txt
@@ -1,65 +1,42 @@
 \r
-recommended packages to install in cygwin's setup\r
-if you're going to use cygwin on windows:\r
 \r
-first, keep all the standard packages that cygwin will enable.\r
-second, add these packages to get the full recommended set...\r
+The cygwin setup app is available at: http://cygwin.com\r
 \r
-===========\r
+The default packages selected by Cygwin are a good starting point for running Feisty Meow on windows.  If you supplement this set with a few additional packages, you can rely on the apt-cyg tool rather than having to run the Cygwin setup program (which can be a little fiddly).  Here is a step by step process to getting going with apt-cyg:\r
 \r
-using apt-cyg (https://github.com/transcode-open/apt-cyg),\r
-this is the only command needed:\r
+1) Install Cygwin.\r
+Run the Cygwin setup exe from their website.  Keep all the default packages that the installer suggests, but add the following additional ones (the easiest way to add additional packages is to switch to the "Full" view for the package list and then search for the terms below):\r
 \r
-apt-cyg install bc crypt emacs email expect gcc-g++ git gitk gvim inetutils \\r
-  libcrypt-devel libcurl-devel libgnutls-devel make mutt ncftp openssh \\r
-  openssl-devel perl python subversion time unzip util-linux vim xinit \\r
-  xterm zip\r
+  + lynx\r
+  + wget\r
+  + subversion\r
 \r
+2) Install apt-cyg.\r
 \r
-===========\r
+The apt-cyg program brings the convenience of the Debian and Ubuntu installer application (apt) to Cygwin.  This program does require a couple of additional setup steps.  This material is drawn from the apt-cyg home page: https://github.com/transcode-open/apt-cyg\r
 \r
-list broken out by category:\r
+Start the cygwin bash prompt (there should be a desktop icon or start menu icon for it called something like cygwin terminal?) and run the following commands:\r
 \r
-shells:\r
-  python\r
-  perl\r
+  # lynx -source rawgit.com/transcode-open/apt-cyg/master/apt-cyg > apt-cyg\r
+  # install apt-cyg /bin\r
 \r
-network:\r
-  ncftp\r
-  openssh\r
+3) Install the minimum set of cygwin apps and libraries.\r
 \r
-editors:\r
-  vim\r
-  gvim\r
-  emacs\r
+These tools are not necessarily all needed by the Feisty Meow scripts, but they are all required to create a sane and useful Unix or Linux environment on MS-Windows.  You may find you need other packages installed in the future, and you can use this same approach.\r
 \r
-revision control:\r
-  git\r
-  gitk\r
-  subversion\r
+In the cygwin bash prompt, type this command:\r
 \r
-general tools:\r
-  bc\r
-  expect\r
-  util-linux\r
-  inetutils\r
-  email\r
-  mutt\r
-  unzip\r
-  zip\r
-  crypt\r
-  time\r
+  # apt-cyg install bc crypt cygutils emacs email expect gcc-g++ git gitk \\r
+    gvim inetutils less lynx make mutt ncftp openssh perl procps python \\r
+    sharutils shutdown subversion time unzip util-linux vim wget xinit \\r
+    xterm zip\r
 \r
-libraries:\r
-  libcurl-devel\r
-  libgnutls-devel \r
-  openssl-devel\r
+You may have cleverly spotted that we repeated some package names that were already installed using the Cygwin setup program.  That is fine and should just fetch the latest versions.\r
 \r
-build tools:\r
-  gcc4\r
-  make\r
+Later, to update the apt-cyg package datebase to the latest available on the internet, you can run this command:\r
 \r
-x window support:\r
-  xterm\r
-  xinit\r
+  # apt-cyg update\r
+\r
+We don't currently know of an analog in apt-cyg of the "apt dist-upgrade" command, which fetches all updated versions of the installed packages.  We think the install command, if repeated from earlier will upgrade packages when it can.  Also, the cygwin setup tool (bless its heart) may automatically update the packages that it can if you run it again (you don't need to select anything again, but just run through the install process to get the latest).\r
+==> hmmm: verify above claims. \r
 \r

diff --git a/documentation/feisty_meow_command_reference.txt b/documentation/feisty_meow_command_reference.txt
index 789bf0de19ac245f23597ce089d48daff0dff38b..75371b11ba697be5f89127803283f8df363f7fc5 100644 (file)
--- a/documentation/feisty_meow_command_reference.txt
+++ b/documentation/feisty_meow_command_reference.txt
@@ -25,7 +25,7 @@ generally useful commands
   take inventory.  prints out some time and relative dimension in space
   information and shows the current directory's contents.
 
-  dir / l:
+  dir or l (lower-case L):
   show the directory with a "summing" feature that calculates the full size
   consumed by all files in the listing, with somewhat esthetic output.
 
@@ -33,17 +33,17 @@ generally useful commands
   the standard ls command (not the summing directory), but with ls colors
   enabled.
 
-  del / rm:
+  del or rm:
   invoke "safedel" feature to remove the files specified.  this archives the
   deleted files in "$TMP/zz_safedel_keep" and writes a report of the deletion
   history in "$TMP/zz_safedel_report.txt".
 
-note: currently there is no "empty the trash" function aside from running a command such as:
-# \rm -rf $TMP/zz_safedel*
-the backslash forces bash to run the "rm" tool from the path rather than from
-the feisty meow alias.
-a trash flushing feature is planned for the somewhat near future.
-
+note: currently there is no "empty the trash" function aside from running a
+command such as:
+  # \rm -rf $TMP/zz_safedel*
+the backslash forces bash to run the "rm" tool from the path rather than
+using the feisty meow alias.  a trash flushing feature is planned for the
+somewhat near future.
 
 revision control commands
 =========================
@@ -181,7 +181,7 @@ note: satis-refresh is the one site avenger command that hasn't been "feisty meo
 lower level scripts used by site avenger scripts
 ------------------------------------------------
 
-  add_domain / remove_domain: (from system script collection)
+  add_domain and remove_domain: (from system script collection)
   adds (or removes) a DNS domain to the bind9 configuration.  the domain
   tools, are very sensitive to any edits within the chunks of code they have
   written.  when it comes time to remove the domain again, the script will eat
@@ -190,7 +190,7 @@ lower level scripts used by site avenger scripts
   config files, be sure to do it way above or way below the auto-generated
   domain chunks.
 
-  add_apache_site / remove_apache_site: (from system script collection)
+  add_apache_site and remove_apache_site: (from system script collection)
   creates (or removes) an apache compatible site definition.  this will rely
   on the site's domain previously having been added to the DNS.