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

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

Thank you for downloading Walk v1.0 for Linux! 

Walk  "walks  down"  a  directory hierarchy, starting with the directory
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" on x86 based computers. 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 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
support@campbellware.com.  We  will  make every effort to respond to and
resolve issues raised. 

