Program: CHUNT.EXE
Version: Version 1.0
Date: October 1988

Copyright(c) 1988 by John Crouch


Syntax:

CHUNT [d:] string


Where d: is an optional drive letter and 'string' is the string of
characters within a file name.



INTRODUCTION

CHUNT will search and find a file anywhere on the disk, which
contains the string specified. To specify the file to find, the
program accepts a string on the command line. This is a string of
characters which can be anywhere in the file name.

There are many programs available that seem to perform this same
task. But this program is unique from other programs that find files
on the disk, because other programs use the file specification
exactly like DOS.

For example, if you give the DOS command

"DIR *DAY*.*"

DOS would give you all files just as if you had given it the command

"DIR *.*"

This is not what you may desire in some situations. With this HUNT
program you can give the command

"CHUNT DAY"

and the program will show you any file on the disk with the
characters "DAY" anywhere in its name.






CHUNT.EXE - Version 1.0 by John Crouch



Example:

Display any file on disk C: with the characters "COMM" in the
file name.


CHUNT C: COMM


CHUNT - Find a File on the Disk, Version 1.0
Copyright (c) 1988 by John Crouch

Searching for all files with "COMM" in the name on drive C:

C:\
command.com 25,308 12:00am Tue Feb 2 88

C:\COMM\PC3
command.pc3 67,726 1:46pm Sat Apr 16 88

C:\MASM
tsrcomm.asm 63,146 6:28pm Mon Jan 4 88
tsrcomm.com 6,202 6:30pm Mon Jan 4 88

C:\TURBOC\TEST
tccomm.arc 45,056 1:16pm Fri Oct 9 87

5 matching files found.


You can see in this example that if you knew you had a file with the
letters COMM in the file name but could not remember exactly what the
file name is, this program would help you find the file on the disk.
With other file finding programs you would be tempted to give it the
file specification "*COMM*.*". This would not work, they would give
you every file name on the disk.


CHUNT will return an ERRORLEVEL for batch file operation, which
represents the number of matching files found. If an error occurs in
the execution of the program it will return an ERRORLEVEL of 255, the
maximum ERRORLEVEL available from DOS. So, if there are more than
254 matching files found, CHUNT will still return 254, since 255
would be an error value.

Pressing any key while the program is running will cause the screen
display to pause. Press another key to resume the display.








CHUNT.EXE - Version 1.0 by John Crouch



THE SHAREWARE CONCEPT

This program is being distributed under the shareware concept. There
are many advantages to using this method of distribution, some of
which are:

o People can try programs before paying for them to
determine if they are useful to their needs.

o Software authors can be supported directly by the
users, which keeps software costs down.


You are granted the right to use this program for a trial period of
thirty (30) days, at which time you must either stop using the
program, or pay the registration fee. You can register your copy for
$10 and receive the latest version.



WARRANTY

THE AUTHOR MAKES NO WARRANTY OF ANY KIND, WHETHER WRITTEN, ORAL OR
IMPLIED, INCLUDING WITHOUT LIMITATION THE WARRANTIES OF FITNESS FOR A
PARTICULAR PURPOSE OR OF MERCHANTABILITY. IN NO EVENT SHALL THE
AUTHOR BE LIABLE FOR SPECIAL OR CONSEQUENTIAL DAMAGES FROM THE USE OF
THIS PROGRAM, EITHER IN BINARY OR SOURCE FORM. THE USE OF THIS
PROGRAM CONSTITUTES ACCEPTANCE OF THE TERMS AND CONDITIONS OF THIS
AGREEMENT. IF YOU DO NOT AGREE TO THESE TERMS, PLEASE DON'T USE THIS
PROGRAM.


TECHNICAL INFORMATION

This program was written and compiled with Borland's TurboC, Version
2.0. Many specific functions were created in C and Assembly
language. The Norton Editor was used for most of the program
editing.






CHUNT.EXE - Version 1.0 by John Crouch



SUPPORT

You can reach the author for questions or comments at one of the
following locations:



John Crouch
P.O. Box 1521
Frederick, Maryland 21701


CompuServe EasyPlex Mail The New Micro Connection BBS
71310,2612 (301) 698-0212





OTHER CROUCH SOFTWARE PROGRAMS


CFA - The Crouch File Attribute Program (CFA) is a "point and shoot"
type program to allow you to change the attributes, the date, and the
time of files on your disk. Some of CFA's features include mouse
support, global file marking and changing, disk and directory
changing, and online help. CFA can be run as either a command line
program (for use with batch files), or in full screen mode.
Distributed as shareware. Source code is available.


BKCK - Backup Check. Reports the backup status of the files on your
hard disk. BKCK will help you determine if it is time to do a backup
of your disk. BKCK has several report formats to display your files
which need backing up. A MUST for anyone with a hard disk that does
backups.


HELP - DOS help program. A full screen help program designed to help
anyone from the beginner to the advanced DOS user. Some of HELP's
featured include command line context sensitive help, which can bring
up the help screen you need in a flash, and mouse support. HELP is
NOT a memory resident program.


CFREE - Free Disk Space Checker. This program will report the free
space available on your disks. Several disks can be checked at one
time by including their drive letters on the command line. Perfect
for SYSOPs and people with several disks. Nice to check a physical
disk which is partitioned into several logical disks. Shareware.





CHUNT.EXE - Version 1.0 by John Crouch



REGISTRATION FORM

CHUNT - Version 1.0



Name _____________________________________________________

Company _____________________________________________________

Street _____________________________________________________

_____________________________________________________

City ______________________ State ______ Zip ___________



I got CHUNT from ___________________________________________

Comments: __________________________________________________

_____________________________________________________________



Qty Type Fee


____ CHUNT Program @ $10 __________




Mail checks to:

John Crouch
P.O. Box 1521
Frederick, Maryland 21701