OLD | NEW |
1 libadblockplus | 1 libadblockplus |
2 ============== | 2 ============== |
3 | 3 |
4 A C++ library offering the core functionality of Adblock Plus. | 4 A C++ library offering the core functionality of Adblock Plus. |
5 | 5 |
6 libadblockplus is still work in progress, at an early stage. | 6 libadblockplus is still work in progress, at an early stage. |
7 | 7 |
8 Building | 8 Building |
9 -------- | 9 -------- |
10 | 10 |
11 ### Unix | 11 ### Unix |
12 | 12 |
13 All you need is Python 2.6 and Make: | 13 All you need is Python 2.6 and Make: |
14 | 14 |
15 make | 15 make |
16 | 16 |
17 The default target architecture is x64. On a 32 bit system, run: | 17 The default target architecture is x64. On a 32 bit system, run: |
18 | 18 |
19 make ARCH=ia32 | 19 make ARCH=ia32 |
20 | 20 |
21 To build and run the tests: | 21 To build and run the tests: |
22 | 22 |
23 make test | 23 make test |
24 | 24 |
25 Likewise, use the following on a 32 bit system: | 25 Likewise, use the following on a 32 bit system: |
26 | 26 |
27 make test ARCH=ia32 | 27 make test ARCH=ia32 |
28 | 28 |
| 29 To run specific tests, you can specify a filter: |
| 30 |
| 31 make test FILTER=*.Matches |
| 32 |
29 ### Windows | 33 ### Windows |
30 | 34 |
31 You need Microsoft Visual C++ (Express is sufficient) 2012 | 35 You need Microsoft Visual C++ (Express is sufficient) 2012 |
32 and Python 2.6. Make sure that `python.exe` is on your `PATH`. | 36 and Python 2.6. Make sure that `python.exe` is on your `PATH`. |
33 | 37 |
34 * Execute `createsolution.bat` to generate project files, this will create | 38 * Execute `createsolution.bat` to generate project files, this will create |
35 `build\ia32\libadblockplus.sln` (solution for the 32 bit build) and | 39 `build\ia32\libadblockplus.sln` (solution for the 32 bit build) and |
36 `build\x64\libadblockplus.sln` (solution for the 64 bit build). Unfortunately, | 40 `build\x64\libadblockplus.sln` (solution for the 64 bit build). Unfortunately, |
37 V8 doesn't support creating both from the same project files. | 41 V8 doesn't support creating both from the same project files. |
38 * Open `build\ia32\libadblockplus.sln` or `build\x64\libadblockplus.sln` in | 42 * Open `build\ia32\libadblockplus.sln` or `build\x64\libadblockplus.sln` in |
(...skipping 28 matching lines...) Expand all Loading... |
67 Its behavior induces some restrictions on the way we're able to use `gyp`. | 71 Its behavior induces some restrictions on the way we're able to use `gyp`. |
68 For the full story, see the extended `gyp` documentation. | 72 For the full story, see the extended `gyp` documentation. |
69 | 73 |
70 * All our own command line tools have to have arguments that | 74 * All our own command line tools have to have arguments that |
71 either (a) begin with a hyphen or slash, | 75 either (a) begin with a hyphen or slash, |
72 or (b) are path names. Sounds bizarre? I'm with you. | 76 or (b) are path names. Sounds bizarre? I'm with you. |
73 * We can't support spaces in path or file names. | 77 * We can't support spaces in path or file names. |
74 Strictly speaking, that's only for some path names in certain situations. | 78 Strictly speaking, that's only for some path names in certain situations. |
75 But please, make everyone's lives easier. | 79 But please, make everyone's lives easier. |
76 Just don't do it. | 80 Just don't do it. |
OLD | NEW |