home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / mayflower.lha / MayFlower / CmpDate / CmpDate.doc < prev    next >
Text File  |  1994-05-04  |  4KB  |  97 lines
  1.          --- ---
  2.          (o) (o)        CmpDate 2.0 (19940304)
  3.             ^
  4.          \_____/        by Stephen D Childers
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7. Program Description:
  8.  
  9.    1) This program is designed to work within script files, and is used
  10.       to compare the dates of files and dirs, and will return WARN if the
  11.       dates exceed a certain test condition; test conditions are set by
  12.       user options.
  13.  
  14.       Program is basically a programmer's tool, for an example of usage
  15.       then see file 'create' which is within CapsLock program directory.
  16.  
  17.    2) It can only be run from CLI. Can be made resident.
  18.  
  19.    3) Program (when run from CLI) will interact with the 'c:Why' command
  20.       after program failures; this command may provide a more detailed
  21.       explanation of why the program failed.
  22.  
  23.       The 'Why' command should be used immediately after a program
  24.       failure to extract the last program's result code, because
  25.       that result code is changed upon the execution of the next CLI
  26.       command.
  27.  
  28.    4) Certain error reports will contain the name of the arg, file,
  29.       device, (etc) that is associated with failure when it occurs.
  30.  
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32. CLI Usage:
  33.  
  34.    Usage > CmpDate [!|?] [[-option] mainarg arg1 ... argn]
  35.  
  36.       ! = show author info
  37.  
  38.       option: -n = if mainarg newer than arg1... then return( result )
  39.               -o = if mainarg older than arg1... then return( result )
  40.               -r = perform sub-directory recursion with arg1 ... argn
  41.               -w = return result WARN
  42.               -e = return result ERROR
  43.               -f = return result FAIL
  44.  
  45.       mainarg     = file or directory
  46.       arg1 - argn = files or directories
  47.  
  48.       default options = ow
  49.  
  50.    1) The mainarg can be a file or directory. And if a directory then
  51.       only the date of directory will be used for comparison and not the
  52.       date of directory contents.
  53.  
  54.    2) The arg1 through argn can designate files or directories.
  55.       If directories are designated then the date of files and directories
  56.       within arg1...argn will be compared to mainarg.
  57.  
  58.       Using option -r (recursion mode) will cause files within all
  59.       sub-directories to be compared, and only the file dates will be
  60.       compared, and the date of all sub-directories will be ignored.
  61.  
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  63. Version History:
  64.  
  65.    The following information briefly describes changes or improvements
  66.    made to each version, and they will be described in descending order;
  67.    meaning latest version information begins first:
  68.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  69.    Version 2.0 (19940304) -
  70.    1) Changed version numbering format. Program can now be used with the
  71.       "Version" command. Date within parenthesis is shown in a somewhat
  72.       international format as (yyyymmdd).
  73.    2) Added option -r
  74.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  75.    Version 19930728 - The first version.
  76.  
  77. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  78.       _   _   _   _   _   _   _   _   _   _   _   _   _   _   _   _
  79.     _( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_
  80.   _( )+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+( )_
  81.  (_)+(_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_)+(_)
  82.   _(_)                                                             (_)_
  83.  (_)_     6   And the Lord said, Hear what the unjust judge saith.  _(_)
  84.   _(_)    7   And shall not God avenge his own elect, which cry    (_)_
  85.  (_)_   day and night unto him, though he bear long with them?      _(_)
  86.   _(_)    8   I tell you that he will avenge them speedily.        (_)_
  87.  (_)_   Nevertheless when the Son of man cometh, shall he find      _(_)
  88.   _(_)  faith on the earth?                                        (_)_
  89.  (_)_                         The Holy King James, Luke 18:6-8      _(_)
  90.   _( )_   _   _   _   _   _   _   _   _   _   _   _   _   _   _   _( )_
  91.  (_)+( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )_( )+(_)
  92.    (_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)+(_)
  93.      (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_) (_)
  94.  
  95. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  96.                            End Of Document
  97.