home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d811 / bsh.lha / bsh / ls.doc < prev    next >
Text File  |  1993-02-14  |  2KB  |  133 lines
  1.  
  2.  
  3. LS                                LS
  4.  
  5.  
  6.  
  7. NAME
  8.      ls
  9.  
  10.  
  11. SYNOPSIS
  12.      ls [-adFflnpRrst] [path]...
  13.      ls -h
  14.  
  15.  
  16. DESCRIPTION
  17.         ls is a small, fast, full-featured utility for listing the
  18.      contents of directories and displaying information about
  19.      selected files.
  20.  
  21.          Target files may be specified either by specific pathname,
  22.      pathnames with wild cards in the trailing part of the pat or a
  23.      directory.  If no target is specified, the current directory
  24.      is listed.
  25.  
  26.          The output is normally sorted in multiple columns with
  27.      directories displayed in red.  When directed to a file, or a
  28.      pipe, the output is displayed one name to a line.
  29.  
  30.  
  31. OPTIONS
  32.  
  33.     -a    causes ls to list all files.  Normally ls does not
  34.         list files for which the HIDDEN protection bit is
  35.         set.
  36.  
  37.     -C    forces ls to generate a multicolumn display even if 
  38.         output is redirected to a file or pipe.
  39.  
  40.     -d    causes ls to list directories only.
  41.  
  42.     -F    causes ls to append a slash (/) to directory names
  43.         (so OnePlane users & color blind can distinguish dirs
  44.         from plain files).
  45.  
  46.     -f    causes ls to list files only.
  47.  
  48.     -l    generates a long listing.  The additional information
  49.         includes the file protection-bit settings, size and
  50.         time and date of last modification.
  51.  
  52.     -n    no sort; list files in ExNext() order.
  53.  
  54.     -p    lists file path, either absolute or relative depending
  55.         on the path specification on the command line.  This
  56.         can then be used as a file-name feeder to other
  57.         programs, e.g. zoo.  The -p option forces a single-
  58.         column listing and also suppressed headings and
  59.         totals.
  60.  
  61.     -R    generates a recursive subdirectory listing.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LS                                LS
  71.  
  72.  
  73.  
  74.  
  75.     -r    reverses the sort order that has otherwise been
  76.         specified.
  77.  
  78.     -s    causes the list to be sorted by size, with the
  79.         largest files first.
  80.  
  81.     -t    causes the list to be sorted in chronological order,
  82.         with the most recent files first.
  83.  
  84.     -h    causes a usage message to be printed.
  85.  
  86.  
  87. NOTES
  88.     ls may be made resident either by rez, by the c:Resident 
  89.      command, or by the wshell resi command.  Since it was linked
  90.      with the Lattice cres.o module, rez thinks it is not shareable.
  91.  
  92.  
  93. DIAGNOSTICS
  94.     If no files are found matching all criteria, ls returns
  95.      WARN; if at any time ls is unable to allocate memory, ls
  96.      returns FAIL.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.