home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d3xx / d358 / viewdir.lha / ViewDir / ViewD_docs < prev    next >
Text File  |  1990-06-12  |  4KB  |  112 lines
  1.   ViewDir - A Directory Reading program for your CLI C: directory
  2.          Jim Butterfield .. revised April 1990
  3.  
  4. There are two things that I can't get from commands DIR
  5. or LIST.  First:  I often need to know how large a directory
  6. is.  When a disk is "loaded", I'm often looking to find
  7. the area where I can make the most space savings.  That's
  8. often a directory, but finding its size can be a lot of
  9. painstaking work.
  10.  
  11. Second:  In many cases, I could use a hint as to kinds of files
  12. I have.  Text?  .. a program ready to load and execute?
  13.   .. an AmigaBasic program? .. an IFF file?  Sometimes
  14. there's an icon to give me a hint.  Sometimes not.
  15.  
  16. So: type ViewDir followed by the name of a drive or directory
  17. and you'll get this kind of information.
  18.  
  19.  
  20.  
  21.  
  22.  
  23. The format is:
  24.  
  25.      ViewDir [-b -i -t] DirectoryName
  26.  
  27. Note that flags -b, -i, and -t must come FIRST, before the
  28. directory name, in true unfriendly UNIX fashion.  Here's
  29. what they mean:
  30.  
  31.   -b  Show me file/directory sizes in Blocks rather than bytes.
  32.   -i  Do not print details on any file whose name ends with .info.
  33.   -t  Don't worry about giving me file type.
  34.  
  35. You may supply the flags in any combination, separately (as
  36. in ViewDir -b -i df0:) or together (as in ViewDir -ibt df0:).
  37. Do follow any flag grouping with a space character.
  38.  
  39. * Blocks:  if you're looking for space on a disk, this number is
  40.   a little more meaningful than bytes.
  41. * Info:  these files often make a list much bigger, and often do
  42.   not add useful information.
  43. * Type:  To guess at a type, the program will read the first 100
  44.   bytes of the file.  Flag -t tells it not to bother.
  45.  
  46. FileTypes:
  47.  
  48. 1. TextFile:  The file contains regular alphabetic characters
  49. (none from the extended character set), and NewLine, Return,
  50. or Tab characters.  If a file includes such things as escape
  51. sequences, CSI, or FormFeed, it will NOT be shown as a TextFile.
  52.  
  53. 2. Loadable:  The file may be loaded as a program.  This does
  54. NOT mean that the file may be executed in every case, since
  55. library items, overlays, and fonts are also classed as loadable
  56. modules.  Trying to execute those might give your computer a
  57. headache.
  58.  
  59. 3. WorkBenchObject and WorkBenchWindow:  These (normally .info)
  60. files are there to make the WorkBench screen do its job.
  61.  
  62. 4. IFF files:  The 'FORM' type files are detected and their
  63. type given.  Other IFF types might be caught via (8) below.
  64.  
  65.  
  66.  
  67. 5. AmigaBasic:  This one is a little tricky.  Some AmigaBasic
  68. programs are just text files, and will be so identified.  Most
  69. are specially formatted "tokenized" files; these will be
  70. specifically classified.
  71.  
  72. 6. FontList:  files such as "Sapphire.font" which list the
  73. various fonts available within this typeface.  The fonts
  74. themselves classify as "loadable" files.
  75.  
  76. 7. Empty:  nothing in the file.
  77.  
  78. 8. ....TYPE:  File is NOT text, but the first four characters
  79. are alphanumeric; these are shown (examples:  ...LIST, ....SPFK),
  80. or ....PDPF), in case they are useful for identity.
  81.  
  82. 9. FILE:  none of the above.  Might be an object file, a
  83. formatted text file, or some other binary image.  If you
  84. specify the -t option, all non-empty files show this.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93. Assembly language source is included with this package.
  94. If you want to add your own special file recognition
  95. items (say, WordPerfect files, PageSetter documents,
  96. special loadables such as libs, or BCPL units)
  97. be my guest; but PLEASE add an update note to the signature
  98. data that appears when you type ViewDir with no following
  99. information.  I'd hate to get questions on code that
  100. somebody else wrote.
  101.  
  102. You may redirect output, of course.  And ViewDir responds to
  103. Ctrl-C and stops immediately, echoing "^C".
  104.  
  105. Revision, March/1990:  Major agony for a result that might not
  106. be noticeable to the average user.  Supplying a file name rather
  107. than a directory gives more detail than before.  A directory
  108. now includes a "summary" line at the end, so that you see contents
  109. and total.  Parsing greatly expanded to support SPAT usage.
  110. See "notes" for more detail.
  111.                                --Jim B
  112.