Document CheckDate Documentation

                 CheckDate Documentation
                ~~~~~~~~~~~~~~~~~~~~~~~~~

         Version 1.20  İ'95 SiliconSurfer/Phantasm

             Another PHANTASM FREEWARE program



0. Short Description
====================

Checkdate examines the dates of all files in any .LZX, .LHA or .LZH archive.
The newest and oldest dates are output together with their filenames and
the name of the archive. The output can be redirected into a file for later
analysis.
Checkdate is useful for sysops who like to fake old stuff, or for traders,
who wants to know the real age of an archive.


1. Syntax & Output
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ

The AmigaDOS commandline options:

CheckDate FILE/A,FIRST/K/N,LAST/K/N,CHECK/K,ALL/S


You can use AmigaDOS wildcards within the filename.



1.1. The options
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ

FILE <archive>

	The name of the archive to examine. Works with AmigaDOS wildcards.
	Example: (#?.lzx|#?.lha|#?.lzh)


FIRST <n>

	The oldest n files are output with date and name.
	If these files belong to the newest ones yet, they are not output
        a second time.
	Default is 0.


LAST <n>

	The newest n files are output with date and name.
	Default is 3.


CHECK <date>

	The date of the newest file will be compared with the given date.
	If the file is older then <date> the returncode will be set to
        RETURN_WARN (=5) and the text "puuuuhhhh... this stuff is too old !"
        will be output.
        Else the returncode will be set to RETURN_OK (=0).

	The format of <date> is the local format.
	German format:   DD-MON-YY or "DD-MON-YY HH:MM:SS"
	German example:  03-Feb-94 or "03-Feb-94 16:08:53"


ALL

	If wildcards are used within the name of the archive, Checkdate
        works recursive, means all subdirectories are searched for the
        pattern, too.
	Example: "CheckDate (#?.lzx|#?.lzh|#?.lha) df0: ALL" searches whole
	df0: for files with the ending .lzx, .lzh and .lha and processes them.




1.2. An example
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ

e.g.: CheckDate abc.lha FIRST 3 LAST 3

The output looks like this:


CheckDate V1.20 (Feb 28 1995)  İ'95 by SiliconSurfer/Phantasm

---------  abc.lha [21-Apr-94] ---------
-NEWEST -
29-Mar-94  x1
22-Mar-94  x1.info
22-Mar-94  Callx1
-OLDEST -
28-Mar-93  1.dat
25-Jul-93  2.dat
19-Sep-93  3.dat


The first 3 filenames are the 3 with the newest date.
Below them you see the 3 oldest files in that archive.



2. How Checkdate works
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
LHA resp. LZX are called, with output redirection to T:chkdate.
Thereafter T:chkdate will be processed and deleted.
The processing of FILE_ID.DIZ will be skipped (for purpose).

The call of LHA looks like this: LHA >T:chkdate v "archive"
The call of LZX looks like this: LZX >T:chkdate l "archive"



3. Last words
ŻŻŻŻŻŻŻŻŻŻŻŻŻ
This whole archive is absolutely FREEWARE. You can do anything you want
with it.

This program has been tested by several people.



Voice:    +49-40-7216995 (Germany)
Email:    SILICONSURFER@Blackbox.shnet.org
          SILICONSURFER@Dame.shnet.org

Address:
          Tim Ruehsen
          Joh.-Rabe-Stieg 8
          21033 Hamburg
          GERMANY


Please send me email, if you use this program !


FF - Fiel Fun.