home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / progm / c-util.zip / GREP.DOC < prev    next >
Text File  |  1984-02-05  |  3KB  |  76 lines
  1.                         GREP
  2.                         ====
  3.  
  4. GREP searches a file for a given pattern.  Execute by:
  5.  
  6.    grep [flags] regular_expression file_list
  7.  
  8. Flags are single characters preceeded by '-':
  9.    -c      Only a count of matching lines is printed
  10.    -f      Print file name for matching lines switch, see below
  11.    -n      Each line is preceeded by its line number
  12.    -v      Only print non-matching lines
  13. The file_list is a list of files.
  14.  
  15. The file name is normally printed if there is a file given.
  16. The -f flag reverses this action (print name no file, not if more).
  17.  
  18. The regular_expression defines the pattern to search for.  Upper- and
  19. lower-case are always ignored.  Blank lines never match.  The expression
  20. should be quoted to prevent file-name translation.
  21.  
  22. x      An ordinary character (not mentioned below) matches that character.
  23. '\'    The backslash quotes any character.  "\$" matches a dollar-sign.
  24. '^'    A circumflex at the beginning of an expression matches the
  25.        beginning of a line.
  26. '$'    A dollar-sign at the end of an expression matches the end of a line.
  27. '.'    A period matches any character except "new-line".
  28. ':a'   A colon matches a class of characters described by the following
  29. ':d'     character.  ":a" matches any alphabetic, ":d" matches digits,
  30. ':n'     ":n" matches alphanumerics, ": " matches spaces, tabs, and
  31. ': '     other control characters, such as new-line.
  32. '*'    An expression followed by an asterisk matches zero or more
  33.        occurrances of that expression: "fo*" matches "f", "fo"
  34.        "foo", etc.
  35. '+'    An expression followed by a plus sign matches one or more
  36.        occurrances of that expression: "fo+" matches "fo", etc.
  37. '-'    An expression followed by a minus sign optionally matches
  38.        the expression.
  39. '[]'   A string enclosed in square brackets matches any character in
  40.        that string, but no others.  If the first character in the
  41.        string is a circumflex, the expression matches any character
  42.        except "new-line" and the characters in the string.  For
  43.        example, "[xyz]" matches "xx" and "zyx", while "[^xyz]"
  44.        matches "abc" but not "axb".  A range of characters may be
  45.        specified by two characters separated by "-".  Note that,
  46.        [a-z] matches alphabetics, while [z-a] never matches.
  47. The concatenation of regular expressions is a regular expression.
  48.  
  49. History:
  50.  
  51. Obtained from the CP/M SIG on CompuServe in 1983.  The program
  52. program contained this notice:
  53.  
  54.    The  information  in  this  document  is  subject  to  change
  55.    without  notice  and  should not be construed as a commitment
  56.    by Digital Equipment Corporation or by DECUS.
  57.  
  58.    Neither Digital Equipment Corporation, DECUS, nor the authors
  59.    assume any responsibility for the use or reliability of  this
  60.    document or the described software.
  61.  
  62.         Copyright (C) 1980, DECUS
  63.  
  64.    General permission to copy or modify, but not for profit,  is
  65.    hereby  granted,  provided that the above copyright notice is
  66.    included and reference made to  the  fact  that  reproduction
  67.    privileges were granted by DECUS.
  68.  
  69.    Runs on the Decus compiler or on vms.
  70.    Converted for BDS compiler (under CP/M-80), 20-Jan-83, by Chris Kern.
  71.  
  72. Converted to IBM PC with CI-C86 C Compiler June 1983 by David N. Smith.
  73. (CompuServe 73145,153. Address: 44 Ole Musket Lane, Danbury, CT 06810)
  74. Compiled using DeSmet in November 1983.
  75.  
  76.