* *** DATESORT_OVERVIEW TXT - 11 Feb 2025  13:22:10 - 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 by call to DOS DIR)   |
   |           | |outfile:    DateSort_DIR_vs_TOC.htm            |
   |           | |dirfile:    DateSort_DIR.txt                   |
   |           | |dupesfile:  DateSort_Dupes.txt                 |
   |           | +++++++++++++++++++++++++++++++++++++++++++++++++
   |           |
   |           |Compares WakeBOE directory with WakeBOE_TOC.htm and
   |           |creates DateSort_DIR_vs_TOC.htm report.
   |           |
   |           |   * Lists files in one source but not in the other.
   |           |     Only fileids are used in the compare.  Collects
   |           |     duplicate fileids (all but first) in dupesfile.
   |           |
   |           |   * Does error checking of WakeBOE_TOC.htm file entries:
   |           |     change-date format, change-date mismatch for
   |           |     same fileids, and valid class.
   |           |
   |           |   * Lists the 9 most-recently-changed files in the WakeBOE
   |           |     directory; not all need be in "WakeBOE_TOC".
   |           |
   |           |Creates a DateSort_DIR.txt report 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_Changed_Files.htm ("Changed Files" report)
   |
   |   * Lists the descending sort by last-changed date
   |        of WakeBOE_TOC.htm files.
   |
   |   * Does more 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_Changed_Files.htm from DATESORT             |
   |           | |descriptions:   DateSort_Descriptions.htm ("Descriptions of Changes")|
   |           | |                   (manually created report)                         |
   |           | |dirfile:        DateSort_DIR.txt created by DATESORT_MATCH           |
   |           | |delta_file:     DateSort_Desc_vs_TOC.htm report                      |
   |           | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   |           |
   |           |Compares "Changed Files" report with "Descriptions of 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 "Descriptions of Changes".
   |           |
   |           |   * "Descriptions of Changes" is a manually created report which has
   |           |     descriptions of recent changes to (mostly) WakeBOE files.
   |           |
   |           |Creates a DateSort_Desc_vs_TOC.htm report.
   |           |
   |           |   * Notes mismatches between the "Changed Files" report
   |           |     and the "Descriptions of Changes" report -- files in one
   |           |     report, but not the other.
   |           |
   |           |   * Notes any files with changes made to the same file on
   |           |     multiple dates.
   |           |
   |           |Invokes Firefox to display the DateSort_Desc_vs_TOC.htm report.
   |           |
   |           |exit
   |exit