KC(1)							      General Commands Manual							     KC(1)

NAME

       kc - generate C code from Kimwitu input

SYNOPSIS

       kc [ file.k ...	]
       kc --version

DESCRIPTION

       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 file.k input file a pair of file.c and a file.h files  that
       contain	the  translation  of  the  functions  defined  in  the	corresponding  file.k, in addition to the files that are always generated:
       csgiok.[ch], rk.[ch] and unpk.[ch] files, that contain respectively the CSGIO-, the rewrite- and the unparse-functions, and the k.c and 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 stdin.[ch] files.

       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.

OPTIONS

       --version   print the version number of kc and exit (this option is not available in kc versions older than V3_9P3)

GENERATED FILES

       k.[ch]	   the grammar and default functions

       rk.[ch]	   the rewrite view declarations and rewrite functions

       csgiok.[ch] the CSGIO functions

       unpk.[ch]   the unparse view declarations and unparsing functions

       file.[ch]   translation of user-provided Kimwitu functions.

       stdin.[ch]  translation of user-provided Kimwitu functions if no command line file arguments were given.

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.

AUTHOR

       Axel Belinfante, University of Twente, the Netherlands.

CONTACT

       By Email: <kimwitu@cs.utwente.nl>

VERSION

       This manual page documents kc V3_* and newer.

								   May 13, 1996 							     KC(1)