Contents of the PRUNE.DOC file
PRUNE.EXE Version 1.6 - by Ben Perkins
This program is designed to simplify the process of deleting subdirectories
from any type of disk, hard or floppy. Rather than being forced to manually
delete all files in a directory and then remove the directory itself,
you can prune the desired directory one step.
The process by which PRUNE.EXE is invoked is very simple. You simply type the
name PRUNE with the following command line parameters as follows:
'Directory_name' is a required parameter. If a valid directory specification
is not entered as the first command line parameter, the program will halt
with an error message. The '/option' parameter is optional. Allowed
parameters are as follows:
s : Delete the specified directory as well as all files and subdirectories
l : Acts in the same manner as the 's' option, but lists each directory
as it is deleted.
If PRUNE is called without options and subdirectories are found in the
specified directory, the program will halt with a message to that effect.
The parameter directory_name may be entered in any format that would be
acceptable to the DOS copy command. Thus, a complete directory path can be
specified (e.g. C:\GAMES\CHESS), or a single directory name can be specified
so long as the current directory is its parent (e.g. From the directory
C:\GAMES, you could just say "PRUNE CHESS").
Prune can also be used with a drive designation. Thus, while in the Games
directory of your C: drive as described above, you could PRUNE a directory
from the floppy in drive A using the following format:
Once again, directory_name may be a full path (e.g. a:\homework\papers) or
it may be a single name (e.g. papers) which will be looked for as a child of
whatever directory is current on the specified drive.
In situations where PRUNE.EXE is forced to terminate abnormally, it prints
error messages and returns the reason for failure through the DOS
ERRORLEVEL variable which can be accessed by batch file drivers.
ERRORLEVEL RETURN CODES:
Success ERRORLEVEL = 0
Bad Parameter ERRORLEVEL = 11
Attempt to delete current directory ERRORLEVEL = 16
Non-existent directory specified ERRORLEVEL = 3
Subdirectories detected * ERRORLEVEL = 5
* Returned only when PRUNE is called without the "/s" or "/l" parameter
PRUNE.EXE 1.6 has been contributed to the PUBLIC DOMAIN. It may be used and
shared freely, so long as no charge is applied to its distribution. It was
written in Turbo Pascal 5.5 to serve the needs of its author. It was designed
to be failsafe and more versatile than other utilities of its kind.
Should you find this utility useful, congratulate yourself on having used your
download or copying time well. If you don't, you are guaranteed a full refund
of the purchase price. Any bugs or suggestions can be brought to the attention
of the author on the KRYSTAL PALACE BBS (504-766-4330) under the name