home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 001-099 / ff004.lzh / bm / bm.man < prev    next >
Text File  |  1986-01-01  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))           UUUUNNNNIIIIXXXX 5555....0000 ((((8888 JJJJuuuullllyyyy 1111999988885555))))            BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           bm - search a file for a string
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ////uuuussssrrrr////ppppuuuubbbblllliiiicccc////bbbbmmmm [ option ] ...  [ strings ] [ file ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _B_m searches the input _f_i_l_e_s (standard input default) for
  16.           lines matching a string.  Normally, each line found is
  17.           copied to the standard output.  It is blindingly fast.  _B_m
  18.           strings are fixed sequences of characters: there are no
  19.           wildcards, repetitions, or other features of regular
  20.           expressions.  Bm is also case sensitive.  The following
  21.           options are recognized.
  22.  
  23.           ----xxxx   (Exact) only lines matched in their entirety are
  24.                printed
  25.  
  26.           ----llll   The names of files with matching lines are listed
  27.                (once) separated by newlines.
  28.  
  29.           ----cccc   Only a count of the number of matches is printed
  30.  
  31.           ----eeee ssssttttrrrriiiinnnngggg
  32.                The string is the next argument after the ----eeee flag. This
  33.                allows strings beginning with '-'.
  34.  
  35.           ----hhhh   No filenames are printed, even if multiple files are
  36.                searched.
  37.  
  38.           ----nnnn   Each line is preceded by the number of characters from
  39.                the beginning of the file to the match.
  40.  
  41.           ----ssss   Silent mode.  Nothing is printed (except error
  42.                messages).  This is useful for checking the error
  43.                status.
  44.  
  45.           ----ffff _f_i_l_e
  46.                The string list is taken from the _f_i_l_e.
  47.  
  48.           Unless the ----hhhh option is specified the file name is shown if
  49.           there is more than one input file.  Care should be taken
  50.           when using the characters $ * [ ^ | ( ) and \ in the _s_t_r_i_n_g_s
  51.           (listed on the command line) as they are also meaningful to
  52.           the Shell.  It is safest to enclose the entire _e_x_p_r_e_s_s_i_o_n
  53.           argument in single quotes ' '.
  54.  
  55.           _B_m searches for lines that contain one of the (newline-
  56.           separated) _s_t_r_i_n_g_s, using the Boyer-Moore algorithm.  It is
  57.           far superior in terms of speed to the grep (egrep, fgrep)
  58.           family of pattern matchers for fixed-pattern searching, and
  59.           its speed increases with pattern length.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 1/1/86)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))           UUUUNNNNIIIIXXXX 5555....0000 ((((8888 JJJJuuuullllyyyy 1111999988885555))))            BBBBMMMM((((PPPPUUUUBBBBLLLLIIIICCCC))))
  71.  
  72.  
  73.  
  74.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.           grep(1)
  76.  
  77.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.           Exit status is 0 if any matches are found, 1 if none, 2 for
  79.           syntax errors or inaccessible files.
  80.  
  81.      AAAAUUUUTTTTHHHHOOOORRRR
  82.           Peter Bain (pdbain@wateng), with modifications suggested by
  83.           John Gilmore
  84.  
  85.      BBBBUUUUGGGGSSSS
  86.           Only 100 patterns are allowed.
  87.  
  88.           Patterns may not contain newlines.
  89.  
  90.           If a line (delimited by newlines, and the beginning and end
  91.           of the file) is longer than 8000 charcters (e.g. in a core
  92.           dump), it will not be completely printed.
  93.  
  94.           If multiple patterns are specified, the order of the ouput
  95.           lines is not necessarily the same as the order of the input
  96.           lines.
  97.  
  98.           A line will be printed once for each different string on
  99.           that line.
  100.  
  101.           The algorithm cannot count lines.
  102.  
  103.           The ----nnnn and ----cccc work differently from fgrep.
  104.  
  105.           The ----vvvv,,,, ----iiii,,,, and ----bbbb are not available.
  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 1/1/86)
  130.  
  131.  
  132.  
  133.