home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / DC38.ZIP / DC.DOC < prev    next >
Text File  |  1990-12-01  |  17KB  |  315 lines

  1.  
  2.  
  3.  
  4.                               DirColor v3.8
  5.                      Copyright (c) 1990 David Lipper
  6.  
  7.       DirColor (DC.EXE) is a colorized directory lister. Type DC -?
  8. for a help screen that will give you all the commandline switches and a
  9. color key to the different extensions supported. DC supports 43/50 line
  10. EGA/VGA modes; see the help screen (replicated below) for the appropriate
  11. commandline switches. DC.EXE will handle directories with up to 10000 files,
  12. if you have enough free memory.  If you have a  slow disk drive,
  13. you may want to put it in your root directory so it comes up faster.
  14.     Instruction for using DC follow; I encourage you to read the revision
  15. history (at the end of this document) for details which may not be mentioned
  16. in the following section.
  17.  
  18.                                  DC Color Modes
  19.  
  20.      DIRCOLOR effectively has 4 different color modes; the default mode
  21. displays files with different extensions according to a pre-determined
  22. color code - 60 different file extension color codes are currently supported;
  23. the help screen (in the program) contains a color key for these extensions.
  24. This mode can be forced with the -y parameter (read on).
  25.     The second color mode, specified by the -x parameter, will cause each
  26. file in the directory to appear in random colors, regardless of the file
  27. extensions.
  28.     The third color mode, specified by the -c parameter, will display
  29. each field in the directory in a dierent color - that is, all the filenames
  30. will be in one color, the extensions will be in another color, and so on
  31. for the filesize, attributes, and date. The colors for this mode change
  32. every time you run the program, to keep things interesting.
  33.     The fourth color mode is achieved by combining the -x and -c parameters
  34. ("-c -x", not "-c-x" - notice the space), and will result in every file
  35. entry AND every field being a random color.
  36.  
  37.  
  38.                        Environment Variable DCPARAMS
  39.  
  40.     There is an environment variable which you can use to set the default
  41. options for DC to use. The variable is called DCPARAMS, and is defined by
  42. entering "set DCPARAMS={options}" from the DOS command prompt (see your DOS
  43. manual for more information on environment variables). If you have defaults
  44. specified in DCPARAMS and want to use a different configuration, just enter
  45. the new parameters on the DC command line, and any switches (parameters)
  46. defining options mutually exclusive with switches in DCPARAMS will override
  47. the defaults. For example, if you have a date sort specified in DCPARAMS,
  48. and you want a directory sorted by extension, you would just specify the
  49. extension sort switch on the commandline, and DC would do an extension sort;
  50. if you then run DC without a sort switch specified, it will default back
  51. to the date sort. A brief note about overriding the color mode switches:
  52.       If you have either -x or -c specified in DCPARAMS and want to use
  53.       the other one from the commandline and don't want the combination
  54.       effect, just specify -y before it, and the DCPARAMS default will be
  55.       reset before the rest of the commandline is evaluated. For example,
  56.       if DCPARAMS=-e -c and you want the -x effect, you would enter DC -y -x
  57.       from the command line. The -y would reset the -c, then the -x would
  58.       be evaluated.
  59.     Any option switch in DCPARAMS which is not specifically changed on the
  60. commandline will remain in effect. Thus, if you have all your favorite color
  61. mode and video mode switches in DCPARAMS and just want to change the sort,
  62. you need only specify the new sort switch on the commanline, the color and
  63. video option defaults (as set in DCPARAMS)  will remain in effect.
  64.     If mutually exclusive switches are specified on the command line, only
  65. the last one will be evaluated (except when using -y before -x or -c, see
  66. above). I suggest you play around with the various switches, it's easier to
  67. get the feel of DC through hands-on experience than by reading about it.
  68. I've designed DC to be as convienient and functional a replacement for
  69. the DIR command as possible (though old habits die hard, huh?).
  70. DC is actually more than twice as fast as the DIR command, even using
  71. BIOS video. (compare it to dir /w if you think that's just 'cause DC shows
  72. twice as much in a screen) For listing huge directories with a sort, there
  73. may be a slight initial delay, this is negligible, even on my relatively
  74. slow 10 Mhz AT).
  75.  
  76.                                   Sorting
  77.  
  78.     The sort options are intuitive; they are as follows:
  79.  
  80.     -e = ascending extention / name sort (start with .A, end with .Z);
  81.          files having the same extension are then sorted alphabetically
  82.          within thier domain.
  83.  
  84.     -E = descending extension / name sort
  85.  
  86.     -n = ascending name / extension sort
  87.  
  88.     -N = descending name / extension sort
  89.  
  90.     -s = ascending file size sort
  91.  
  92.     -S = descending file size sort
  93.  
  94.     -d = ascending file date sort
  95.  
  96.     -D = descending file date sort
  97.  
  98.  
  99.                                    BIOS Video
  100.  
  101.     The -b switch forces DC to use BIOS video routines (instead of direct
  102. screen writes which is faster), and may be necessary depending on your
  103. setup (like maybe if you're using Desqview or other similar software).
  104.  
  105.  
  106.     What I suggest is that you specify your most frequently used parameters
  107. in the DCPARAMS environment variable, then specify any overriding parameters
  108. on the command line when you need to, this would make DC the most convenient.
  109.  
  110.  
  111.          If you think I left out an important extension, send me e-mail
  112. and I'll decide if I'm gonna add it. If you find some color combination
  113. unreadable, leave me e-mail and I'll probably remove it; although I've
  114. already excluded all color combinations which I find unreadable, I realize
  115. that motitors vary.
  116. Have fun. -Dave
  117.  
  118.  
  119. _____________________________________________________________________________
  120.                             HELP SREEN PRINTOUT:
  121.  
  122. DIRCOLOR v3.8 - Copyright (c) 1990 David Lipper
  123.  
  124.  
  125. command syntax:
  126.  
  127.      DC [/-h?] [-rm{43|50}] [-bxcy] [-unesdNESD] [pathname/filemask]
  128.  
  129. Environment variable DCPARAMS:
  130.      There is an environment varialbe, DCPARAMS, which can be set
  131. to contain default commandline switches, but not a pathname or filemask.
  132. Any parameters specified on the DC commandline will override the settings
  133. in DCPARAMS. To have DC default to this help screen, set DCPARAMS=?
  134. See DC.DOC or more information.
  135.  
  136. pathname/filemask can contain any valid drive/path specification
  137. combined with any filename/extension/* wildcard (see examples)
  138.  
  139. Video mode options:
  140.  -r or -r43 or -r50 = use 25, 43 or 50 line mode respectively, reset on exit
  141.  -m or -m43 or -m50 = same as -r, but don''t reset screen mode
  142.  -b forces DIRCOLOR to use BIOS video, the default is direct screen s
  143. NOTE: if you use -r, the screen will be cleared, use -m to keep the
  144. directory on screen. If you have an EGA, use 43, if you have VGA, use 50.
  145. Use -r or -m without the 43/50 to override the settings in DCPARAMS.
  146.  
  147.  
  148. Color mode options:
  149.  -x causes DIRCOLOR to use random colors for all files
  150.  -c causes DIRCOLOR to use different colors for different fields
  151.  -y on commandline (only) overrides -x or -c in DCPARAMS
  152.  
  153. NOTE: -c and -x can be combined for completely random fields and filenames
  154. See DC.DOC for more information.
  155.  
  156. Sort types:
  157. -n,-N = name/extension | -e,-E = extension/name | -s,-S = size | -d,-D = date
  158. (capital letters sort in descending order, lower case in ascending order)
  159.  
  160. -u unsorted - on commandline (only) overrides sort switch in DCPARAMS
  161.  
  162. Help:
  163.  -h or -? or ? or /h or /? = this help screen
  164.  
  165.   All switches should be lower case, unless otherwise specified (-NESD).
  166.  
  167. Examples:
  168.  
  169.   DC                     -- list current directory in standard 25 line mode
  170.   DC d:\monsters\.boo    -- standard 25 line mode, dir of d:\monsters,
  171.                             files with ".boo" extension
  172.   DC -r43 -x             -- 43 line, reset mode, current dir, random colors
  173.   DC -m50 c:\turbo       -- 50 line, don''t reset mode, dir of c:\turbo
  174.   DC \dos\copy.*  -r50   -- 50 line, reset mode, files in \dos on current
  175.   or DC -r50 \dos\copy      drive with filename "copy", any extension
  176.   DC *.exe or DC .exe    -- all files in current directory with ".exe" extension
  177.   DC ico* or DC ico*.*   -- files in current directory starting with "ico"
  178.   DC \win -e -b          -- directory of \win on current drive, sorted by
  179.                             extension in ascending order; use bios video
  180.   DC *.bat -n -y         -- all files with ".bat" extension in current
  181.                             directory, sorted by name in ascending order, use
  182.                             extension colorcodes, even if -x is in DCPARAMS
  183.   DC -D c:\dos -r        -- directory of c:\dos; 25-line mode, reset video
  184.                             on exit; sorted by date in descending order
  185.  
  186.  
  187. environment variable examples:
  188.  
  189.               set DCPARAMS=-e -r50 -c    or    set DCPARAMS=-m43 -D -b
  190.  
  191. ____________________________________________________________________________
  192.  
  193.  
  194.  
  195. Leave me comments / suggestions / bug reports and get the latest version on:
  196. The Brentwood BBS (914)835-7898  1200/2400; 38,400 HST w/ subscription
  197. Over The Edge BBS (914)747-4635  300-2400
  198.  
  199. This program is hereby dedicated to the public domain and is offerred as-is,
  200. with no warrantees expressed or implied. In no event shall the author be held
  201. responsible for loss resulting from the use or misuse of this program. If the
  202. color combinations trigger an epileptic seizure & you bite off your tongue,
  203. I won't pay for it to be sewed on again (no disrespect to epileptics
  204. intended).
  205.  
  206. _____________________________________________________________________________
  207. HOWEVER: I would like to encourage you to contribute to Greenpeace; humans
  208.          have been destroying the planet and driving species after species
  209.          into extinction for ages, Greenpeace is one of the few organizations
  210.          that appreciates the gravity of the situation and cares enough to
  211.          do something about it, and they work very hard and need all the
  212.          help they can get. Thanks alot. - Dave
  213. _____________________________________________________________________________
  214.  
  215. revision history:
  216. 1.0   initial release
  217. 1.1   added lots of extensions & other stuff I can't remember
  218. 1.2   added .WPF, .BK!, .WRI, .CFG, .DAT, .MAP, .HR, .FNT, .REC, .SCR,
  219.       .DRV, .WKS, .WK1, .ASC, .ANS, .OV* (that means .OVL, .OVR, .OV1, etc.),
  220.       files without an extension, and probably some others I forgot about;
  221.       fixed 0 byte length of volume labels, now shows < VOL > instead.
  222.       Changed color for .DVR to make it more readable. DC now supports 60
  223.       different color combinations (if I counted right) not counting
  224.       unclassified files.
  225. 2.0   Rewrote code for commandline switches, now switches can be specified
  226.       in any order, there is no longer a space between the -m or -r switch
  227.       and the number speciying the mode (ex. now -m50 instead of -m 50).
  228.       Dircolor now supports a path/filemask commandline parameter, see the
  229.       help screen for examples. Planning to add sorting to the next version.
  230.       Added "xxxxxx Bytes in xxx Files" to the end of the directory.
  231. 2.01  Fixed a couple of minor bugs - the xx Bytes in xx Files message would
  232.       cause the first line to scroll off if there was an exact multiple
  233.       of 100 files in 50-line mode, 25 line mode was only using 24 lines,
  234.       now uses all 25; the textmode wouldnt get set to 43/50 if the -r/-m
  235.       parameter was specified before a path. Fixed.
  236. 2.02  Directories would sometimes display with the color attributes of a
  237.       file with no extension. Fixed.
  238. 3.0   Ok, I finally added directory sorting, and also a BIOS visdeo option.
  239.       I'd appreciate any bug reports or suggestions, since I'd like to make
  240.       the next version a beta (I would've made this a beta, but I had to
  241.       rewrite and add so much code to make it sort the directory, it may
  242.       have some quirks (although I didn't find any in testing). This version
  243.       supports up to 511 files per directory , which can be changed
  244.       if need be.
  245. 3.1   Added an environment variable, DCPARAMS, that can contain default
  246.       commandline parameters (but not a path or filemask). Any parameters
  247.       specified on the commandline override the ones in DCPARAMS. Also
  248.       added the -r and -m switches to force 25-line mode (to override
  249.       settings in the DCPARAMS environment variable). Now there are
  250.       2 .EXE files in the archive, DC.EXE and DCBIG.EXE; DC still has
  251.       a directory limit of 511 files, and needs about 45k to run; DCBIG.EXE
  252.       will handle directories with up to 2047 files, and needs about 85k
  253.       to run. If you run the programs in too little memory, the display
  254.       will probably contain garbage characters, and your memory will be
  255.       corrupted. If someone actually has a directory with 2047 files in
  256.       it, I'd appreciate some e-mail letting me know if it works ok.
  257. 3.2   Added -x option for random colors, -y to override -x in DCPARAMS;
  258.       added "Hit any key.." messages, added free disk space display. I
  259.       think I picked out all the unreadable color combinations for the -x
  260.       option, but if you come across one that is unreadable, send me e-mail
  261.       and I'll nuke it.
  262. 3.3ß  Fixed the problem with the curor, F keys, etc. bouncing at the hit
  263.       any key prompt. Neatened up the listing of volume labels and
  264.       directories. Now the volume label is always listed first when
  265.       any sort options except the date sort are used. Directory names
  266.       will now be before the filenames in all sorts except the date sort,
  267.       and will be in alpabetical order (ascending) except in the descending
  268.       order date sort (-D), when they will be in descending order. Did away
  269.       with the big version of DC; DC needs a minimum of about 55k to run,
  270.       but if you have a directory with lots of files ( > 512 or so), you
  271.       will need more free memory.  If there is not enough free memory,
  272.       DC will either terminate with a stack overflow message, or the screen
  273.       will have garbage characters on it.  If you get garbage characters,
  274.       then just allow more memory for DC to run.
  275. 3.4   Fixed a bug in the extension sorts (-e,-E) that was ruining the sort.
  276.       Did away with internal memory allocation; now you will not get a
  277.       "not enough memory" DOS message if you try to run DC in less than 55k,
  278.       you can run the program in as little memory as you want (as long as
  279.       there's room for the code itself - 30k or so), but if there is too
  280.       little memory for the amount of files in the directory you want to
  281.       list, you will get garbage characters on the screen - if this happens,
  282.       just run it in more memory. This should not be any kind of problem;
  283.       With a directory having more than 2000 files, DC should use maybe 100k.
  284.       Now ESC will abort the program (at the "press any key" message).
  285. 3.5   Added the -u commandline switch to force an unsorted listing
  286.       regardless of the DCPARAMS settings. "." and ".." directory listings
  287.       were switched in some sorts. Fixed.
  288. 3.6   Added secondary sorts: -e,-E now do an extension/name sort; -n,-N
  289.       now do a name/extension sort. Now DC will work in a directory with
  290.       10,000 files, if you have the memory. Fixed the doc up a little
  291.       so at least it's current. I'm running out of ideas for this program;
  292.       any suggestions ? Maybe I'll just let it be.
  293. 3.7   Whoops. The free bytes number was the current drive, instead of the
  294.       specified one - Fixed, plus added the drive letter to that field.
  295.       Other minor changes.
  296. 3.8   Duh, ok, the obvious idea hit me - now there is a parameter (-c)
  297.       to make DC use a different color for each field in the display
  298.       (ie. name, extension, bytes, etc.) With the addition of this option,
  299.       various combinations of the color scheme parameters (-x,-c,-y)
  300.       become active; if both -x and -c are specified, a combination effect
  301.       will result: each field of each file entry will have it's own color.
  302.       If you have either -x or -c specified in DCPARAMS and want to use
  303.       the other one from the commandline and don't want the combination
  304.       effect, just specify -y before it, and the DCPARAMS default will be
  305.       reset before the rest of the commandline is evaluated. For example,
  306.       if DCPARAMS=-e -c and you want the -x effect, you would enter DC -y -x
  307.       from the command line. The -y would reset the -c, then the -x would
  308.       be evaluated. The -c switch will cause DC to use a different color
  309.       scheme each time it is run. I also fixed up my poor excuse for a doc;
  310.       I realized that I'd left many questions unanswered. And I redid the
  311.       help screen, it's actually kinda nice now. oh yeah, and I also included
  312.       a batch file to quick-demo the color modes in 25-line mode, although
  313.       personally I think 50-line mode looks much better.
  314.  
  315.