home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2694 / README < prev   
Text File  |  1991-02-07  |  3KB  |  91 lines
  1. This is a quick and dirty rehack of my list(C) 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. I've added a little shell script for easy copying and description
  9. generation, named cpl(C).
  10.  
  11.  
  12.     @(#) README    1.2 91/02/07 
  13.  
  14.     Author: Christian Schlichtherle, 1991
  15.         (chris@attron.ruhr.sub.org)
  16.  
  17.     README - Documentation file for list(C).
  18.  
  19.  
  20. NAME
  21.  
  22.     list - Prints documented listings.
  23.  
  24.  
  25. SYNTAX
  26.  
  27.     list [-s] [-a|-A] [-ugd] [-l <listpath>] [<pathname>] ...
  28.     list -U [-k] [-l <listpath>] [<directory>] ...
  29.  
  30.     cpl <file> <file>
  31.     cpl <file> ... <dir>
  32.  
  33.  
  34. DESCRIPTION
  35.  
  36.     list(C) prints a documented listing on standard output. The
  37.     output is formatted. The first field contains the size of the
  38.     file in bytes and the second field the filename. The rest of
  39.     the line contains the description for the file. The lines
  40.     are sorted in increasing ASCII collating sequence (like
  41.     ls(C)).
  42.     The description for the files is held in the file ".list"
  43.     in the directory where the files reside. This file is
  44.     formatted as follows: The first field contains the filename
  45.     and the rest of the line contains the description for the
  46.     file. The lines are sorted in increasing ASCII collating
  47.     sequence.
  48.  
  49.     Options:
  50.  
  51.     -s    Sorts the description lines found in ".list" before
  52.         listing the files. This is useful if your ".list"
  53.         file isn't sorted already.
  54.     -A    Lists filenames beginning with a period for non
  55.         superusers, too.
  56.     -a    Lists all valid entries found in the directory.
  57.     -u    Prints the owner (user) of the file, too.
  58.     -g    Prints the group of the file, too.
  59.     -d    Prints the date of last modification to the file,
  60.         too.
  61.     -l name    Overrides the default filename of the description 
  62.         list ".list". You can use any valid pathname.
  63.  
  64.     The second form of the command 'list -U [<directory> ...]'
  65.     updates the ".list" file. The lines are sorted, descriptions
  66.     for nonexistent files are thrown away and the output is
  67.     formatted.
  68.  
  69.     Options:
  70.  
  71.     -k    Keeps the description file if it is empty after
  72.         updating. Normally the file is removed if it is
  73.         empty after updating.
  74.     -l name    Overrides the default filename of the description 
  75.         list ".list". You can use any valid pathname.
  76.         The update is made to this file instead of the
  77.         default ".list".
  78.  
  79.     You can use cpl(C) for easy copying and description
  80.     generation now. The syntax and semantic is the same as cp(C)
  81.     (in fact, it uses cp(C)) except that it prompts you for
  82.     description lines for the files copied. The syntax of a
  83.     description line is the same as the syntax of a line in the
  84.     ".list" file except that the lines need not be sorted
  85.     (list(C) will do this for you).
  86.  
  87.  
  88. FILES
  89.     
  90.     .list        Description file for listing
  91.