A Quick Guide to Getting Around in UNIX for Windows Users
---------------------------------------------------------

When you start up Cygwin, you are placed in your home directory, in a terminal
window with a bash shell that accepts most familiar UNIX commands.  A few
default "."  (configuration) files have been setup for you, but otherwise your
directory is empty.  You can get a listing of the current directory by using
the "ls" command (short for "list").  This is like the DOS "dir" command, but
you need to specify some options (preceded by a dash) to get details.  To get
a more detailed listing including the "dot files", type "ls -lags".  The
".bashrc" file sets the search path for programs that you might want to run,
such as genesis.  At some point you may want to edit it.

To traverse to another directory (a "folder", in Windows terminology) you use
the "cd" (change directory) command.  This command takes an argument of the
directory you wish to change to.  Either an absolute or relative path argument
can be specified.  Absolute paths begin at the "root" of the unix file system
(/).  Relative paths begin from the currect working directory.  For example,
if you are in your home directory, you can get to the next lower directory
"Scripts" by typing "cd Scripts".  Typing "cd" by itself gets you to your home
directory.

To create a directory, use the "mkdir" command, e.g. "mkdir myScripts".
Note that file and directory names in UNIX are case-sensitive.  "myScripts" is
not the same as "myscripts".

To print out the current working directory you can use the "pwd" (Print
Working Directory) command.

You can examine text files (such as all of our README files) using the "more"
command.  This command will display a screenful (or 24 lines) of a files at a
time.  Pressing the space bar displays the next bunch of lines.  Pressing
"Enter" displays one additional line.  Pressing "'" returns you to the top of
the file and "q" will exit the more.  For example, "more tutorial1.g" will
display the contents of the GENESIS script file "tutorial1.g", if it exists in
the current working directory.

Other useful commands are "rm", meaning remove or delete, as in
"rm junk.mail", and "cp" to copy one file into another, as in
"cp .bashrc bashrc.old".  (A good idea if you plan to edit your .bashrc file
and want to make a backup in case you mess it up.)  "mv" is used to rename a
file or move it to a different directory, instead of copying it.

The two most common text editors for UNIX are 'vi' and 'emacs'.  If you are
not familiar with either editor, you may find it easier to learn emacs.
For an even simpler text editor with built-in help, try 'nedit' if it is
installed.  This has a user interface that will be familiar to users of
Windows Notepad.  Once you have started the Cygwin X server, you can start
nedit from the command prompt.  For example, to edit the file "mysim.g",
type "nedit "mysim.g &".  The editor will open in a separate window, and
because the the command was followed with an ampersand, it will run in
the background, meaning that you can continue to enter other commands in
the terminal window while the editor is running.

Documentation for most UNIX commands can be obtained with the "man" command.
For example "man ls" will tell you about all the options for the "ls" command.