[hcoop/zz_old/debian/smlnj.git] / debian / ml-burg.1

.TH ml-burg 1 "November 14, 2002"
.SH NAME
ml-burg \- a tree parser generator for Standard ML
.SH SYNOPSIS
.B ml-burg
.IR file .burg
.br
.SH DESCRIPTION
This manual page documents briefly the
.B ml-burg
command.
This manual page was written for the Debian distribution
because the original program does not have a manual page.

The
.B ml-burg
program generates a Standard ML program to perform bottom-up rewriting
of an input tree. Cost information associated with each rewrite rule
is used to derive the minimum rewrite cost for the entire tree. A
successful reduction corresponds to rewriting the input tree to a
special non-terminal symbol called the 
.IR "start non-terminal" .
Upon successful reduction, facilities are provided to walk the tree
emitting semantic actions corresponding to the rules that matched.

When
.IR ml-burg " is presented with " file ".burg, the file " file ".sml"
is generated. 
.SH SEE ALSO
.BR sml (1),
.BR ml-lex (1),
.BR ml-yacc (1),
.BR ml-makedepend (1),
.BR ml-build (1).
.br
The programs are documented fully by
.IR "The ML-Burg -- Documentation" ", Florent Guillaume and Lal George, "
which is available in 
.IR /usr/share/doc/ml-burg/doc.pdf .
.SH AUTHOR
This manual page was written by Aaron Matthew Read <amread@nyx.net>,
for the Debian GNU/Linux system (but may be used by others)
Commit	Line	Data
4dd335d4 JM	1	.TH ml-burg 1 "November 14, 2002"
	2	.SH NAME
	3	ml-burg \- a tree parser generator for Standard ML
	4	.SH SYNOPSIS
	5	.B ml-burg
	6	.IR file .burg
	7	.br
	8	.SH DESCRIPTION
	9	This manual page documents briefly the
	10	.B ml-burg
	11	command.
	12	This manual page was written for the Debian distribution
	13	because the original program does not have a manual page.
	14
	15	The
	16	.B ml-burg
	17	program generates a Standard ML program to perform bottom-up rewriting
	18	of an input tree. Cost information associated with each rewrite rule
	19	is used to derive the minimum rewrite cost for the entire tree. A
	20	successful reduction corresponds to rewriting the input tree to a
	21	special non-terminal symbol called the
	22	.IR "start non-terminal" .
	23	Upon successful reduction, facilities are provided to walk the tree
	24	emitting semantic actions corresponding to the rules that matched.
	25
	26	When
	27	.IR ml-burg " is presented with " file ".burg, the file " file ".sml"
	28	is generated.
	29	.SH SEE ALSO
	30	.BR sml (1),
	31	.BR ml-lex (1),
	32	.BR ml-yacc (1),
	33	.BR ml-makedepend (1),
	34	.BR ml-build (1).
	35	.br
	36	The programs are documented fully by
	37	.IR "The ML-Burg -- Documentation" ", Florent Guillaume and Lal George, "
	38	which is available in
	39	.IR /usr/share/doc/ml-burg/doc.pdf .
	40	.SH AUTHOR
	41	This manual page was written by Aaron Matthew Read <amread@nyx.net>,
	42	for the Debian GNU/Linux system (but may be used by others)