source: icGREP/icgrep-devel/README-icgrep-0.9.txt @ 4128

Last change on this file since 4128 was 4039, checked in by cameron, 5 years ago

Release notes for icgrep-0.9

File size: 1.9 KB
Line 
1README-icgrep-0.9.txt
2
3This is the open-source version of icgrep 0.9.   icgrep is a
4very fast regular expression search program, particularly
5for complex regular expressions.   
6
7Normal usage to find lines in a file f matching a regexp r is:
8icgrep r f
9
10To produce a count of matching lines only, use the command:
11icgrep -c r f
12
13To read the regexp to be matched from file rf use the command:
14
15icgrep -f rf f
16
17icgrep supports standard egrep syntax, except for Posix character
18classes.   icgrep supports searches using ASCII or UTF-8. 
19Unicode two letter classes are supported, e.g. \p{Ll} matching
20lower case Unicode letters and \P{Lu} matching all characters
21that are not upper case letters.
22
23Full Unicode level 1 support is planned for icgrep 1.0.
24
25BUILD
26
27To build icgrep, you need an installed LLVM system providing the
28core libraries.  The distribution includes a suitable source
29code version of LLVM.
30
31To build LLVM,
32(L1) open a terminal window and cd to the llvm-build directory
33(L2) enter the following command to build the makefiles
34cmake -DCMAKE_INSTALL_PREFIX=../libllvm -DLLVM_TARGETS_TO_BUILD=X86 -DLLVM_BUILD_TOOLS=OFF -DLLVM_BUILD_EXAMPLES=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER:FILEPATH=/usr/bin/clang++ -DCMAKE_C_COMPILER:FILEPATH=/usr/bin/clang ../llvm-3.4.2.src
35(L3) Still in the llvm-build directory, enter the commands "make" and then "make install"
36
37Using the installed LLVM, building icgrep uses the CMake build
38system generator.   
39(IC1)  open a terminal window and cd to the icgrep-build directory
40(IC2)  enter the following command to build the makefiles
41cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER:FILEPATH=/usr/bin/clang++ -DCMAKE_C_COMPILER:FILEPATH=/usr/bin/clang ../icgrep
42(IC3) Enter the command "make"
43
44LLVM files are governed by the LLVM Release License in LLVM-LICENSE.txt.
45icgrep is governed by Open Software License 3.0 in OSL-3.0.txt.
46
47
Note: See TracBrowser for help on using the repository browser.