README
1LibCSS -- a CSS parser and selection engine
2===========================================
3
4Overview
5--------
6
7 LibCSS is a CSS parser and selection engine. It aims to parse the forward
8 compatible CSS grammar.
9
10Requirements
11------------
12
13 LibCSS requires the following tools:
14
15 + A C99 capable C compiler
16 + GNU make or compatible
17 + Pkg-config
18 + Perl (for the testcases)
19 + Python3 (minimum 3.6, for generated selection code)
20
21 LibCSS also requires the following libraries to be installed:
22
23 + LibParserUtils
24 + LibWapcaplet
25
26Compilation
27-----------
28
29 If necessary, modify the toolchain settings in the Makefile.
30 Invoke make:
31
32 $ make
33
34Regenerating generated selection source code
35--------------------------------------------
36
37 To regenerate the selection sources (computed style data accesses),
38 note this requires python3:
39
40 $ make select_generator
41
42Verification
43------------
44
45 To verify that the parser is working, it is necessary to specify a
46 different makefile target than that used for normal compilation, thus:
47
48 $ make test
49
50API documentation
51-----------------
52
53 Currently, there is none. However, the code is well commented and the
54 public API may be found in the "include" directory. The testcase sources
55 may also be of use in working out how to use it.
56
57