home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 35 / hot35.iso / ficheros / LPAS / YG605W95.ZIP / YFIND.MAN < prev    next >
Text File  |  1998-04-13  |  4KB  |  115 lines
  1. YFind(1)                  User Commands                  YFind(1)
  2.  
  3.  
  4.  
  5.  NAME
  6.      YFind - search a file for a pattern
  7.  
  8.  SYNOPSIS
  9.       YFind [ -bchilnsvwBSVF[0-9] ]  regular-expression
  10.           [ filename ... ]
  11.  
  12.  
  13.  DESCRIPTION
  14.      The YFind command searches files for a  pattern  and  prints
  15.      all  lines  that  contain  that  pattern.
  16.  
  17.      Normally, each line found is copied to standard output.  The
  18.      file name is printed before each line found if there is more
  19.      than one input file.
  20.  
  21.      Filenames can be specified with MS-DOS  "wild chars" such as
  22.      * and ? (common in most MS-DOS applications for "any string"
  23.      and "any character").
  24.  
  25.  
  26.  OPTIONS
  27.      The following options are supported:
  28.  
  29.        -S           Do not  interpret  the pattern  as a  regular
  30.                     expression,  but as a plain text and  use the
  31.             Soundex  algorithm  (match words sounding the
  32.             same as the pattern).
  33.  
  34.        -[0-9]       Do not  interpret  the pattern  as a  regular
  35.                     expression,  but as a plain text  and allow 0
  36.             (exact  match)   to  9  errors/approximations
  37.             (very imprecise match).
  38.  
  39.        -b           Precede each line  by  the  block  number  on
  40.                     which  it  was  found.  This can be useful in
  41.                     locating  block  numbers  by  context  (first
  42.                     block is 0, each block is 512 bytes long).
  43.  
  44.        -c           Print only a count of the lines that  contain
  45.                     the pattern.
  46.  
  47.        -f           Precede each line by the name of the file.
  48.  
  49.        -i           Ignore upper/lower  case  distinction  during
  50.                     comparisons.
  51.  
  52.        -n           Precede each line by its line number  in  the
  53.                     file (first line is 1).
  54.  
  55.        -B           Read all files as binary strings rather than
  56.                     text lines (may be twice slower, but needed for
  57.             files containing NULL characters).
  58.  
  59.        -s           Suppress error messages about nonexistent  or
  60.                     unreadable files
  61.  
  62.        -v           Print all lines except those that contain the
  63.                     pattern.
  64.  
  65.        -V           Display  version number  of the  YGrep Search
  66.                     Engine used.
  67.  
  68.        -F           Stop on first displayed message. Faster.
  69.  
  70.        -?           Display  minimal help line  with the  list of
  71.                     options.
  72.  
  73.  
  74.  EXAMPLES
  75.      To find all uses of the word "Posix" (in any  case)  in  the
  76.      file  text.mm, and write with line numbers:
  77.  
  78.            example% YFind -i -n posix text.mm
  79.  
  80.      To find all empty lines in the standard input:
  81.  
  82.            example% YFind ^$
  83.      or
  84.            example% YFind -v .
  85.  
  86.      To find all uses of either "toto", "tota" or "toti"  in  the
  87.      file  text.txt, and write with line numbers:
  88.  
  89.            example% YFind -1 -n toto text.txt
  90.  
  91.  EXIT STATUS
  92.      The following exit values are returned:
  93.  
  94.        0            one or more matches were found
  95.  
  96.        1            no matches were found
  97.  
  98.        2 or more    syntax errors or inaccessible files (even  if
  99.                     matches were found).
  100.  
  101.  NOTES
  102.      When conflicting options are set, the following order decides
  103.      which one will be choosen:
  104.       >> Most influential
  105.         - Soundex (-S)
  106.     - Approximative (-[1-9])
  107.     - exact match (-0)
  108.     - regular expressions (others)
  109.       >> Least influential
  110.  
  111.  INSTALLATION
  112.      YFind is to be installed in the same directory as YGrep32.DLL
  113.      in order to  find it when needed for operation.  The simplest
  114.      location is certainly the C:\WINDOWS directory.
  115.