-- ListDoc.tioga
-- last edited by: L. Stewart, December 20, 1983 1:32 pm
name  List:
<<syntax>>
<<List {-switches} list-of-patterns>>
<<The -l switch (long format) causes List to use FS.Enumerate rather than FS.EnumerateForNames.  It runs more slowly, but displays 
more information.>>
<<The -u switch (unbackedup) causes List to display only those files which are not FS attachments and which consequently are not 
backed up anywhere.  List -u * is a good way to get a list of all such files.  List -u *!H is probably most interesting because it 
returns pretty much what DFDisk "Unknown unknown" did.>>
<<The -a switch (print attached), causes printing of attachments.  Forces the l switch on.>>
<<The -k switch (print keep) causes printing of the file keep.  Forces the l switch on.>>
<<The -s switch (separate) causes list to put each file on a separate line.>>
<<The -e switch (everything) is equivalent to -lak.>>
<<The -f switch (full names) causes list to print the full names of files.>>
<<The -r switch (recursive) forces '* to match '/ and '> so you don't have to type **.>>
<<The -o switch (one line) causes the short form printout to list all the files on the same line.  Has no affect on -l form 
printing.>>
<<description>>
<<The list command prints names and possibly information about files in the FS directory system.  It is a user interface for the 
FS.EnumerateForInfo and FS.EnumerateForNames calls.>>
<<List works for both local and remote patterns.
List works in the current working directory if a pattern is not a full path.
List works with both / and [ style filenames.
If a pattern given to List is a directory name, (ends with a '/ or '>) then a '* is appended.>>
<<The pattern '* does not match the characters '/ or '>, but the pattern "**" does.  This means that unless you use "**", List will 
not list any files in subdirectories.  (However, it will list the names of subdirectories.)>>
<<examples>>
<<% list Compiler.log
  []<>Compiler.log!32
% list -l Compiler.log
  Compiler.log!101                   397 14-Dec-83 10:13:16

% List Comp*
Compiler.bcd!1
compiler.load!1
Compiler.log!27
% >>
<<warnings>>
<<List -u * will list only the names of those subdirectories which contain unbacked-up files, not the names of all subdirectories.>>
<<List -ur * means List -ur *!*, which will likely tell you about unbacked-up files that you don't care about.  Try List -ur *!H or 
List -u **!H.>>
<<The level slicing enumeration isn't quite right at the moment: List /Ivy/Stewart/T*/A* will never return anything, because the 
List implementation says "Strip off the prefix before the first *.  If there is a '/ in what is left, ignore the file."  Someday 
this may improve.>>
<<stop/undo >>
<<Click the STOP! button.>>
<<implementation >>
<<FSFileCommandsImpl.mesa in CommandTool.df>>
<<contact>>
<<L. C. Stewart <Stewart.pa>>>
<<keyword hints>>
<<
help button info man>>
<<keywords>>
<<
to be supplied by the Index Czar>>