LS

This  is a replacement for the built-in function DIR.  It gives a
directory listing,  sorted alphabetically,  with the size of each
file and the free space remaining.  In so doing, it replaces many
of the functions of STAT as well as DIR.

LS is actually the public domain program SD v 4.4,  with one  bug
fixed,	and  renamed.  It is renamed because SD 4.4 has long been
supplanted by later versions ...  my latest copy is SD116.

SD  has  undergone many changes over the years.  It is a  popular
tool  for  RCPM sysops,  and has suffured greatly from	"creeping
featuritis." The original author (sorry,  can't locate his  name)
recognized  the need for SD to be small and fast,  if it was ever
going to be a useful replacement for a built-in function.  In the
DOC file he gave an impassioned plea that whoever made changes to
it would keep the size under 2K so it would fit in a single  disk
block  on  most systems.  Subsequent developers  have  cheerfully
ignored  this  plea,  and  the current	version  is  considerably
larger. It supports inverse video, the ZCPR3 wheel byte, and many
features useful for RCPM systems. These are indeed nice features,
but  the  newest versions don't do anything for the typical  user
that  v  4.4  doesn't,	in a much  smaller  package.  So  I  have
retained  the  old  version,   and  changed  the  name	to  avoid
confusion.

Usage of LS is essentially the same as DIR:

     LS
or   LS <filename>
or   LS <drive:>
or   LS <drive:filename>

Wildcards  are,  of course,  supported.  There are some  optional
arguments that I never use,  but others may find useful. They are
all preceded by a '$' sign:

     $U   scan user number which follows
     $A   scan all user areas
     $S   include system files (normally not shown)
     $F   write  results  to a specified file  (file  name  must
	  follow)
     $N   don't pause at end of screen

If any optional argument is given, you must have a filename, even
if it's *.*. That's why I don't use them much!

Example: to list the contents of user # 15, type

     LS *.* $U15

To output to the printer with no pause, type

     LS *.* $PN

There are other optional arguments, but they are either redundant
or dangerous, so I won't list them here.

Jack W. Crenshaw
P.O. Box 15888
Tampa, Fla. 33684
CIS 72325,1327