home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2662 / README < prev   
Encoding:
Text File  |  1991-02-05  |  2.4 KB  |  78 lines
  1. This is a quick and dirty rehack of my "list" shellscript I posted before.
  2. The source code is not elegant at all, but the program is very _fast_!
  3. The bigger the directory, the faster it is in relation to "ls". Yes, it is
  4. even faster!
  5. Also, this version is more verbose than the old shell script. You can
  6. print the owner, group and last modification date of the file now. You
  7. can even use one description list for several directories...
  8.  
  9.  
  10.     @(#) README    1.1 91/02/04 
  11.  
  12.     Author: Christian Schlichtherle, 1991
  13.         (chris@attron.ruhr.sub.org)
  14.  
  15.     README - Documentation file for list(C).
  16.  
  17.  
  18. NAME
  19.  
  20.     list - Prints documented listings.
  21.  
  22.  
  23. SYNTAX
  24.  
  25.     list [-s] [-a|-A] [-ugd] [-l <listpath>] [<pathname>] ...
  26.     list -U [-k] [-l <listpath>] [<directory>] ...
  27.  
  28.  
  29. DESCRIPTION
  30.  
  31.     list(C) prints a documented listing on standard output. The
  32.     output is formatted. The first field contains the size of the
  33.     file in bytes and the second field the filename. The rest of
  34.     the line contains the description for the file. The lines
  35.     are sorted in increasing ASCII collating sequence (like
  36.     ls(C)).
  37.     The description for the files is held in the file ".list"
  38.     in the directory where the files reside. This file is
  39.     formatted as follows: The first field contains the filename
  40.     and the rest of the line contains the description for the
  41.     file. The lines are sorted in increasing ASCII collating
  42.     sequence.
  43.  
  44.     Options:
  45.  
  46.     -s    Sorts the description lines found in ".list" before
  47.         listing the files. This is useful if your ".list"
  48.         file isn't sorted already.
  49.     -A    Lists filenames beginning with a period for non
  50.         superusers, too.
  51.     -a    Lists all valid entries found in the directory.
  52.     -u    Prints the owner (user) of the file, too.
  53.     -g    Prints the group of the file, too.
  54.     -d    Prints the date of last modification to the file,
  55.         too.
  56.     -l name    Overrides the default filename of the description 
  57.         list ".list". You can use any valid pathname.
  58.  
  59.     The second form of the command 'list -U [<directory> ...]'
  60.     updates the ".list" file. The lines are sorted, descriptions
  61.     for nonexistent files are thrown away and the output is
  62.     formatted.
  63.  
  64.     Options:
  65.  
  66.     -k    Keeps the description file if it is empty after
  67.         updating. Normally the file is removed if it is
  68.         empty after updating.
  69.     -l name    Overrides the default filename of the description 
  70.         list ".list". You can use any valid pathname.
  71.         The update is made to this file instead of the
  72.         default ".list".
  73.  
  74.  
  75. FILES
  76.     
  77.     .list        Description file for listing
  78.