    ******************************************************************************
       (C) Copyright 2003-2006 Curtis Systems Software P.C. All rights reserved.
                   (last update: 2006 Nov)
    ******************************************************************************
    CSSDIR Release notes:

GA_3.25 OS/2 and eComstation release
*****************************************************************

      * GA_ReleaseDate Nov 14, 2006

      * trial version refresh of command line cssdir. It also includes
        documentation and screen shots of the NEW easiest to use and most
        powerful version of cssdir, CSSDIR GUI!
        see cssdirMainManual for details.

GA_3.25 OS/2 and eComstation release and GA_1.03 Windows release
*****************************************************************

      * GA_ReleaseDate Aug  2, 2004

      * small enhancements and fixes to MAJOR GA_3.2 OS/2/eComStation release and
        MAJOR GA_1.02 Windows release (for more information on GA_3.2 and GA_1.02
        see below)

      * corrected a possible incorrect number given on found and totfound entries
        which are displayed when /Foo:1 or /Foo:2 is set.

      * on option /Lrzz2 added numbering of such entries as well, and the prefix
        to each such line is now 'zz>#'.

      * in Snapshot compare mode (/Sscm). Some adjustments made to /Lrto which
        also lists a new record when /Lrto1 or (/Lrto2) is active. The new line is
        'totalAddChgFileBytes='. This represents the total number of bytes
        needed to save new (or added) files and changed files when compared to
        the previous snapshot. This could be useful in deciding how much disk
        space one might need to capture all the altered files (uncompressed).
        NOTE: This does not include any EA bytes the altered files might have.

      * adjusted /$snapshotlist$/ in cssdir.cfg to list summary stats report
        as well.

      * added /$which$/ to cssdir.cfg, if you use this symbolic, immediately
        place filename or wildcard after /$which$/. i.e.
        cssdir /$which$/cssdir.exe

      * fixed a few small help details

      * added /Schml:, search max line length option, this allows user to
        lengthen, or shorten what is considered the max line length during a
        /Sch: operation. Before this option was added lines were considered too
        long if they exceeded 1024 chars, the initial default for /Schml: is set
        to 1500. The reason 1500 was chosen is because lines in snapshot files
        can have an options line that exceeds 1024 and not be unusual.

      * in OS/2 and eComStation version, when querying device info, if device
        is in use, CSSDIR will now give a warning via CSSDIR171, and continue,
        instead of aborting.

