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)