home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / sysutl / tools.lbr / LS.DZC / LS.DOC
Encoding:
Text File  |  1987-08-07  |  2.4 KB  |  64 lines
  1. LS
  2.  
  3. This  is a replacement for the built-in function DIR.  It gives a
  4. directory listing,  sorted alphabetically,  with the size of each
  5. file and the free space remaining.  In so doing, it replaces many
  6. of the functions of STAT as well as DIR.
  7.  
  8. LS is actually the public domain program SD v 4.4,  with one  bug
  9. fixed,    and  renamed.  It is renamed because SD 4.4 has long been
  10. supplanted by later versions ...  my latest copy is SD116.
  11.  
  12. SD  has  undergone many changes over the years.  It is a  popular
  13. tool  for  RCPM sysops,  and has suffured greatly from    "creeping
  14. featuritis." The original author (sorry,  can't locate his  name)
  15. recognized  the need for SD to be small and fast,  if it was ever
  16. going to be a useful replacement for a built-in function.  In the
  17. DOC file he gave an impassioned plea that whoever made changes to
  18. it would keep the size under 2K so it would fit in a single  disk
  19. block  on  most systems.  Subsequent developers  have  cheerfully
  20. ignored  this  plea,  and  the current    version  is  considerably
  21. larger. It supports inverse video, the ZCPR3 wheel byte, and many
  22. features useful for RCPM systems. These are indeed nice features,
  23. but  the  newest versions don't do anything for the typical  user
  24. that  v  4.4  doesn't,    in a much  smaller  package.  So  I  have
  25. retained  the  old  version,   and  changed  the  name    to  avoid
  26. confusion.
  27.  
  28. Usage of LS is essentially the same as DIR:
  29.  
  30.      LS
  31. or   LS <filename>
  32. or   LS <drive:>
  33. or   LS <drive:filename>
  34.  
  35. Wildcards  are,  of course,  supported.  There are some  optional
  36. arguments that I never use,  but others may find useful. They are
  37. all preceded by a '$' sign:
  38.  
  39.      $U   scan user number which follows
  40.      $A   scan all user areas
  41.      $S   include system files (normally not shown)
  42.      $F   write  results  to a specified file  (file  name  must
  43.       follow)
  44.      $N   don't pause at end of screen
  45.  
  46. If any optional argument is given, you must have a filename, even
  47. if it's *.*. That's why I don't use them much!
  48.  
  49. Example: to list the contents of user # 15, type
  50.  
  51.      LS *.* $U15
  52.  
  53. To output to the printer with no pause, type
  54.  
  55.      LS *.* $PN
  56.  
  57. There are other optional arguments, but they are either redundant
  58. or dangerous, so I won't list them here.
  59.  
  60. Jack W. Crenshaw
  61. P.O. Box 15888
  62. Tampa, Fla. 33684
  63. CIS 72325,1327
  64.