1 05/10/84  hunt
 2 
 3 Syntax as a command:  hunt name {path} {-control_args}
 4 
 5 
 6 Syntax as an active function:  [hunt name {path} {-control_args}]
 7 
 8 
 9 Function:  searches a specified subtree of the hierarchy for all
10 occurrences of a named segment that is either freestanding or included
11 in an archive file.
12 
13 
14 Arguments:
15 name
16    is the name of a segment for which hunt is to search.  The star
17    convention is allowed.
18 path
19    is the pathname of a directory to be interpreted as the root of the
20    subtree in which to search for the specified segment(s).  If you
21    don't supply path, the subtree rooted at the current working
22    directory is searched.
23 
24 
25 Control arguments:
26 -all, -a
27    reports on finding links, directories, and segments.
28 -archive, -ac
29    looks inside archives for components whose names match the name
30    argument.  (Default)
31 -first
32    stops searching as soon as the first occurrence of the selected
33    segment is found.  The default is to return all occurrences.
34 -no_archive, -nac
35    does not look inside archives and is therefore faster.
36 
37 
38 Notes:  This command displays the type of entry found (segment,
39 directory, or link), followed by the entry itself, and a total of the
40 number of occurrences found.
41 
42 If archive components are being examined, the matching components are
43 reported before added names on the archive segment.
44 
45 
46 Notes on active function:  As an active function, hunt returns a string
47 of pathnames separated by spaces.  Archive components are returned as
48 archive_path::component_name.