2005-09-30 Gonzalo Paniagua Javier <gonzalo@ximian.com>
[mono.git] / mono / monoburg / monoburg.1
index 3d257634a1ad5b97a635f72037b426ab76f675ca..8310de4d5d98541290d988a4cacff39eab27e4e2 100644 (file)
@@ -15,6 +15,7 @@ monoburg \- code generator generator
 [\-p]
 [\-c VALUE]    
 [\-d HEADER]
+[\-DVALUE]
 [FILE...]
 .SH DESCRIPTION
 The \fImonoburg\fP program is used to generate tree pattern matchers 
@@ -27,6 +28,7 @@ spec:      ccode `%%' { dcl } [`%%' ccode]
 
 dcl:       `%start' nonterm
            `%term' { identifier [`=' integer] }
+           `%termprefix' { identifier }
            nonterm `:' tree [cost] [ `{' ccode `}' ] [costfunc]
 
 tree:      term `(' tree `,' tree `)'
@@ -73,7 +75,8 @@ reg:  Fetch (addr)
 .RE
 .fi
 .PP
-
+A simple pre-processor is included, consisting of: %ifdef, %else and
+%endif.  %ifdef operates on definitions from the command line.
 .SH OPTIONS
 The following options are supported:
 .TP
@@ -84,14 +87,19 @@ Displays usage instructions.
 Writes a separate header file which contains all monoburg definitions.
 .TP
 .I "-p"
-Assume termainals are already defined.
+Assume termainals are already defined. Its possible to omit the %term
+definitions in this mode if you use the %termprefix command. All symbols
+starting with a prefix specified in %termprefix are considered to be terminals.
 .TP
 .I "-e"
 Extended mode. Enables monoburg to work with DAGs.
 .TP
 .I "-c VALUE"
 Set the default costs to VALUE
-
+.TP
+.I "-Dvar"
+Defines the variable "var" as true.  This is used with %ifdef, %else
+and %endif in the source files to perform conditional compilation.
 .PP
 .SH AUTHOR
 monoburg was written by Dietmar Maurer. It is based on the papers from