README File for Walk v1.0 by CampbellWare
=========================================

1.0 Introduction
----------------

Thank you for downloading Walk v1.0 for Mac OS X!

Walk  "walks down" a folder hierarchy, starting with the folder supplied
on  the command line, and executes a user supplied shell command at each
level.  This can be useful for everthing from systematic changes of file
permissions to clean ups of build directories, etc. 

Walk  v1.0  for Linux is patterned after the iRMX86 Human Interface walk
command created by CampbellWare in 1983. 

2.0 Walk Installation
---------------------

Walk  is extremely simple to "install". Simply unpack the tarball (which
you  have  done  if you are reading this!), cd into the walk-1.0-release
directory  that  is  created  and copy the file "walk" to any convenient
location  on  your  executable  search path. Thats it - you are ready to
use Walk! Simply type "walk" and you are off and running. 

3.0 Walk Usage
--------------

Walk may be used in any of the following forms:

a) walk -h
b) walk --help

   Get basic help on how to use walk - walk then exits

c) walk . "shell command to execute"

   Execute  the  supplied shell command on the current directory and all
   subtending directories. 

   walk start_dir "shell command to execute"

   Execute   the   supplied  shell  command  on  the  supplied  starting
   directory and all of its subtending directories. 

d) walk start_dir -v "shell command to execute"
   walk start_dir --verbose "shell command to execute"

   Like  (c),  but  with  detailed informational messages as walk enters
   and exits directories 

Some examples:

- walk . ls
- walk photos "chmod -x *.jpg"
- walk my_web_site "chmod u+w *.html"
- walk my_build_dir -v "rm *.o"

4.0 Building Walk from Source
-----------------------------

The  source  for  Walk  v1.0  is  included.  It  may  be  found  in  the
walk-1.0-src  folder hierarchy created as part of unpacking the tarball.
A makefile is provided to build walk. 

5.0 Walk Has Been Verified On...
--------------------------------

Walk  has  been  tested  on  a PowerMac G5 running Mac OS X 10.4.8. Note
that  this  version  of  walk  has also been verified on a number of x86
Linux  distros,  including  SuSE  Linux  9.0, Mandrake 10.1, Debian 3.1,
Knoppix 3.4, Damn Small Linux 0.8 and Yoper 2.1. 

6.0 Getting Support for Walk
----------------------------

Enjoy  Walk!  If  you  have  ANY issues with it, please send an email to
webmaster@campbell-tx.net.  We  will make every effort to respond to and
resolve issues raised. 

