.TH KC 1 "May 13, 1996"
.SH NAME
kc \- generate C code from Kimwitu input
.SH SYNOPSIS
.B kc
.B [
.I file\fB.k\fI ...
.B ]
.br
.B kc --version
.SH DESCRIPTION
.B kc
reads the abstract syntax definition, function definitions,
rewrite rules and unparse rules from the files given on the
command line, or from the standard input if no file arguments
were given, and generates for each
.I file\fB.k\fI
input file a pair of
.I file\fB.c\fI
and a 
.I file\fB.h\fI
files that contain the translation of the functions defined in the
corresponding
.I file\fB.k\fI,
in addition to the files that are always generated:
.B csgiok.[ch],
.B rk.[ch]
and
.B unpk.[ch]
files,
that contain respectively the CSGIO-, the rewrite- and the unparse-functions,
and the
.B k.c
and
.B k.h
files that contain the grammar tables and the remaining `default' functions.
If no command line file arguments are given, the translation of the
user-defined functions will be generated in
.B stdin.[ch]
files.
.LP
.B kc
does not unnecessarily overwrite a file: if a file would be overwritten
with its own (identical) contents, it will not be touched.
This makes it easy to write an efficient Makefile.
.SH OPTIONS
.IP \fB--version\fR 12
print the version number of
.B kc
and exit
(this option is not available in
.B kc
versions older than V3_9P3)
.SH GENERATED FILES
.IP k.[ch] 12
the grammar and default functions
.IP rk.[ch] 12
the rewrite view declarations and rewrite functions
.IP csgiok.[ch] 12
the CSGIO functions
.IP unpk.[ch] 12
the unparse view declarations and unparsing functions
.IP \fIfile\fR.[ch] 12
translation of user-provided Kimwitu functions.
.IP stdin.[ch] 12
translation of user-provided Kimwitu functions if no command line
file arguments were given.
.SH DIAGNOSTICS
If an error is encountered in the Kimwitu input, an apropriate error
message will be written on standard error, code generation
will be suppressed and a non-zero exit value will be returned.
The error messages should be self-explanatory.
.SH AUTHOR
Axel Belinfante, University of Twente, the Netherlands.
.SH CONTACT
By Email: <kimwitu@cs.utwente.nl>
.SH VERSION
This manual page documents kc V3_* and newer.