home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DESKTOP / KEEPNAME.ZIP / COLORDIR.DOC < prev    next >
Text File  |  1992-06-02  |  6KB  |  114 lines
  1.  
  2.                     ~0E COLORDIR V1.5 (Nov. 17, 1987)
  3.                         ~0C (c) by Larry Marshall
  4.  
  5.         ~0CCOLORDIR ~0Bcreates a four-column, sorted and color-coded
  6.         (according to the file .EXT) directory. BEWARE!!  Once you've
  7.         used a color-coded directory you'll never go back to using a
  8.         monochrome directory program.  In spite of the color coding
  9.         you'll find this program to be as fast or faster than most
  10.         monochrome programs and is faster than HDIR, the only other
  11.         color directory I've come across. This is because it uses
  12.         inline functions written for TURBO-C by Steve Margison.  His
  13.         shareware library of functions (TURBCLIB - $25 including
  14.         source) is absolutely fabulous.  He is also VERY supportive of
  15.         his users.  This program has benefited from his comments and
  16.         criticisms.
  17.  
  18.         You'll probably want to rename ~0CCOLORDIR~0B to something a bit easier
  19.         to type.  Because of my limited memory capacities I use "D".
  20.  
  21.         ~0CCOLORDIR.CFG~0B is a file that you will probably want to modify. This
  22.         file contains all of the color definitions.  When ~0CCOLORDIR~0B is
  23.         executed it will look for this file in the default subdirectory 
  24.         and, if it doesn't find it, will then search your PATH for the 
  25.         file.  This allows you to have a "default" ~0CCOLORDIR.CFG~0B somewhere
  26.         along your PATH and special ~0CCOLORDIR.CFG~0B file in some subdirectories.
  27.  
  28.         Those of you having earlier releases of ~0CCOLORDIR~0B should note that
  29.         the format has changed and ~0EYOU MUST CONVERT YOUR OLD ~0CCOLORDIR.CFG~0E
  30.         FILE TO THE NEW FORMAT~0B.  This file contains two values written as 
  31.         ~0AEXT=ATTR~0B.  The first values (~0AEXT~0B) are filename extents and the second
  32.         (~0AATTR~0B) is the color attribute desired for the associated file extent.  
  33.         Thus "~0ACOM=15~0B" will cause .COM files to be displayed in high intensity 
  34.         white.  You can have up to 30 definitions in ~0CCOLORDIR.CFG~0B.  The first
  35.         three definitions are special and must be placed in the order:
  36.  
  37.                      ~0ADF=12     (color of non-matching files)
  38.                      SD=13      (color of sub-directories)
  39.                      SZ=14      (color of file sizes)~0B
  40.  
  41.         You many, of course, change the attribute values.  I have included
  42.         my default ~0CCOLORDIR.CFG~0B file as an example.  If no ~0CCOLORDIR.CFG~0B
  43.         file is found during execution you will be given a rather bland 
  44.         directory listing and the notice that the file was not found.
  45.  
  46.         ~011 blue          ~022 green        ~033 cyan         ~044 red
  47.         ~055 violet        ~066 gold         ~077 gray
  48.  
  49.         ~099 lt. blue      ~0A10 lt. green   ~0B11 lt. cyan    ~0C12 lt. red
  50.         ~0D13 lt. violet   ~0E14 lt. yellow  ~0F15 white~0B
  51.  
  52.         Those of you with monochrome monitors will notice that several of
  53.         these options will underline the filename (there will also be blank
  54.         spots where attributes giving "dark" colors would normally be
  55.         displayed.  You may also want to use reverse-video to display a 
  56.         type of file.  This can be done using attribute 48.
  57.  
  58.  
  59.  
  60.                                ~0ELIMITATIONS~0C
  61.  
  62.         COLORDIR~0B is restricted to displaying only 500 filenames.  I
  63.         haven't found this much of a limitation since my largest
  64.         subdirectory contains 72 files.  This limit is due to the size
  65.         of the array I build to do the sorted directory.  If you're in
  66.         need of more capacity let me know.  I can increase it in
  67.         future releases if demand warrants.  If you list a directory
  68.         containing more files than can be placed on one screen you
  69.         will be prompted to continue before ~0CCOLORDIR~0B scrolls the
  70.         listed files off screen.
  71.  
  72.         ~0CCOLORDIR~0B allows normal dos pathnames and wildcards.  If no
  73.         file name is entered on the command line, *.* is assumed.  The
  74.         one contingency that I have not dealt with is a file request
  75.         like  \dir\subdir\fname where filename has NO extent.  In this
  76.         case ~0CCOLORDIR~0B will interpret "fname" to be a subdirectory.
  77.         This syntax works fine if "fname" has an extent or if you include 
  78.         a period at the end of the filename.
  79.  
  80.  
  81.                           ~0EABSOLUTELY FREEWARE~0E
  82.  
  83.         This program is ~0AFREE~0B.  I don't want any money from anyone
  84.         using this program for their personal use.  Hopefully release
  85.         of such a program under these conditions will encourage others
  86.         to do the same. When I began calling BBSs a few years ago
  87.         there were lots of really great programs to be found.  Nobody
  88.         was asking for money.  I used lots of those programs and
  89.         hopefully some of you will find mine useful.  I fully support
  90.         the SHAREWARE concept and have registered several packages.  I
  91.         feel however, that there is still room in the small program
  92.         area for FREE exchange of programs.  Use this program and
  93.         distribute it freely.  I only ask that you distribute the ENTIRE
  94.         package including ~0ACOLORDIR.EXE, COLORDIR.CFG, COLORDIR.DOC~0B
  95.         and ~0AREVLIST~0B.  You may not however, use or distribute this 
  96.         program for profit of any kind.  I reserve all rights of authorship
  97.         of ~0CCOLORDIR~0B.
  98.  
  99.         Any comments or criticisms of ~0CCOLORDIR~0B should be sent to me
  100.         at:
  101.  
  102.                             ~0ELarry Marshall
  103.                             Departement de biologie
  104.                             Universite Laval
  105.                             Ste-Foy, PQ. G1K 7P4  Canada
  106.  
  107.                             or
  108.  
  109.                             [SQUARE-HEADs] BBS
  110.                             1-(418)-523-3117
  111.                             FidoNet 167/201~0B
  112.  
  113.         *******************************************************************
  114.