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

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

Thank you for downloading Walk v1.0 for MS-DOS.

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
attributes to clean ups of build directories, etc. 

Walk  v1.0 for MS-DOS is patterned after the iRMX86 Human Interface walk
command  created  by  CampbellWare  in 1983. Linux and Mac OS X Terminal
versions  of  Walk  are  also  available  at  the campbellware web site,
www.campbellware.com. 

Walk  is  open  source  freeware, and is released under the terms of the
GNU Public License, v2. 

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.0a
directory  that  is  created  and  copy  the  file  "walk386.exe" to any
convenient  location on your PATH executable search path. Thats it - you
are  ready  to  use  Walk!  Simply  type  "walk386"  and you are off and
running.  If  you  prefer,  it  may  be  useful to rename walk386.exe to
walk.exe for simplicity of use. 

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 . "DOS command to execute"

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

   walk start_dir "DOS command to execute"

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

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

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

Some examples:

- walk . dir
- walk photos "attrib -a *.jpg"
- walk my_dir -v "del *.o"

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

The  source  for  Walk  v1.0  is  included.  It  may  be  found  in  the
walk-1.0a\src  folder  created  as  part  of  unpacking the tarball. Two
makefiles,  makefile  and  make386.bat,  are provided to build walk. Run
the  make  command  first,  then run the make386.bat file. Walk is built
using  the  DJGPP  C  compiler  and toolset for DOS. You must previously
install  this  compiler  and  its  environment  on  your  machine before
building walk. 

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

Walk  has  been  tested  on  MS-DOS 6.22, and on a DOS box running under
Windows  for Workgroups 3.11, both running on an Intel 486 DX4/100 based
PC.  The  Linux and Mac OS X versions, which share 99% of the same code,
have  been extensively verified on a variety of x86 Linux distributions,
and on Mac OX X 10.4.x running on a 2.3 GHz dual CPU PowerMac G5. 

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

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

