home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 262.lha / ArpDoc_v1.3 / Search < prev    next >
Text File  |  1989-07-01  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      Search(V1.3)            ARP User's Manual            Search(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           Search - Search a file or files for a name or pattern.
  10.  
  11.      SYNOPSIS
  12.           Search From/a Search ALL/s NONUM/s QUIET/s QUICK/s FILE/s
  13.           CASE/s
  14.  
  15.      DESCRIPTION
  16.           Use Search to hunt for patterns or strings in files.  As
  17.           usual, you can specify the files using a wildcard pattern,
  18.           and you can also specify a directory to be searched.  Search
  19.           also allows itself to be used in the middle of a pipeline.
  20.           To do this, you must use the filename STDIN, and it must be
  21.           spelled in UPPER CASE.
  22.  
  23.           The ARP Search also allows you to specify a wildcard pattern
  24.           as the search string, which the BCPL version still does not.
  25.           Any valid ARP pattern may be used as the search string.
  26.  
  27.           If a search object is found, then Search will return 0,
  28.           otherwise it will return with the WARN faillevel set.  This
  29.           makes Search usable in scripts (see also QUIET, below).
  30.  
  31.           When searching through more than one file at a time, you can
  32.           use C-e or C-f (Control E or Control F) to abandon the
  33.           current file and move on to the next. (NOTE: This is
  34.           different from the Commodore BCPL search, which uses C-d
  35.           (Control d).  Using C-e and C-f prevents conflicts with
  36.           using C-d in script files, since C-d will abort a script
  37.           file.)  As usual, to kill the program, use C-c (Control C).
  38.  
  39.           ARP's Search places the last pattern you used in an
  40.           environment variable called "Search".  If you reuse Search
  41.           at a later time, and omit the search string, Search will use
  42.           the value of this Environment variable. This is convenient
  43.           when searching for complex patterns over and over again on
  44.           different disks or directories.  This is also available to
  45.           other programs to use if desired.
  46.  
  47.      OPTIONS
  48.           ALL  Recursively descend all directories in the specified
  49.                branch of the directory tree, searching each file for
  50.                the pattern specified.
  51.  
  52.           NONUM
  53.                Do not display line numbers.  This option will also
  54.                kill the indent Search usually adds to the lines it
  55.                displays.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Search(V1.3)            ARP User's Manual            Search(V1.3)
  71.  
  72.  
  73.  
  74.           QUIET
  75.                Search without displaying found lines.  This is useful
  76.                when you only want to get the return code from Search
  77.                (for example, in a script file).
  78.  
  79.           QUICK
  80.                This causes Search to use a more compact output format
  81.                to speed up display.  NOTE - when using SEARCH from
  82.            an interactive CLI, this is the DEFAULT.
  83.  
  84.           FILE This causes Search to hunt for a file of the specified
  85.                name, rather than searching through the contents
  86.            of the files.
  87.  
  88.           CASE This causes Search to consider case as important in
  89.                comparing search patterns. Ordinarily, case is ignored
  90.                during a search.
  91.  
  92.      EXAMPLES
  93.           Search SYS:INCLUDE/exec/*.h SIG?_*
  94.  
  95.           The command line above demonstrates the use of wildcard
  96.           patterns in both the FROM and the SEARCH string positions.
  97.           This will cause Search to look at all files in
  98.           SYS:INCLUDE/exec which end with the characters '*.h', for
  99.           all strings which begin with the three characters 'SIG',
  100.           followed by any character, followed by an underscore,
  101.           followed by anything.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/28/89)
  130.  
  131.  
  132.  
  133.