Changes between Version 3 and Version 4 of ICgrep


Ignore:
Timestamp:
Feb 28, 2015, 9:34:15 AM (4 years ago)
Author:
cameron
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ICgrep

    v3 v4  
    5959within icGrep with the support of a Google Faculty Research Award.
    6060
     61== ICgrep Regular Expression Syntax ==
     62
     63ICgrep uses an extended regular expression syntax broadly compatible with egrep
     64and including both the "Perl-compatible" extensions of PCRE as well as the
     65Unicode regular expression features of the ICU software distribution.  ICgrep
     66does not support backreferences.  For more details, see the ICgrepSyntax page.
     67
     68== ICgrep Features and Options ==
     69
     70To display the full set of options supported by icGrep, use:
     71{{{
     72icgrep -help
     73}}}
     74
     75=== Standard Grep Options ===
     76
     77{{{
     78  -help                            - Display available options (-help-hidden for more)
     79  -version                         - Display the version of this program
     80  -H                               - Show the file name with each matching line.
     81  -c                               - Count and display the matching lines per file only.
     82  -n                               - Show the line number with each matching line.
     83  -normalize-line-breaks           - Normalize line breaks to std::endl.
     84  -e=<string>                      - Regular expression
     85  -f=<regex file>                  - Take regular expressions (one per line) from a file
     86  -i                               - Ignore case distinctions in the pattern and the file.
     87}}}
     88
     89=== Algorithm Control Options ===
     90
     91The following options are useful for experimentation and/or improved performance
     92in some cases.
     93
     94{{{
     95  -disable-CSE                     - Disable Pablo common subexpression elimination/dead code elimination
     96  -sinking                         - Moves all instructions into the innermost legal If-scope so that they are only executed when needed.
     97  -disable-Unicode-linebreak       - disable Unicode line breaks - use LF only
     98  -disable-Unicode-matchstar       - disable Unicode MatchStar optimization
     99  -disable-log2-bounded-repetition - disable log2 optimizations for bounded repetition of bytes
     100  -disable-matchstar               - disable MatchStar optimization
     101  -if-insertion-gap=<int>          - minimum number of nonempty elements between inserted if short-circuit tests
     102}}}
     103
     104=== Educational/Debugging Options ===
     105
     106The following options are useful for understanding how icGrep works
     107or debugging.
     108
     109{{{
     110  -print-REs                       - print regular expression passes
     111  -print-named-REs                 - print out named REs
     112  -print-parsed-REs                - print out parsed regular expressions
     113  -print-simplified-REs            - print out final simplified REs
     114  -print-stripped-REs              - print out REs with nullable prefixes/suffixes removed
     115  -print-utf8-REs                  - print out UTF-8 REs  -print-CC-pablo                  - print Pablo output from character class compiler
     116  -print-RE-pablo                  - print Pablo output from the regular expression compiler
     117  -print-pablo                     - print final optimized Pablo code
     118  -dump-generated-IR               - print LLVM IR generated by RE compilation
     119}}}
     120
     121
     122
     123
     124
    61125== ICgrep Downloads ==
    62126