1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin page_util_norm_lemon n 1.0]
[copyright {2007 Andreas Kupries <andreas_kupries@users.sourceforge.net>}]
[moddesc {Parser generator tools}]
[titledesc {page AST normalization, LEMON}]
[category {Page Parser Generator}]
[require page::util::norm_lemon [opt 0.1]]
[require snit]
[keywords page lemon normalization {tree walking} {graph walking}]
[keywords {parser generator} {text processing}]
[description]
[para]
This package provides a single utility command which takes an AST for a
lemon grammar and normalizes it in various ways. The result
is called a [term {Normalized Lemon Grammar Tree}].
[para]
[emph Note] that this package can only be used from within a plugin
managed by the package [package page::pluginmgr].
[comment {
TODO: Document the structure of a LEMON AST,
and then of a Normalized LEMON Tree. Which
is not a true AST any longer.
}]
[section API]
[list_begin definitions]
[call [cmd ::page::util::norm::lemon] [arg tree]]
This command assumes the [arg tree] object contains for a lemon
grammar. It normalizes this tree in place. The result is called a
[term {Normalized Lemon Grammar Tree}].
[para]
The exact operations performed are left undocumented for the moment.
[list_end]
[section {BUGS, IDEAS, FEEDBACK}]
This document, will undoubtedly contain bugs and other problems.
Please report such in the category [emph page] of the
[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
Please also report any ideas for enhancements you may have.
[manpage_end]
|
