
Road-bash                 http://www.qhull.org/road/bash/doc/road-bash.html

   A portable bash shell for Linux, Windows, MacOS, Cygwin, MINGW, and Unix
   Version 2008.3   2008/06/30

Copyright 2005-2008, Road Intranet, Cambridge MA
Documentation and copyright notices are in /doc
Copyrights are GPL or open source.

---------------------------
-- Installation
---------------------------

On Unix, Cygwin, Linux, MacOS, etc.
-- Extract the tgz file to your home directory (~/)
-- Copy ~/bash/etc/skel/.* to ~/
-- [Optional] Copy ~/bash/etc/road* to /etc
-- Source ~/.bashrc
-- Execute bash/local/bin/road-test.sh

On Windows
-- Extract the zip file to C: (or another location)
-- Double-click the bash icon (a tree)
-- Execute road-test.sh
-- Execute util/bash.bat to switch from cmd to bash

On MINGW
-- Follow the installation instructions for Windows
-- Install or copy your mingw directory to /bash
-- Replace or review bash/etc/config.site.  For new installations, 
   you may need to run the MSYS installer to configure this file.
-- Review the files in bash/bin and bash/local/bin
-- Use bash/util/msys.bat or change the target of bash/bash.lnk

---------------------------
-- Contents
---------------------------

The tgz distribution includes bash/etc, bash/doc/*, and bash/local road scripts

bash/bin
-- Executable files from MSYS, a minimal system for MINGW
   http://www.mingw.org/msys.shtml
-- Documentation and copyright notices are in bash/doc/msys
   Copyrights are GPL or open source.
   Invoke with --help for usage notes
-- Contents of the bin directory for MSYS-1.0.10
   http://downloads.sourceforge.net/mingw/MSYS-1.0.10.exe
-- sh.exe updated to bash 3.1.0(3) (MSYS-1.0.11 dev)
   http://downloads.sourceforge.net/mingw/bash-3.1-MSYS-1.0.11-snapshot.tar.bz2
-- sed.exe replaced by a later release.  See bash/local/README.txt
-- sort.exe replaced by a later version.  See bash/local/README.txt

bash/doc
-- Documentation and copyright notices
-- COPYING.txt -- Copyright notice for Road-bash
-- Changes.txt -- Change history for Road-bash
-- road-bash.html -- Documentation for Road-bash

bash/etc
-- Configuration directory
-- config.site, fstab.sample, termcap from MSYS
-- profile initializes $PATH, $HOME, etc.
-- road-bashenv.sh initializes the bash environment
-- road-bashrc.sh initializes an interactive environment
-- road-hostrc.sh for shared aliases and namedirs
-- road-script.sh defines a scripting environment

bash/etc/skel
-- Initialization files for user home directories
-- road-root.bash_profile for distinguishing users by SSH key [wsears]
-- .bashrc invokes etc/road-bashenv.sh, etc/road-bashrc.sh, ~/.bashenv
-- .inputrc is the initialization file for bash's readline()
-- .profile invokes .bashrc for login shells
-- .vimrc is the initialization file for vim

bash/home
-- User home directories created by /etc/profile

bash/local
-- Unix-like packages and programs
-- Place each package in a sub-directory with proxies in bash/local/bin
-- See bash/local/README.txt

Road scripts in bash/local/bin
-- p4edit opens-for-edit modified files (Perforce)
-- road-make.sh creates the bash and road distributions
-- road-test.sh tests the bash installation

bash/util
-- Windows utilities and bat files (e.g., sysinternals)
-- bash.bat invokes bash.  Use 'b' to return to current directory
-- See bash/util/README.txt

bash/var
-- Miscellaneous files and directories
-- /var/log for log files
-- /var/tmp for temporary files
