05/15/93                      TOUCH.EXE


TOUCH is a small file utility that alters the  date and/or time stamp
of files.  The core function of this utility, SETFDATI() from Clipper 
Tools , sets the date and/or time stamp of a file.

Syntax for this utility is:
  TOUCH [ <//info> | <//?> ] | <file spec> [ <option list> ]

If '//info' is entered rather than a 'file spec', the Clipper information
data is displayed along with the some information about TOUCH.

The 'file spec' may be the name of a single file or a group of files using
the '?' and '*' wild card characters.  If no options are given, TOUCH will
list the selected files with their date and time attributes

Options may be entered in upper or lowercase, and must be prefaced with either
a slash (/) or dash (-) character. Options may be specified in any order and
must be separated by a space.

Some options have arguements.  If an option has an arguement, it is specified
after the option, and no space is allowed between the option and its argue-
ment.

TOUCH Options
~~~~~~~~~~~~~
  /h    Syntax Help display.

  /d    Alter the date stamp
           /d[<date>]
           Date is entered in a mm/dd/yy format.
           If no arguement is attached to the option, 
           the current system date is assumed.

  /t    Alter the time stamp
           /t[<time>]
           Time is entered in a hh:mm:ss format.
           If no arguement is attached to the option,
           the current system time is assumed.

  /n    Stamp Now
           The date and time stamp is changed to the current
           system date and time.  This option overrides the
           /d and /t options.


  /v    Verbose output
           Displays the name, date, and time of the files before and
           after stamping in the format <old file> => <new file>.  
           The word 'Unchanged' will be displayed if the -d or -t options 
           are entered incorrectly.


All output may be redirected to a file or printer using the standard
DOS redirection symbols '>' or '>>'

A DOS errorlevel code equal to the number of unchanged files ( max 255 ),
or 0 if all were changed, is returned for used by batch files, make files,
etc.  See the sample file, TOUCHERR.BAT

As mentioned above, this utility requires the Clipper Tools Library.

TOUCH may be built using either Blinker 2.0 or RTLink via the makefile
'touch.rmk'.  Blinker is the default linker. See the RMK files for details.



Hopefully, you may find this utility of use.
  D.B. McDonald  (Bruce)  [ CIS 76334,3521 ]


