Return to cgrep CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/cgrep, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: cgrep                        Command                        cgrep
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Pattern search for C source programs
                      9: 
                     10: ccggrreepp [-ccllnnssAA] [-rr _n_e_w] _e_x_p_r_e_s_s_i_o_n _f_i_l_e ...
                     11: 
                     12: ccggrreepp is a  string-search utility.  It resembles its cousins ggrreepp
                     13: and eeggrreepp, except that it is specially designed to be used with C
                     14: source files.  It checks all C identifiers against _e_x_p_r_e_s_s_i_o_n and
                     15: prints all lines in which it  finds a match.  ccggrreepp allows you to
                     16: search for  a variable named  `i' without finding  every `if' and
                     17: `int' in your program.  ccggrreepp defines an ``identifier'' to be any
                     18: variable  name  or  C  keyword.   _e_x_p_r_e_s_s_i_o_n  can  be  a  regular
                     19: expression; if it  includes wildcard characters or `|'s, you must
                     20: ``quote it''  to protect it against being  modified by the shell.
                     21: For details on the  expressions that ccggrreepp can recognize, see the
                     22: Lexicon entry for eeggrreepp.
                     23: 
                     24: ccggrreepp tests names that include the `.' and `->' operators against
                     25: _e_x_p_r_e_s_s_i_o_n. Thus, to look for ppttrr->vvaall, type:
                     26: 
                     27: 
                     28:         cgrep "ptr->val" x.c
                     29: 
                     30: 
                     31: This finds  ppttrr->vvaall even if it contains  spaces, comments, or is
                     32: spread across  lines.  If it  is spread across lines,  it will be
                     33: reported  on the  line that  contains the  last token.   The only
                     34: exception is if you include the  -AA option, in which case it will
                     35: be reported on the line  which contains the first token.  This is
                     36: to simplify MicroEMACS macros, as will be described below.
                     37: 
                     38: To find ssttrruuccttuurree.mmeemmbbeerr, type:
                     39: 
                     40: 
                     41:         cgrep "structure\.member"
                     42: 
                     43: 
                     44: because `.' in a regular expression matches any character.
                     45: 
                     46: Do not  include spaces in any pattern.   Only identifiers and `.'
                     47: or `->'  between identifiers are  included in the  tokens checked
                     48: for pattern-matching.
                     49: 
                     50: ***** Command-line Options *****
                     51: 
                     52: ccggrreepp recognizes the following command-line options:
                     53: 
                     54: -cc   Print  all  comments  in  each  _f_i_l_e.  This  form  takes  no
                     55:      expression.
                     56: 
                     57: -ll   List  only the  names of  the files  in which  _e_x_p_r_e_s_s_i_o_n is
                     58:      found.
                     59: 
                     60: -nn   Prefix each line in  which _e_x_p_r_e_s_s_i_o_n is found with its line
                     61:      number in the file.
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: cgrep                        Command                        cgrep
                     70: 
                     71: 
                     72: 
                     73: 
                     74: -rr   Replace all  expression matches  with _n_e_w.  This  option may
                     75:      not be  used with any  others, and it can  only match simple
                     76:      tokens, not  items like ppttrr->vvaall.   When -rr is  used and the
                     77:      input is ssttddiinn, a new file will always be created as ssttddoouutt.
                     78: 
                     79: -ss   Print  all  strings   in  each  _f_i_l_e.  This  form  takes  no
                     80:      expression.
                     81: 
                     82: -AA   Write  all  lines  in  which  _e_x_p_r_e_s_s_i_o_n  is  found  into  a
                     83:      temporary file.  Then, call MicroEMACS with its error option
                     84:      to  process  the  source  file,  with  the contents  of  the
                     85:      temporary file  serving as  an ``error'' list.   This option
                     86:      resembles  the -AA  option to  the cccc  command, and  lets you
                     87:      build a MicroEMACS  script to make systematic changes to the
                     88:      source  file.  To  exit  MicroEMACS and  prevent ccggrreepp  from
                     89:      searching further, <ccttrrll-UU> <ccttrrll-XX> <ccttrrll-CC>.
                     90: 
                     91: ***** Examples *****
                     92: 
                     93: The command
                     94: 
                     95: 
                     96:         cgrep tmp *.c
                     97: 
                     98: 
                     99: will  find  the  variable  name  ttmmpp,  but not  ttmmppnnaammee,  or  any
                    100: occurrence of ttmmpp in a string or comment.
                    101: 
                    102: The script
                    103: 
                    104: 
                    105:         cgrep -c < myfile.c | wc -l
                    106: 
                    107: 
                    108: count the lines of comments in mmyyffiillee.cc.
                    109: 
                    110: The command
                    111: 
                    112: 
                    113:         cgrep "x|abc|d" *.c
                    114: 
                    115: 
                    116: will find  xx, aabb, dd.  Note this is  a regular expressions  with a
                    117: surrounding  ``^(  )$'' which  is  applied  to every  identifier.
                    118: Thus, rreegg* will not match rreeggiisstteerr, but rreegg.* will.
                    119: 
                    120: ***** See Also *****
                    121: 
                    122: ccoommmmaannddss, eeggrreepp, ggrreepp, mmee
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.