1[list_begin options]
2[include options_std.inc]
3
4[opt_def -mode [const bulk]|[const incremental]]
5
6The value of this option controls which methods of
7
8[package pt::peg::container] instances are used to specify the
9grammar, i.e. preload it into the container. There are two legal
10values, as listed below. The default is [const bulk].
11
12[list_begin definitions]
13[def [const bulk]]
14
15In this mode the methods [method start], [method add], [method modes],
16and [method rules] are used to specify the grammar in a bulk manner,
17i.e. as a set of nonterminal symbols, and two dictionaries mapping
18from the symbols to their semantic modes and parsing expressions.
19
20[para]
21
22This mode is the default.
23
24[def [const incremental]]
25
26In this mode the methods [method start], [method add], [method mode],
27and [method rule] are used to specify the grammar piecemal, with each
28nonterminal having its own block of defining commands.
29
30[list_end]
31
32[opt_def -template string]
33
34The value of this option is a string into which to put the generated
35code and the other configuration settings. The various locations for
36user-data are expected to be specified with the placeholders listed
37below. The default value is "[const @code@]".
38
39[list_begin definitions]
40
41[def [const @user@]]
42To be replaced with the value of the option [option -user].
43
44[def [const @format@]]
45To be replaced with the the constant [const CONTAINER].
46
47[def [const @file@]]
48To be replaced with the value of the option [option -file].
49
50[def [const @name@]]
51To be replaced with the value of the option [option -name].
52
53[def [const @mode@]]
54To be replaced with the value of the option [option -mode].
55
56[def [const @code@]]
57To be replaced with the generated code.
58
59[list_end]
60[list_end]
61