Documentation for TOUCH!, TOUCH! for Windows and TOUCH! for Windows NT/95

A touch program allows you to set the date and time of a file on a disk
to any date and time you desire. This has many benefits, such as setting
the time of files to a version number like Microsoft does, or for adjusting
all files to the same time so compilers and other software that checks
file creation/update times beleive all files are current.

These utilities, like many utilities, were written out of frustration.
However, as with all of my work, I am in endless pursuit of perfection
and bug-free code. Trying to develop for 3 different but equally important
operating systems is challenging, and while I have made every attempt to
fully test each version in its domain, I cannot guarantee this software to
perform as expected. You must use this software at your own risk. Please
report any suggestions you may have or any bugs you encounter to me at
the Internet address below. Thanks! and enjoy.


TOUCH! (TOUCH.EXE) is a MS-DOS program.

TOUCH! for Windows (WINTCH16.EXE) is a 16-bit Windows Program.

TOUCH! for Windows NT/95 is a 32-bit Windows Program for Windows NT and
Windows 95.

WINTCH32.EXE has been tested on Windows NT 3.5. Using it on Windows 95
may cause bad file times to be saved. This is the case as of BETA 2 of
Windows 95. This has been reported to Microsoft as a bug, and is NOT
a bug in WINTCH32.EXE. If you experience these results when running on
Windows 95, use either the 16 bit TOUCH! for Windows or the DOS version.
If this behaviour is exhibited in the final release version of Windows 95,
WINTCH32.EXE will be modified to compensate for this.

***** TOUCH! for DOS *****
For the DOS version of TOUCH, simply enter the date, time and file
specification to include in the touch. The date must be in the MMDDYY
format and the time in the HHMMSS format. Both must be 6 characters in
length. Keep in mind that most file systems DO NOT allow odd numbered
seconds in a file time, so if you enter one, it will be rounded down to
the nearest even second.

The file specification can contain wildcards. You can entered paths in
relative or absolute mode. If no path is specified, the current path
will be used.

You may specify /NOERROR as the last parameter to suppress error messages.


***** TOUCH! for Windows and TOUCH! for Windows NT/95 *****
Both of these versions have a user interface (dialog box) as well as the
same command line options as TOUCH! for DOS. The user interface can
assist you with file selection and has inputs for the date and time to use.
The defaults are the current directory and date and time.


***** ABOUT *****
TOUCH!, TOUCH! for Windows and TOUCH! for Windows NT/95 are copyright
1994 by HSC Software Developers. They are in the public domain and may
be copied and distributed freely.

All are coded by Todd Osborne in Microsoft C. I can be reached via email
at Internet address: toddos@aol.com (America Online)

Please let me know of any additions you would like to see, or any bugs
you encounter while using this program. C++ Source code is available upon
request.


***** SPECIAL THANKS *****
Special thanks go out to PDG Soft at America Online. Your testing on
Windows NT and NTFS helped me to confirm my suspicion that bugs I was
chasing in my code were actually problems in Windows 95. THANKS! a bunch!

Thanks to several of the Microsoft support engineers on CompuServe. Your
timely response to low-level disk access functions for 3 different
platforms made this utility possible.

Thanks to the Microsoft Windows 95 Development Team (Chicago) for creating an
operating system that is wonderful for developers (despite the bugs in M7).
This truly is how a computer SHOULD work!


