This directory exists to hold local configuration stuff for
Cygwin installations.

The command scripts here are shell scripts, and must be run from
a Cygwin command window.

You should run "post-install.sh" from this directory after installing Cygwin,
and logging into your normal domain.

This is how it works:

1) Administrator runs cyginst.bat which runs Cygwin's setup.exe and
   installs Cygwin, then performs step (2).
   
   Alternatively, install Cygwin yourself, start a Cygwin shell,
   and run step (2) manually from inside Cygwin.

2) The bash script post-install.sh is run, with the -fresh option
   to signify a fresh install.  If you already have Cygwin installed,
   you should run it with no argument.

3) Automatically, post-install.sh configures or adds some extra files
   in /etc, determines CYGDRIVE and CYGPATH, HOMEDRIVE and HOMEPATH,
   puts local.sh in /etc/profile.d/, and modifies it to know where
   the stage2post-install.sh file lives.  It also makes some extra
   shortcuts, creates proper accounts for multiple users in the local
   domain, and makes a strong effort to setup home directories sensibly.
   Then configures ssh and sshd (if sshd has not started, doing:
	net start sshd
   should start it.  Finally, it runs stage2post-install.sh.

4) stage2post-install.sh is run via step (3), or by /etc/profile.d/local.sh
   if the user's home directory doesn't contain .profile.  It sets up
   per-user config files.  In other words, it is automatically run on
   demand, when needed.


Filename	Description
-----------------------------------------------------------------
README.txt	Describes the files and directories contained in
 		this directory.

etc-enscript.cfg &
etc-local.sh &
etc-mailx.rc	Files named etc-xxx get copied to /etc/xxx, after first
		preserving any original /etc/xxx as /etc/xxx.orig

excel		Script that runs Excel on the named file(s).

lpr		A simple but effective script that does in fact work
		better than the lpr command that comes with Cygwin.
mailprog	Run mailprog-on-linux.  You might like to rename this
		command to have the same name as the actual mail program.
		It's expected that the mail program is X11-based, i.e. GUI.

mailprog-on-linux
		Invoke mailprog specified by $MAILPROG on Linux host
		specified by $LINUX.

office		Script to run the named Office component, on the
		named file(s).  Used by scripts word, excel, and powerpnt.

office_path	Used by .profile to define OFFICE_PATH in the environment
		(it determines the path where Microsoft Office is installed),
		for use by the "word", "excel" and "powerpnt" scripts.

passwd-stuff	Account creation script to make user logins work properly.

post-install.sh	Main script that does much of the configuration after Cygwin
		installation.

post-install.zip
		All these other files zipped up together.  This avoids
		a whole lot of problems with certain too-helpful browsers
		adding spurious filename extensions (like .txt) when you
		don't want them, and therefore messing everything up.

		The thing to do is:
		    1) Download cygwin.zip.
		    2) Unzip it somewhere, e.g.:
			    c:
			    cd temp
			    unzip -a cygwin.zip
		       The "-a" tells it to convert to Windows line-ending
		       convention, as it uncompresses the files.
		    3) Start up a Cygwin command window.
		    4) cd into the place where you did step (2).
		    5) Type:
			    ./post-install.sh
		       or
			    ./post-install.sh -fresh
		       if you haven't setup Cygwin on your system before.

powerpnt	Script that runs Powerpoint on the named file(s).


run-with-pause	Run a command and pause at the end if there was an error.
		Used by mailprog-on-linux.

stage2post-install.sh
		This is run after home directories have been setup,
		and accounts been created in /etc/passwd.  It copies
		varies useful config files into the user's home directory.
		It's run automatically (if you choose "-fresh" on the
		post-install.sh), but will be run automatically by a
		new user on the machine when they first start a Cygwin
		login shell (it's run via /etc/profile.d/local.sh).

startx.bat	The small batch file that starts the X11 server.

user.bashrc	Sample .bashrc file.  This is where aliases for commands
		are setup.  This one just contains the "lc" alias.

user.profile	Sample .profile file for users.

user.xinitrc	Sample .xinitrc file for users.

user.Xresources	Sample config stuff for X programs: initially, just xterm
		and rxvt, especially their font size and history scrollback.

WM.exitscript	This contains a temporary workaround for a bug in the
		Windows port of Window Maker (crash if config files end in
		CR-LF).  This was fixed after the 0.80.1 version was
		released.  It should be unnecessary with 0.80.2 and later.

word		Script that runs MS Word on the named file(s).

--------------------------------------------------------------------

luke