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