home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / dlf07.arj / DLF.DOC < prev    next >
Encoding:
Text File  |  1992-01-28  |  4.0 KB  |  93 lines
  1. DLF -- Dave's List Files                        (c) 1991 Bit Bucket Software
  2.  
  3.     * *  Beta Version 0.7 -- This file is preliminary documentation * *
  4.  
  5. DLF is a simple directory lister, showing the files in a directory grouped
  6. by extension, and sorted by file name.  It supports several output formats,
  7. controlled by command line switches.  I wrote it to replace a program
  8. called LF.COM that I liked but that didn't accept path names and got
  9. confused on directories with a large number of files.  I've given DLF some
  10. extra options and more of a 4DOS-style command line flavor.
  11.  
  12. The syntax for DLF is
  13.  
  14.         Usage:  DLF [/switches] [pathname] [/switches] [pathname] ...
  15.  
  16. Pathnames are processed to append *.* or \*.*; future versions of the
  17. program may support use of file wildcards.  The pathname can be any valid
  18. drive or diretory; however, no checking is performed.  There are two output
  19. modes, showing files only or files with abbreviated sizes.  A third mode is
  20. partially implemented, showing files with abbreviated sizes one per line;
  21. my intent is to add display of 4DOS file descriptions to this mode.  The
  22. default mode appears as follows:
  23.  
  24. DLF (0.7) listing of c:\powerc2\dlf\*.*
  25. .BAT files:  check      10b │
  26. .BTM files:  make      115b │ new_dlf   333b │
  27. .C   files:  ansisys    12K │ cdir      739b │ dlf_main   14K │ dlf_out     6K
  28.              dlf_use     2K │
  29. .DOC files:  dlf         4K │
  30. .ERR files:  c         149b │
  31. .EXE files:  dlf        17K │ dlf_main   17K │
  32. .H   files:  dlf       673b │
  33. .HXT files:  dlf         2K │
  34. .MAP files:  dlf_main   15K │
  35. .MIX files:  dlf         7K │ dlf_main    6K │ dlf_out     5K │ dlf_use     4K
  36. .PRJ files:  dlf       237b │
  37. .TRC files:  dlf_main   10K │ dlf_out   121b │ dlf_use   110b │
  38. Total of 23 file(s), 120429 bytes
  39.  
  40. Switches can be any of:
  41.  
  42.      ? -- print a usage message (also h)
  43.  
  44.      d -- DLF format, show files and abbreviated sizes, 4 per line (default)
  45.      l -- LF format, show files only, no sizes, 6 per line
  46.      4 -- 4DOS format, show files, abbreviated sizes, 1 per line
  47.  
  48.      n -- Normal mode, turn Break and Emphasized off (default)
  49.      b -- Break mode, print a blank line between file types
  50.      e -- Emphasized mode, print a horizontal line between file types
  51.  
  52.      a -- Show all files (default)
  53.      x -- Show only executable files (COM, EXE, BAT, BTM)
  54.  
  55. Switches are case insensitive, and affect the display of the pathnames
  56. specified after the switch (that is, parameters are processed in order).
  57. Note that the switches L, D and, 4 are mutually exclusive, as are the
  58. switches B, E, and N, and the switches A and X.  An environment variable
  59. named DLF_OPT can be used to alter the defaults.  For example, adding
  60.  
  61.                               SET DLF_OPT=4e
  62.  
  63. would cause DLF to default to the 1-file-per-line output format, with
  64. horizontal lines between different file types (extensions).  The
  65. environment variable is processed after the internal defaults are set but
  66. before the command line is processed, so command line switches still take
  67. precedence.  Note that none of the switches are toggles, so the meaning of
  68. any particular switch value is always unambiguous.
  69.  
  70. Abbreviated files sizes are reported in (b)ypes, (K)ilobytes, or (M)egabytes
  71. Sizes are adjusted up to the nearest whole K or M, if appropriate.  K's and
  72. M's are binary, not decimal (1K = 1024 bytes).  The summary total of file
  73. sizes is total bytes of data, not total bytes of disk space used.
  74.  
  75. DLF writes to the standard output, so its output can be redirected and
  76. piped.
  77.  
  78. DLF is written in C and was compiled with the Mix PowerC compiler, v2.0.0.
  79. It should work fine if processed with PKLITE, DIET, or similar programs.
  80.  
  81. Comments, bug reports, and suggestions on this program are welcome --
  82. please send them to me in the C programming message area of The Programmer's
  83. Corner BBS of Columbia, MD.  Phone numbers for TPC are:
  84.  
  85.  
  86.                  (301) 596-1180 and (301) 995-3744
  87.  
  88.  
  89. Dave Lemire
  90. Bit Bucket Software
  91. Columbia, MD
  92. 1/28/91
  93.