GA_3.2 OS/2 and eComstation release and first release GA_1.02 Windows
*****************************************************************

      * GA_ReleaseDate July 21, 2004

      * GA_1.02 Windows version tested on Windows NT with sp6, 2000, 2000 server,
        XP PRO

      * GA_3.2 OS/2 and eComStation tested on OS/2 Warp4 fp9, eComStation 1.03,
        eComStation 1.1.

      * for Windows users the rest of all the release notes are a don't care,
        (Unless you are also using the OS/2 version, then it may prove
        informative as to why some adjustments where made to the OS/2 version).
        This is the first release for Windows and there are no known outstanding
        issues at the time of this writing.

      * for current owners of OS/2 CSSDIR there is no additional charge.
        A new cssdir.key file is required and available by sending your existing
        cssdir.key file in via email to cssdirsupport@curtissystemssoftware.com

      * added new suboptions on /Lfa
        6 = show additional file attributes fields, currently in OS/2
          these are mostly not used, however they are placeholders for
          compatiability reasons between possible other platforms.
          And may prove very useful when comparing snapshots taken from either
          environment.
        7 = show full 32 bit file attribute word in 8 hexadecimal digits
        8 = 7+':'+6 above.
        Also in /Sscm, one can now exclude these additional attributes which
        are represented with 'tcoevlnp#':
        t = temporary file attribute,
        c = compressed file attribute,
        o = offline file attribute,
        e = encrypt file attribute,
        v = device file attribute,
        l = sparse file attribute
        n = not content indexed file attribute
        p = reParsePoint file attribute, and
        # = any other file attributes that is not from the set: adhrstcoevlnp.
        /Sscm mode /Lxxao: now allows new suboptions tcoevlnp#.

      * /Lxxao: added new suboption '*all' to have the 32 bit 8 hex digit
        attribute word and the coded representations used in the compare during
        /Sscm, This should only be used if both snapshots used in the comparison
        where created by the same cssdir platform version.

      * /Lfa4 is now 4 chars long instead of 3, Tx!z, where '!' mean attributes
        other than 'adhrs' where found for the listed file/dir entry

      * added /Lrzb which displays total(s) of files that contain unusual
        attributes from set tcoevlnp#

      * /Lxufao:           now allows new suboptions tcoevlnp#.

      * '/Lxlo:' by itself now will effectively shut off all display /Lf options.

      * /Pf1 now has a 8 hex attribute word and extended version of
        -adhrs---------- (-adhrstcoevlnp#-, tcoevlnp#, OS/2 currently
        does not use).

      * added /Pt4 which lists the beginning and ending wall time cssdir
        started and finished along with /Pt3 output. Sample new output follows:
        Pt> begTime:2004-06-08 06:53:08 Tue
        Pt> endTime:2004-06-08 06:53:08 Tue

      * added option /Deo (Directory Entry Only). This option gives the user a
        way to list the requested entry itself. This can be useful when all you
        wish to see is the '.' of a directory. /Deo1 or just '/Deo' means to list
        such an entry when it has the following syntax  dirx\.\ (appended '.\').
        /Deo2 means to list only the entry itself (no need to append '.\').
        See new option /Deo for more details.

      * added /Lfm2 to append '.\' on directories listed, useful with new /Deo

      * added option /Lxtl: LORA option which controls whether a top level '.' is
        to be shown (if available). /Lxtl:1 means to show them and is now
        the default. At most you will see (if any) one '.' at the top level of
        each dirspec request. To turn off use /Lxtl:0.

      * now allows 00 for both day and month in /Srd:, this
        allows user to find dates that may otherwise be filtered out,
        because former versions of cssdir did not consider the possibility,
        that the day and/or month may be invalid, (have 00 for day/month and/or
        out range day of month or greater than 12 for the month, etc). Also
        when specifying suboptions for /Srd: curmonth, curXmonth,
        a low range of 00 is used for day and a high range of 99. This
        allows cssdir to NOT filter out bogus days. Also a new suboption
        curyear is now allowed for /Srd: option.
        Examples /Srd:2004 translates to /Srd:2004-00-00:2004-99-99
        and if current month is July 2004
        /Srd:curmonth  translates to /Srd:2004-07-00:2004-07-99

      * added option /Mf2: (miscellaneous flag 2 option)
        /Mf2:1 is a don't care for the OS/2 version,
               (file time to local time conversion Error)
        /Mf2:2 don't bark about bad lastWritten timestamps on files detected
        /Mf2:3 include only files who have bad lastWritten timestamps
        /Mf2:4 don't restore a file accesstime timestamps during CRC calculations
        /Mf2:5 same as 4 but during /Sch: operations
        /Mf2:6 don't bark about wildcards character(s) in file/dir names detected
        /Mf2:7 don't bark about access denied on file/dir names
        /Mf2:8 don't abort on error getting fully qualified filenames
        /Mf2:6 and /Mf2:8 should be taken as potentially serious errors and that
        filesystem may be damaged or somebody may be creating filenames/dirs with
        unprintable characters.

        Tip: to find all files that have bad lastWritten timestamps for the
        bootdrive
        use: cssdir /$$bdrv$/:\ /s  /Mf2:3 or for all local drives
        use: cssdir /$$LcLDrvRoots$/ /s /Mf2:3

      * changed escape char from ~ to #, this was in preparation for other
        platforms that commonly use the ~ to represent a filename in a
        shorten form, this is likely to affect most former usage of '#' or '~'.
        Also '#' in /Lrtbeg: and /Lrtend: for a linefeed was changed to '!'.

      * added auto-generated symbolics:
        /$$BeginLibpath$/ /$$#BeginLibpath$/ and /$$##BeginLibpath$/
        also endlibpath which gives you access to current BeginLibpath
        and endLibPath settable environment-like variables. Also added
        symbolic of cssdir invocation dir, and escaptized version of it
        as well: /$$cssdirInvDir$/ and /$$#cssdirInvDir$/.
        Please note that /$$##beginLibpath$/ and /$$##endLibPath$/ are
        always defined even if beginLibpath and endLibPath do not exist,
        Whereas  /$$BeginLibPath$/ /$$#beginLibPath$/ (same applies to
        endLibpath) will not be defined if beginLibpath and endlibpath
        environment variable are not defined.

      * added escaptized version of environment vars in the form of
        /$$#envVar$/ this could be used to properly handle paths or filespecs
        that may contain characters that are a part of the path that have
        special meaning to cssdir, ';', '#', or '@'.

      * provide /$$.#path$/ symbolic which translates the path environment
        variable into escaptized version of Path with the current directory
        first, as well as all invalid paths and duplications removed. Great
        to use as a unix style power version of 'which'. i.e.
        cssdir /$$.#path$/ /Wc:xxxx  where xxxx is the file you are searching for.
        Also see new symbolic definition in cssdir.cfg /$searchPath$/.

      * added /Lfh8 to lengthen default space allocated for short hand code, this
        was needed for large number of requests to keep fixed format constant,
        especially for taking snapshots and comparing them with /Sscm.

      * added /Eop which lists '***EndOfProgram***' at the end of cssdir
        completion.

      * /$snapshotlist$/ and /$ssl$/ in default cssdir.cfg has
        had a number of adjustments, /Xr1: and /Xr2: are not included by
        default any longer, /Lfh setting was set to /Lfh8, and /Lrdi6 was added.

      * /Sscm /Lfh1 is equal to the expanded version of SHC of 4 characters now.

      * added option /Yme to find literally '?' files that can appear on windows
        machines! Also added /Lfy option which can work with /Yme option to append
        a trailing '.' on '?' entries.

      * added CSSDIR146 abort or warning error on obtaining fully qualified
        filename, see /Mf2:8

      * added CSSDIR147: ErrorReadingFile during snapshot compare

      * added warning CSSDIR165 that wildcard characters were detected in a
        filename, you may turn that off via option /Mf2:, but those types of
        files are supposed to be illegal in Windows, OS/2 and eComStation file
        systems ... and will break some other standard utilities

      * added warning CSSDIR170 that an entry was detected that returned access
        denied error, you may turn that off via option /Mf2:

      * added warning CSSDIR171: warning or error getting info for Drive:
        (drive disconnected?) continuing

      * added warning CSSDIR172: /Sscm warnings nothing to compare in ssfile
        or branch was not found

      * added suboption /Yme/ to be use to exclude '?' mark entries to /Xr1: and
        /Xr2:

      * fixed warning about getting errors on trying to restore
        a fileaccess time during CRC calculations or /Sch: on a remote
        JFS partitions and while computing crcs on a cdrom.

      * Lfm in /Sscm mode is smarter to not add additional '\', however /Lfm0
        will not remove already appended '\' or '.\'

      * better warnings and controls were added during /Sscm when no branch was
        found or a snapshot compare file was empty (options /Crlp: and /Crls:),
        etc. Also see /Sscm /Lxmf: new suboptions 23456 to ignore date/time on
        dir2dir, dir2file and other warnings when no branches found during /Sscm.
        Now /Sscm can be used with a provided 'ssDummy' dummy file or a file that
        basically has no entries found in one or both input files /Sspf: /Ssnf:
        without ending in error. The use of a dummy snapshot compare file
        'ssDummy' could be useful for reformatting the data contained within the
        other specified snapshot file including expanding relative filenames to
        full absolute filenames. Use ssDummy with /Sspf: or /Ssnf:.

      * added /Lxmf: options 2,3,4,5,6 in /Sscm, options 2 and 3 give finer
        control over date compares. Option 4: turns off warnings that are NOW
        enabled by default when /Crlp: and /Crls: requests are not found. Option
        5 gives finer control over eaSize and eaCrc compares on dir2dir compares.
        Option 6 gives finer control over eaSize and eaCrc compares on file2file
        compares.

      * a few warning/error messages now have more details
      * added a few more suboptions to /Soo:
      * fixed certain error messages during /Ce that were out of order.

      * fixed issue when a non sorted listing with /Dumpo:a which was not
        being updated appropriately with conditional created symbolics
        /$$lcldrvs$/, /$$lcldrvRoots$/, etc.

      * fixed potential dirspecs that are passed in that exceed the maximum
        allowable size of 255 characters in length.

      * fixed small issue with a missing ';' on gt> lines on multiple reports

      * added /Wco for more flexibility when using /Wc: ... also now handle
        properly subDirectories to be used with /Wc: (great flexibility).
        i.e. cssdir basedir /Wc:subdir1\*.c;subdir2\*.c   MEANS
        cssdir basedir\subdir1\*.c basedir\subdir2\*.c

      * changed /Lrll0 to /Lrll1 in /Sscm to be new default

      * adjusted /Lrzz to handle the case of a top level directory that only
        has '.' remaining (not filtered out) to be counted, also clarified
        documentation when a root directory has no entries of any type
        including '.' and '..' entries matching user filter criteria,
        that /Lrzz will not count it, and /Lanf: with a non zero setting will
        flag the user with non qualified files found.

      * provide 3.1 snapshot file fixup to 3.2 snapshot file util ss31_32.cmd

      * changed cssrss.cmd to also cull /Pt generated lines on report

      * cssdir.cfg now supports '#include', which allows users to keep almost
        all the customizations in a separate file or file(s).

      * (OS/2 and eComStation only)
        cssdirm.cmd and shortcuts d.cmd and dm.cmd were adjusted for returning
        cssdir return code when possible.

      * filenames with leading spaces were mistakenly chopped of leading spaces,
        this should no longer occur.

      * (OS/2 and eComstation only)
        add cssdir /Util submode, usage follows:
        cssdir /Util /Sflw yyyy-mm-dd hh:mm:ss filename
        cssdir /Util /Sflw @listOfFiles2setLWdates
                     /Sflw = set a files last written date
        This util may be useful when one is unzipping a file that creates new
        directories with the current timestamp, when you really want them
        to be restored with the originally saved timestamp. You may gather
        that info with cssdir using cssdir /Lfd2 /Lft2 /Lff3 /Lxlo:dtf > savets.
        Next Edit the savets file and change basepath info. And then run
        cssdir /Util /Sflw @savets. Currently this is added as a convenience to
        the user with NO additional support.

GA_3.1 OS/2 release Apr 20, 2004
*****************************************************************

      * new option /Sscm, snapshot compare mode available currently at no charge
        to Pro license holders, see cssdirSS.txt and/or cssdirSS.htm for all
        the options available in this flexible snapshot comparisons mode.

      * also with regards to snapshot compare mode, rexx scripts ds.cmd and
        dsm.cmd were added for user shortcuts, and cssdirm.cmd was adjusted.
        see file shtCuts\readme.

      * to activate formerly introduced in version 3.01 d.cmd and dm.cmd, the
        user must see file shtCuts\readme.

      * fixed /Of: when no suboption is given that specifies how to open a file
        (A for append, O for overwrite or N for new), cssdir would automatically
        overwrite any specified existing file(s) that already existed.

      * fixed issue with request type listing (effectively active /Lxrst:1)
        when request directory name is listed but its date, time, attribute, and
        possibly easize are not really applicable and/or relevant to now be
        blanked out in those cases.

      * changed /Lrll heading title 'file specification' to 'file_specification'
      * /Lrll alignment corrections on some /Lfr and /Lfl suboptions
      * /Fcrc:, /Ecrc: and /Sch: Now do not cause a file's lastAccess time to be
        adjusted
      * in cssdir.cfg   added some new symbolics and adjusted /$snapshotlist$/

      * enhanced /Srd: to support +N and $, which can be used in such a way to
        find files that have bogus last-written file dates. See /Srd: option
        details.

GA_3.01 OS/2 GA release Mar 15, 2004
*****************************************************************

      * MAJOR release

      * removed '-' option invocation for all options except '-h' and '-hx'
        this allows very common dir usage of '/s /a /o' and should greatly help
        with long time dir users.

      * Allow the following / options to be run together (even in a global
        context) /a /b /f /o /s.

      * Added /Lxlo: This option allows the user the ultimate in field layout
        of the file fields. Should size come before easize? Should date come
        before time? Should attributes field be listed last .... Don't try this
        with regular dir... *** But with CSSDIR 3.x YOU DECIDE***

      * eliminated /Lxhp: because /Lxlo: is way more flexible

      * adjusted memory allocation issues with warp4 startup.

      * Changed name of cssdir.ini to cssdir.cfg and cssdirIni env var to
        cssdirCfg.

      * adjusted default cssdir listing settings, user can easily adjust in tandem
        with env var cssdirDefArgs or via cssdir.cfg /$cssdirDefArgs$/

      * moved /o*dups-asc and /o*dups-des to /Lxpo:
      * added /Lxpo:*off  --- causes no user ordering to occur, could save time
        when ordering is a don't care. Also when /Lxpo:*off is set, /Lxrst:1 is
        forced (reqType summary).

      * beautification of dir listings, and empty dirs ...
        streamlined bulky ***dirname: and ***request: heading and trailing labels
        on /Lrrs options to more useful info including listed directory parent or
        '.' entry, Which may include its date, time, attributes and potentially
        easize! Regular cmd.exe's dir does NOT handle the '.' entries information
        reliably (esp on HPFS drives), but cssdir DOES! This also handles the
        known issue listed in 2.03 relnotes with not listing the '.' info or so
        called empty directories referred too. Alignment of eabytes and sizes
        bytes are done whenever possible between summary line (/Lrrs) and detail
        lines. New heading line format, includes date/time attribute and sentinel
        ':>' for easy searching with editor, etc between directories. New trailing
        summary formats currently start with 's>' for subtotals '>t' for a single
        total, 'T>' for a total of subtotals! Final line when /Lrrs is non zero is
        always 'gt>' or 'GT>' if /Lrgt is non zero. Also after each total or
        subtotal cssdir is smart to give as much info as available or possible so
        that the 's>' line could stand on its own, even in many cases outside of
        that output. Handy with new utility cssrss (described below!). POWERFUL!!

      * on the above mention 'gt>' and 'GT>' lines now give free space and if
        any errors/warnings occurred, the number of such messages is listed,
        also added /Lrgt to control new 'gt>' and 'GT>' record display.

      * New utility cssrss.cmd to sort and sift /Lrrs2,3,4 output, Terrific way
        to find out which directories are huge!!! Usage follows:
        cssrss version 1.16 Copyright 2004 Curtis Systems Software P.C.
        usage: cssrss infile [-][E|D|F|Z|S|N] [ V]
        legend follows:
          infile is cssdir generated file
          E = order by num of   entries field (if avail)
          D = order by num of     Dirs  field
          F = order by num of     files field
          Z = order by eaSize     bytes field
          S = order by fileSize   bytes field (default)
          N = leave as found
          - preceding above option will reverse order
          also can append ' V' for verbose output

        cssrss also can handle multiple requests.

        Too use this utility rexx must be available and must have sysStemSort
        function available.

      * All key fields are commatized (thousands separator is ',') and set as
        such by default. User toggles or sets most key ones individually. Also
        see new option /Lxcs:, which commatizes in bulk almost all options
        beginning with /Lr.

      * Changed /a out of the box setting to include all attributes. (No more
        jumping through hoops by default as dir requires to find files).

      * Enhanced /Lfa option to include two new subfields on most settings.
        A leading character position and a trailing character position.
        The leading one lists 1 of 4 chars, representing its traversal attribute,
        a blank (normal traversal attribute), a capital 'H' meaning this
        entry was found because of the most immediate traversal ancestor that
        was hidden via its hidden file attribute was set (normal dir can NOT find
        these easily), capital 'S' is similar to 'H' but its ancestor system
        attribute was set, 'B' means both system and hidden attributes were set.
        The second additional subfield is the trailing one that is a codified
        representation of a files Ea size.
        concise EA size code legend follows:
        '-'(blank) = no EAs
         +=  1    to  1K (All ranges are endpoint are inclusive)
         1=  1k+1 to 10k
         2= 10k+1 to 20k
         3= 20k+1 to 30k
         4= 30k+1 to 40k
         5= 40k+1 to 50k
         6= 50k+1 to 65535
         #= 65536 or greater
        Also there is one streamlined option /Lfa5 that does NOT include and
        consume 2 chars, with the usually uneventful archive and readonly bits.
        k above = 1000 bytes.

      * /Dir: Dora suboptions now require explicit use of the leading '/Dir:'
        to use. Most users may never use these, but power users will!

      * Now symbolic definition codes can be continued on subsequent lines,
        see cssdir.cfg

      * OverHauled format of most options beginning with /Lr. During their
        display the last two letters of the option are displayed followed by a '>'
        at the beginning of each line they display ... for easy identification
        and lookup for altering or shutting option off.

      * /Lrdi option was greatly improved with much more information. You can NOW
        also get disk information on fat drives that have no files (can't do
        that with dir). Also see a bunch of convenient symbolic codes making use
        of these improvements, included in the new default cssdir.cfg.

      * added auto generated symbolic definitions:
        /$$AllDrvs$/    , /$$LclDrvs$/    , /$$RmtDrvs$/
        /$$AllDrvRoots$/, /$$LclDrvRoots$/, /$$RmtDrvRoots$/ for user convenience.
        Use of /$$AllDrvs$/ causes cssdir to scan for all available drives.
        Use of /$$LclDrvs$/ causes cssdir to scan for all drives that have the
        following filesystem types:FAT,HPFS,JFS,NTFS,FAT32 (local drives).
        /$$RmtDrvs$/ (remote drives) includes drives that do not include
        /$$LclDrvs$/, The ones above ending with Roots$/ are simply the root
        directorys of such drives.

      * added environment variable cssdirSkipDrvs and /$cssdirSkipDrvs$/ to have
        cssdir skip during the scanning for local and remote drives for
        /$$RmtDrvs$/ and /$$LclDrvs$/, this could be valuable to avoid delays
        and or errors or just drives you simply wish to ignore when using such
        convenience auto generated symbolic definitions.

      * defined convenience symbolic definitions which give users familiar dir
        like view of files listed in cssdir.cfg ... see /$loDir$/ and /$loDira$/
        As well as a number of other handy symbolics.

      * adjusted nagging less on unregistered cssdir
      * added way to flush /Dir:  with /=Dir:
      * added way to prepend on /Dir: with /-Dir:
      * added way to append to /Mf: with /+Mf:
      * changed suboptions on /Of: and /Pfof: from /Append /Overwrite etc to
        /A for append /O overwrite, /T for time, /N for new, but also added a
        way to have multiple list reports to separate files with /M. Also /Y
        to add timestamps to any subsequent additional files.
      * added new auto generated symbolic for day of year /$$DOY$/ (1-366)
      * add /Dumpo:2, a concise 2 line output of current options that are set.
      * /Lfa3 is now lists dir sytle attributes
      * added /Lfd4 =yyyymmdd  and /Lfd5 =/Lfd4 but drop yyyy if current year
      * added /Lrhe  to list total hidden/system entries count
      * added /Lfh7 similar to /Lfh6 but if 1 request don't show /Lfh SHC.

      * Added /Lfi - indentation operator for use with /Lxlo: handy for alignment
        especially when leading /Lrrs summary line including dirs / files don't
         line up because user turned off date and/or time fields and for other
        alignment issues ... because of the flexibility of the new /Lxlo: option.

      * added /Lfp - can list # of search hits (via /Sch:) with other file info!

      * Added /Lfq - space shim operator for use with /Lxlo: similiar to /Lfi but
        this has single space granularity whereas /Lfi is 4 space granularity.

      * added /Lfr options to allow ref number in a non decimal based code.

      * added new option /Lrms  to give a single record with total number of
        messages (warnings/errors) that occurred.

      * Added /Lrzz which lists the gives count of all the directories that their
        '.' entry matched and wasn't filtered out for any other reason. The zz
        stands for zero files and zero dirs were found for the directory (other
        than a '.' and/or '..'). /Lrzz2 means give totals and list all such dirs.

      * Added /Lxkt: -This option can set the point at which a commatization
        occurs, the default style of cssdir or one that closely resembles the one
        in dir (when the undocumented dir /v option is used).

      * added way to prepend on /List: with /-List:(don't forget any intended ';')
      * added way to append  on /List: with /+List:(don't forget any intended ';')

      * Added xh xs xhs xsh to /s option. By default /s option searches all
        appropriate paths even hidden and system ones! User can skip them with
        xh for skip hidden, xs for skip system, and xhs to skip hidden and system
        ones.

      * added way to prepend on /Xr1: and /Xr2: with /-Xr1: and /-Xr2:
      * added way to append  on /Xr1: and /Xr2: with /+Xr2: and /+Xr2:
      * add more verbose stuff try /Ve:9
      * added p to /o option to sort on total search hits per file!

      * added /Lrtr, which lists the number of dirs/files that occurred
        because of hidden and/or system directory bits were set and under normal
        dir would not have been traversed. /Lrtr2 lists the total dirs and total
        files and total entries.

      * added suboption on /List:/AT  which sets maximum output display of
        totals records (most records that start /Lr are such records)

      * added /00 option to shut off all normal output, this allows user
        to avoid having to figure out which option displays stuff they are not
        interested in being displayed.

      * added /BD for out of the Box defaults; And within the context of /List:
        its out of the Box Lora defaults (only)

      * added /Lxmf: this is a LORA miscellaneous flags option,
        see documentation for possible alteration of LORA defaults.

      * added suboption '*' on /Ve:* /Vn:* /Soo:*  which allows user to revert
        back to out of the box defaults for the previous mentioned 3 options.

      * enhanced option /a to allow option to use syntax that allows one or more
        matches of affected attributes ... i.e.  /a$s$h  means to match either
        system bit and/or hidden bit files. /a$s$hD  means match either system
        and/or hidden directories only. You can't do this with DIR!!

      * added /Lfx suboptions to allow more or less space reserved for line
        numbering, also /Lfr similarly enhanced.

      * added /Ce3, allows capture of stderr and if abnormal termination occurs
        only that message is routed to the console.

      * options /Xr1: and /Xr2: are restricted from using a trailing '.',
      * fixed /Lft1, 12am and 12pm related issue.
      * fixed extended help formating related issue.

      * All purchased licensed holders from any CSSDIR 1.xx or 2.xx version will
        not have to pay for this significant upgrade, This will be the last such
        significant upgrade with no additional fee.

GA_2.03a OS/2 Jan 24, 2004 (first widely available GA 2.03 release)
*****************************************************************

      * removed some small syntax errors in docs
      * added settings line in online help for list field options
      * added known issues to 2.03 GA release notes below.

GA_2.03 Release January 21, 2004
*****************************************************************

      * MAJOR release
      * removed dependencies on classic rexx being active
      * major performance enhancements, as much as 2-10+ times faster
      * tested with PRO version to handle over 2.5 million file entries (totaling
        nearly a half a trillion bytes) sorted 3 different ways on a 1.2ghz AMD
        machine withOUT crcs computed and with output redirected, all finished in
        under 1 hour, producing a results sorted data file of nearly 1 gigabyte!!
      * tested with PRO version on over 200,000 files totaling over 41 gigabytes
        of data, WITH computed CRCs and sorted by descending size and 3 other
        sorts all in 40 minutes, on a 1.2ghz AMD machine.
      * eliminated need for previously included DLL
      * reduced non-registered shareware startup nag from 6 to 5 seconds
      * fixed easize > 32767 issue
      * fixed -o*dups-des issue if last file in list is not zero length
      * added -Of: options /APPENDTIME, /NEWTIME, /OVERWRITETIME
      * added new -Pf option to give impatient users a preview list of files
      * added -Pfof: similar to -Of: but for preview files output -this is used
        in tandem with -Pf option where one could also use a unix tail program to
        monitor the -Pfof: output file and thereby not pollute your final regular
        CSSDIR output, all while getting immediate preview info, Useful on long
        non batch requests.
      * added utility program cssmon which runs as a separate process, and
        can provide basic monitoring state information to any LAN accessible
        machine (via netbios) of any active CSSDIR processes. Very handy for
        long running HUGE CSSDIR requests, All without messing up normal output.
        PRO version licensed required to query for this information.
      * changed many options in an unified coded category prefix, LORA options
        contain three prefixes -Lf for list field, -Lr for list record,
        -Lx for list additional/miscellaneous options. Also -La for list/abort
        options, -Sr for search range options, and -Xr for exclude ranges.
        Previous versions users will be affected by this.
      * added option -Lasfw: and -Lasmw: option, gives warnings control when
        binary files are searched and -Lasmw informs if temporarily memory
        reserved for searching for text is exceeded and what action to take.
      * improved searching binaryfiles and warnings for text strings
      * added -Ce; which Combines stderr messages to stdout stream and can 'tee'.
      * NOW makes use of major Virtual Memory if WSEB API is available allowing
        with a PRO version license Millions of File Entries to be processed on
        one invocation and sorted multiple ways without re-Invoking.
      * added control over how much memory should be reserved for -Sch: option
        and general CSSDIR memory consumption. See environment variables:
        cssdirMem and cssdirSchMem
      * added handy for parsing output options. See -Lfn3 -Lfn4.
      * added -Pt2 and -Pt3 for gathering/CRC computing time
      * added -Lrlt  for -List: processing Time, lists time it takes to do a
        each individual -List: request.
      * added /prefix/ and /dirPrefix/ to option -Xr1: -Xr2:, these allow one
        now to exclude file/dir entries based on a prefix name (must include)
        drive letter or UNC share name. This can exclude a total directory tree!
      * added -Pi for providing basic process info (at startup)
        so one could get basic info, such as PID (process Id), and Priority
        perhaps for monitoring. -Pi Could be useful for use with cssmon utility.
      * fixed processing of replacement of symbolics in the command line with
        recognizing longest string matches over shorter substrings. Also detects
        duplicate symbolics in the CSSDIR ini file, and circular definitions.
      * cssdirIni environment variable allows names other than CSSDIR.ini, if
        cssdirIni is set it now must contain not just the directory name but
        what resolves to a full filespec, this is a difference from versions
        1.xx which contained a dirSpec pointing to a named CSSDIR.ini file.
        You are unaffected from previous versions if you did not set cssdirIni.
        However user defined variables changed from the following format of:
        /$uservar:setting  to  /$uservar$/:setting, you will need to make
        changes as such if you wish to use a preExisting earlier version
        CSSDIR ini file.
      * added system defined symbolics, With these available and unique settings
        like /$$PID$/ (process Id) and time one can now easily create unique
        temporary filenames for output generation etc. Some of the automatically
        generated symbolics follow:
          /$$BDRV$/         current boot drive letter
          /$$CDRV$/         current drive letter
          /$$DATE$/         today's date     ; yyyy-mm-dd
          /$$DOM$/          day of month     ; dd
          /$$DOW$/          alpha day of week; ddd
          /$$GT$/:>         as shown
          /$$LT$/:<         as shown
          /$$MON$/          current month of year; mm
          /$$PID$/          this process's ID
          /$$TAB$/          tab character; replaces /$$T
          /$$TIME$/         current time  hh:mm:ss
          /$$VBAR$/:|       as shown
          /$$YEAR$/         current year
          To see all the current symbolic settings, try 'CSSDIR -Dumpo:A'.

      * renamed system defined symbolic /$$T to /$$TAB$/
      * added -Lrrs request summary option, this option gives BASIC (usually
        only 1 line) summaries  on each Directory (similar to cmd.exe's dir
        summaries) or more, see new options: -Lrrs and -Lxrst:.
      * added -Lxrst: option which decides which type of request summary report
        to use when the new option -Lrrs is non zero.
      * added -Tis  current time stamp output option on startup
      * adjusted -Ve:3 option setting to also show the pasted in cssdirDefArgs
        contents as a separate step on CSSDIR invocation startup.
      * add -Lfh hintString option to tag with a unique directory or requested
        dirspec code to each listed file information line. See -Lfh.
        Also see -Lxhp: which allows different placement of the hintString
      * add the extremely powerful option -Lxpo: which will allow a user to
        merge or (remain separate) all listed requested dirspecs a number of
        different ways. See -Lxpo:
      * Added -Lxo: as an alias to -o for uniformity with other -Lx options
      * replaced -o*asfound with sorting on reference number
      * changed meaning of -oR to sort by reference number
      * added -oJ to order by relative filespec.
      * reArranged sorting that existed previously in version 1.xx. -Lxpo: gives
        much more flexibitily.
      * CSSDIR core executable has NOT become bloatware!!
      * removed or reassigned errors codes from 1.xx.
      * All purchased licensed holders from any CSSDIR 1.xx version will not have
        to pay for this significant upgrade.
      * Known issues:
        Cssdir does not list the bulky entries of '.' and  '..' and in almost all
        cases this is not an issue. However it was discovered when using dir
        summaries (available via the new option of -Lrrs), any subdirectories
        listings that are completely empty (except for the '.' and '..' entries),
        cssdir does not list that directory all by ITSELF. If this case is the top
        level requested directory it may not be a surprise at all. However on a
        request which contains subdirectory requests (via -s) it may be considered
        unusual. We are evaulating this now ... this may be changed in a future
        version to list such directories with zero totals, etc. or some control
        option thereof.

GA_1.04 OS/2 Release
*****************************************************************

        extended unregistered expiration date.

GA_1.03 OS/2 Release August 19, 2003
*****************************************************************

      * minor adjustments to Terms and Agreement section
      * fixed register installation issue on a JFS partition
      * sorting default was changed to more closely match dir's,
        CSSDIR default changed from -o:NG but now matches dir's of -o:GN
      * -h and -? adjusted to abbreviated (usually one line per) option help
      * added options -hx -?x for eXtended help,
        similiar (but now sorted) to -h and -? in CSSDIR versions before v1.03
      * options: -h -hx -?x -? are Now organized by category and then sorted
        alphabetically by category, also adjusted this document accordingly

GA_1.02 OS/2 Release August 13, 2003
*****************************************************************

      * added -Lp option, -List: current processing user option settings
      * added K option to -Uf:, this detects filename case changes,
        also adjusted the listing of contents of directories whose name only
        differs in case to be more reasonable for a typical user
      * added *OFF option to -Uf:, this shuts off the unique file option filter
      * fixed multiple reports problem when using -Uf: with different settings
      * added (missing) /Uf: and /Ufao: settings when using -Lh and /Lh
      * changed notation of DefGlob* to:
          DORA* -(D)ir:  (O)ver(R)ide(A)ble option
          LORA* -(L)ist: (O)ver(R)ide(A)ble option
      * updated and reorganized this document

GA_1.01 first official OS/2 GA release
*****************************************************************

      * tested on the following systems:
      * tested on ecomstation 1.03 (1.0 with fixpack 3)
      * tested on ecomstation 1.1
      * in preliminary tests for OS/2 Warp 4 with fixpack 9 or greater,
        no known problems detected so far.

       (C) Copyright 2003-04 Curtis Systems Software P.C. All rights reserved
    ******************************************************************************