FAGE.EXE : File_Age Date: Mar 05 1991
========================================

INTRODUCTION:
=============

FAGE.EXE is an extension of the program SINCE.EXE.

I would like to acknowledge the original AUTHOR of SINCE.EXE,
on whose program FAGE.EXE is based.

The main addition is the JULIAN DATE processing that allows
DATE ARITHMATIC to be performed.

Conversion too and from JULIAN DATES are performed using a
JULIAN DATE STRUCTURE, a pointer to which is passed to either of
the two conversion functions. (ie JULIAN_to_DATE or DATE_to_JULIAN).


OPERATION:
==========

FAGE has two modes:

(a) FAGE mm dd yy (ie 3 parameters ... Similar to SINCE.EXE)

Will display all files created on or AFTER that date.
Will also display the AGE of those files.
AGE= ("Todays date" - "File Date") in DAYS

(b) FAGE day_offset (ie 1 parameter)

(1) If day_offset is POSITIVE or ZERO

Will display all files created AFTER (or ON) "Todays date" - day_offset
Will also display the AGE of those files.

(2) If day_offset is NEGATIVE

Will display all files created BEFORE "Todays date" - abs(day_offset)
Will also display the AGE of those files.


Example: FAGE 10 = All files created AFTER 10 days ago.
(ie. Files created within last 10 days.)

FAGE -365 = All files created BEFORE 365 days ago.
(ie. Files older than 365 days.)

ie : magnitude of parameter = how long ago in days
sign of parameter = ( + = AFTER ) ( - = BEFORE )

Note: A File with a "NEGATIVE" AGE is one with a FILE DATE "LATER"
than todays date (todays date = DOS date !!!!!)

SORTING FILTER:
===============

The output format has been designed so that you can use the SORT filter
to sort on either:
(a) FILENAME
(b) File AGE ... then FILENAME

The HEADER of Today's Date etc will ALWAYS come at the top of the SORTED
output if the following SORT options are used.

(a) FILENAME
FAGE {parameter(s)} | SORT /+13 {> outfile}

(b) File AGE..then FILENAME

FAGE {parameter(s)} | SORT /+24 {> outfile}

=================================================================
Geoff Drayson. BALTIMORE MD.
=================================================================