home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / ls.lha / ls.doc < prev   
Text File  |  1988-11-27  |  4KB  |  88 lines
  1.  
  2.   LS.C -- an "improved" directory listing utility to replace the
  3.   AmigaDOS DIR and LIST commands.
  4.  
  5.   V1.0   August 1986 Written from scratch by Justin V. McCormick.
  6.   V2.0 November 1988 Revised for Lattice 5.0 and made 1.3 compatible.
  7.  
  8. Notice:
  9.  
  10.   This program is placed in the public domain with the understanding
  11. that the author makes no claims or guarantees with regard to its
  12. suitability for any given application, and that the author assumes no
  13. responsibility for damages incurred by its usage.  Any resemblance
  14. of this program to any other program, either living or dead, is
  15. purely coincidental.
  16.  
  17.   Feel free to steal this code and make millions of dollars from its sale
  18. or commercial use, but please give credit where credit is due.
  19.  
  20. Synopsis:
  21.  
  22.   Features adaptive columnar listing, versatile sort options,
  23. UNIX-style pattern matching, recursive subdirectory listing, etc!
  24.  
  25. Usage:
  26.     ls [options] [path1] [path2] ...
  27.  
  28. Options:
  29.     -?    Help!
  30.     -c    Show file comment info, -c implies -l
  31.     -d    Show directory names only
  32.     -f    Show filenames only
  33.     -l      Long verbose listing showing filesizes and dates
  34.     -n    No sort, just spit them out in the order ExNext() returns
  35.     -r    Reverse sort direction
  36.     -s    Sorted by size smallest to largest
  37.     -t    Sorted by date oldest to newest
  38.     -R    Recursive descent of subdirectories
  39.  
  40.   All arguments are optional.  Default is to give short columnar listing,
  41. sorted alphabetically, using the current directory.  Alphabetizing is case
  42. insensitive.
  43.  
  44.   Patterns may be matched in the given names, using the UNIX-style '*'
  45. to wildcard any number of characters, and '?' to wildcard a single
  46. character.  If you need to specify a pathname with spaces in it like
  47. "Wombat Soup", you need to put quotes around it.  LS can process up to 30
  48. separate pathname patterns in one command line.
  49.  
  50. Bugs:
  51.  
  52.   Redirecting the shortlist output to PRT: gives undesirable results,
  53. since I am using relative cursor positioning commands to format the
  54. screen output.  I thought about using an array to store a virtual
  55. screen, but my primary goals were to keep the size down and display
  56. speed at a maxiumum.  Also, LS cannot pattern match devices (like "dh*:")
  57. or support multiple levels of pattern matching (like "dh0:?/L*.info").
  58. This would involve another level of recursion and groking the Device List.
  59.  
  60. Changes From 1.0 to 2.0:
  61.  
  62.  o Source code prototyped, linted, traced, optimized, tweaked, etc.
  63.  o Made resident ("pseudo-pure") by linking with cres.o from LC 5.0.
  64.  o High-volume routines recoded in assembly (lssup.a).
  65.  o Now handles multiple paths/files on a command line, up to 30.
  66.  o New sort flags, including no sort.
  67.  o Enhanced wildcards, understands complex *.?*.* expressions now.
  68.  o More efficient ExNext() performance, less ram used for recursion.
  69.  o SIGBREAKF_CTRL_C signal (Ctrl-C) cleanly aborts at any point now.
  70.  o Command line parser handles quoted pathnames now (LC 5.0 benefit).
  71.  o Short listing finally auto-adjusts to new console window sizes!
  72.  o Pen color escape codes bypassed when redirecting long output.
  73.  o Sorting by size or date is also subsorted alphabetically now.
  74.  o Long listing shows new 1.3 file attributes, plus comment indicator.
  75.  o File dates are now in international format, YY-MM-DD.
  76.  o Fixed listings with files datestamped after 99-12-31 (overflow).
  77.  o Fixed listings with files datestamped before 78-01-01 (time < 0).
  78.  
  79.   Don't send me money for this one!  Its a Christmas present 8-)
  80. However, if you find any bugs I'd like to hear about them!
  81.  
  82.         Justin V. McCormick
  83.     8330 E. Quincy Ave., C-312
  84.     Denver, CO 80237
  85.  
  86.         Home: 303-290-8429
  87.     Work: 303-825-4144
  88.