\." Authors:  Jens Peter Secher (jpsecher@diku.dk)
\."           Arne Glenstrup (panic@diku.dk)
\."           Henning Makholm (makholm@diku.dk)
\." Content:  C-Mix system: Manual page for the analyzer
\." 
\." Copyright © 1999. The TOPPS group at DIKU, U of Copenhagen.
\." Redistribution and modification are allowed under certain
\." terms; see the file COPYING.cmix for details.
@@*@@ this line includes the extra macros for producing nice lists
.TH cmix 1 "" "" ""
.ds )H University of Copenhagen
.ds ]W CMIX **@** ../../release-stamp
.SH NAME
cmix \- The CMIX program specializer
.SH SYNOPSIS
.B cmix
.RI [ option ...]\&
.RI [ filename ...]
.SH DESCRIPTION
CMIX is a program specializer for the C programming language.
.B cmix
reads one more C source files and some
.B specializer directives
and processes them to produce the C source for a
.B generating extension program
which, when compiled and run, produces specialized versions
of the original C source files.
.P
.B cmix
also produces an
.B annotated program listing
which is the contents of the original source files decorated
with binding-time information.
.BR cmixshow (1)
can be used to display the annotated program listing in various
ways.
.P
For more background information, refer to the full User Manual.
.\" Now, include the option and usage summary from running.tex
**@** running.tex
.\" Then the directive summary from directives.tex
**@** directives.tex
.\" Then the user annotation summary from user-ann.tex
**@** user-ann.tex
.\" Include information about shadow header directives
**@** shadow.tex
.SH AUTHOR
CMIX was developed at the University of Copenhagen.
.br
The development team can be reached at
.BR cmix@diku.dk .
.SH BUGS
Probably numerous. Please file as detailed bug reports as you can to
.BR cmix-bugreport@diku.dk .
.SH FILES
.lB
.lI ".B ""#CPP#"""
Used by CMIX to preprocess C input files.
.lI ".B #libdir#/libcmix.a"
The generating extension must be linked with this library
.lI ".B #includedir#/cmix/speclib.h"
Interface definition for
.BR libcmix.a ;
included by the generated extension
.lI ".B #datadir#/cmix/*"
Abstract interfaces for standard headers such as
.BR <stdio.h>.
.lE
(The file names may be different if your system has CMIX installed for
multiple architectures).
.SH SEE ALSO
The full CMIX user manual which should have been installed somewhere
on your system along with CMIX itself.
.br
.BR cmixshow (1).
