******************************************************************************
     (C) Copyright 2003 Curtis Systems Software P.C. All rights reserved
                    (last update: 2003 August 2)
******************************************************************************
20 or more cssdir examples follow:

cssdir -s -a -od /$$bdrv:\ 
 
   lists all files on the current boot drive sorted by ascending date/time

cssdir c:\ -Dr:. -s -a -os
   
   lists all files (if any) that have today's date (timestamp) sorted by 
   ascending size on drive c   

cssdir c:\;d:\;e:\ -Wc:*.c;*.h;*.cpp -Sch:"/Cmain("
   
   lists all non-hidden or system files having an extension of
   .c or .h or .cpp files on drives c, d, and e that contain
   the text case sensitive string 'main(' and also show summary 
   of matches per file (via default -Scho:1).

cssdir c:\;d:\;e:\ -Wc:*.c;*.h;*.cpp -Sch:"/Cmain(" -Scho:0 -Bf3
   
   Same as previous example but just give us the bare full file 
   specification of files that have the requested text string.

cssdir -Dr:curweek

   lists all the (non-hidden and/or system) files that have a date of
   Monday through todays' day of the week in the current directory.

cssdir -Dr:cur3week

   same as previous example but go back up to 3 weeks in time.

cssdir -Dr:curmonth
   
   lists all the (non-hidden and/or system) files that have a date of
   which falls within the current month in the current directory.

cssdir -Dr:cur6month
   
   lists all the (non-hidden and/or system) files that have a date of
   which falls within the last six calendar months in the current directory.

cssdir -Dr:2002  -a

   lists all the files that have a date in the year 2002 in the
   current directory.

cssdir -Dr:2002-06;2003-01 *.c

   lists all the files that have a date in the month of June of 2002
   or in the month of January of 2003 and matched the dirspec of *.c
   in the current directory.

cssdir -Te2 -Dr:today

   lists all the (non-hidden and/or system) files that have a date of
   today in the current directory and show the time field in the
   HH:MM:SS format (regular dir you can NOT see seconds field)!

cssdir -Fcrc:y -Fc -Xcrc:.zip;.rar  . f:\

   lists all the (non-hidden and/or system) files that reside in the
   current directory and in the root directory of the F drive while
   also computing their crc (-Fcrc:y) and displaying their corresponding
   computed crc (-Fc) and skips computing any files found that have
   suffixes of '.zip' or '.rar'
   
cssdir -Sr:2000000,$ f:\ -Wc:*.zip;*.rar;*.gz -s -os

   lists all the (non-hidden and/or system) files with an extension of
   .zip, .rar, or .gz anywhere on drive f which are 2000000 or greater
   in size (bytes) and sorts them in ascending size order.

cssdir c: -s -o-gsf -a

   lists all the files and the subdirectories of the current working directory
   on drive c, listing the files sorted by ascending size and then by 
   full filename specification, following by directories sorted by their
   full filename/directory specification.

cssdir c:\ d:\ e:\ -s -o*dups-asc -Fcrc:y -Fc -Ecrc:y -Ec -Of:c:\tmp\dupsCDE
   -X:c:\tmp\dupsCDE   

   (remember to set environment variable cssdirTMP to a scratch working
    directory before running this example or use the -Tdir: option)
   lists all potential duplicate files that span over drives c, d, and e,
   and output the results to the data file c:\tmp\dupsCDE, exclude the
   c:\tmp\dupsCDE from this analysis. [Please note depending on the drive
   sizes and contents this could take a while to finish. On approx one
   gigabyte boot partitions with about 14000 files and 850meg of data 
   it takes about 5 minutes with a 1.2ghz amd processor, On a faster 
   machine with 1733mhz (2100+) amd with 46000+ files and over 5 gig 
   of data I have seen it take under 10.5 minutes.] In the listing 
   of possible duplicates include the CRC of the files data (-Fc) and 
   include a files ea CRC (-Ec).

cssdir c:\basetree1 g:\basetree1 -s -a -Uf: -Uq

   lists all the unique files that exist between c:\basetree1 and 
   c:\basetree2 and their subdirectories and list which fields are
   unique.

cssdir c:\basetree1 g:\basetree1 -s -a -Uf:-D -Uq2

   lists all the unique files that exist between c:\basetree1 and 
   c:\basetree2 and their subdirectories ignoring timestamps in the
   determination of uniqueness, and place the unique field on the
   left of the listing (-Uq2) just before the -De field.
   
cssdir @dirspecs -Fcrc:y -Fc -Ey

   lists all the files that match the directory specifications while
   also doing CRC computations and include those Calcuations in the
   listing, number them as well. The directory specifications are
   read from the dirspecs file found in the current directory,
   1 dirspec per line. Professional license required.

cssdir c:\ -s -o*summary -List:/1

   lists the summary of drive c with all the total options fields 
   with a setting of one, this include easizes totals, file size
   totals, archive bits totals, free space on drive c, and a 
   number of other totals.

cssdir c:\*.zip -s -o*summary

   lists the summary of totals for files with the extension .zip
   found on drive c.

cssdir c:\ -s -a -List:/oS;/oen/Fn2/Ff3

   produces two lists for all files on drive c, first listing will
   be sorted by ascending filesize, the second will be sorted 
   first by file extension and then by filename and includes the
   filename extension format which is aligned by filename and then 
   aligned by file extension following by full file specification.

cssdir -Dumpo:a -a -on

   first dumps all active option settings followed by all files   
   in the current directory sorted by their filenames.

cssdir -s | more

   lists files and pipe output to the paging program more

cssdir -s 2>&1 |more

   same as above but also paginate stderr: as most users would expect.

cssdirm -s

   same as above but use the included rexx shortcut script
