* *** DATESORT_OVERVIEW TXT - 17 Dec 2024  17:25:47 - JGKNAUTH

DATESORT
--------
   |
   | +++++++++++++++++++++++++++++++++++++++++++++++
   | |infile:   WakeBOE_TOC.htm (aka "WakeBOE_TOC")|
   | |outfile:  DateSort.htm                       |
   | +++++++++++++++++++++++++++++++++++++++++++++++
   |
   |
   |<=====> DATESORT_MATCH
   |        --------------
   |           |
   |           | +++++++++++++++++++++++++++++++++++++++++++++++
   |           | |infile:   WakeBOE_TOC.htm (aka "WakeBOE_TOC")|
   |           | |             (manually created report)       |
   |           | |(----):   Windows WakeBOE directory          |
   |           | |             (accessed via DOS DIR)          |
   |           | |outfile:  DateSort_Match.htm                 |
   |           | |dirfile:  DateSort_DIR.txt                   |
   |           | +++++++++++++++++++++++++++++++++++++++++++++++
   |           |
   |           |Compares WakeBOE directory with "WakeBOE_TOC" and
   |           |creates "Match Check" report (DateSort_Match.htm)
   |           |
   |           |   * Lists files in one source but not in the other.
   |           |     Just fileids are used in the compare.
   |           |
   |           |   * A hardcode change to a variable would enable also
   |           |     using change dates for the compare, but this is
   |           |     unreliable, particularly for older files.
   |           |
   |           |Creates a report (DateSort_DIR.txt) listing most of the
   |           |DIR output for the WakeBOE directory.
   |           |
   |           |   *  Only a few lines are removed from the DIR output.
   |           |      DATESORT_DELTA will then use only the top few
   |           |      lines from DateSort_DIR.txt.
   |           |exit
   |
   |
   |Creates DateSort.htm ("Changed Files" report)
   |
   |   * Lists the descending sort by last-changed date
   |        of WakeBOE_TOC.htm files.
   |
   |   * Does much error checking of WakeBOE_TOC.htm.
   |
   |   * Only latest-changed files are included.
   |        Cutoff date is a DATESORT parameter (default is 2023).
   |        A separation line at a specific date (default is 11/5/24)
   |        separates the most recently changed files from the rest.
   |
   |   * Inserts gaps in reported list when date highlighting changes.
   |
   |
   |<=====> DATESORT_DELTA
   |        --------------
   |           |
   |           | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   |           | |changed_files:  DateSort.htm ("Changed Files") from DATESORT     |
   |           | |descriptions:   DateSort_Recent_Changes.htm ("Recent Changes")   |
   |           | |                   (manually created report)                     |
   |           | |dirfile:        DateSort_DIR.txt created by DATESORT_MATCH       |
   |           | |delta_file:     DateSort_Delta.htm ("File Change Summary" report)|
   |           | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   |           |
   |           |Compares "Changed Files" report with "Recent Changes" report.
   |           |
   |           |   * Changed Files" is a report that has a sorted-by-date list
   |           |     of the most recently changed files.  There is a special
   |           |     separation line above which are the files whose changes
   |           |     are described in "Recent Changes".
   |           |
   |           |   * "Recent Changes" is a manually created report which has
   |           |     descriptions of recent changes to (mostly) WakeBOE files.
   |           |
   |           |Creates a "File Change Summary" report (DateSort_Delta.htm).
   |           |
   |           |   * Notes mismatches between the "Changed Files" report
   |           |     and the "Recent Changes" report -- files in one
   |           |     report, but not the other.
   |           |
   |           |   * Notes any files with changes made to the same file on
   |           |     multiple dates.
   |           |
   |           |   * Lists the 9 most-recently-changed files in the WakeBOE
   |           |     directory; not all need be in "WakeBOE_TOC".
   |           |
   |           |Invokes Firefox to display the  "File Change Summary" report.
   |           |
   |           |exit
   |exit