.TH CPS 1 "7 November 1987"
.IX cps#(1) "" "\fLcps\fP(1) \em construct C to \*(Ps interface"
.SH NAME
cps \- construct C to \*(Ps interface
.SH SYNOPSIS
.B cps
[
.B \-c
]
[
.B \-D 
.I symbol
]
[
.B \-I
.I filename
]
[
.B \-i
]
[
.I "\*(Ps file"
]
.#
.SH DESCRIPTION
.LP
\*(Cp compiles a specification file containing 
.L C 
procedure names and 
\*(Ps code into a header file (\fLfilename.h\fP) that can be included
in 
.L C 
programs.  Only one input file can be specified, and if the \fLfilename.h\fP 
file has been previously created, a backup copy of this file will be generated
in the form \fLfilename.h.BAK\fP before the new file is generated.
.sp
The convention is for the input specification file to end in \fL.cps\fP. 
.#
.SH OPTIONS 
.LP
.IP "\fB\-c\fR" 1i
Compiles a \*(Ps file for faster
loading by \*(Sd, and is not used to generate a specification file
for 
.L C
programs.   
For example, the following command line:
.sp
     \f(LBcps -c < input_file > output_file\fP
.sp
will convert the \fIinput_file\fP from the ascii form of the \*(Ps, to the
compressed binary form.  When read by \*(Sd, the \fIoutput_file\fP will execute 
exactly the same as \fIinput_file\fP, except that it will be faster.  
.NS
The \fB\-c\fP option \fBwill not\fP work if the \fIinput_file\fP uses constructs like
\fHcurrentfile readstring\fP, which are often used with the \fHimage\fP primitive.
.NE
.#
.IP "\fB\-D\fP \fIsymbol\fP" 1i
Defines symbols to be passed onto the 
.L C
language pre-processor (\fLcpp\fP) which processes the input file.
.\" The '-D' option passes itself onto 'cpp' (the C language preprocessor), 
.\" which is called to preprocess the input file.  The '-D' is used to define 
.\" symbols as if by '#define' directive.   
.#
.IP "\fB\-I\fP \fIfilename\fP" 1i
Specifies include files. Passed on to the 
.L C
pre-processor.
.\" The '-I' option is similar to the '-D' option, since it also passes itself
.\" onto 'cpp', which is called to preprocess the input file.  The '-I' option
.\" is used to specify include files.
.IP "\fB\-i\fP" 1i
Generates two specification files: one that contains only the
.L C 
procedures and 
\*(Ps code that are user-defined, and one that contains
other definitions required for the 
\fLC\fP-\*(Ps
interface.  For example,
.L ps_open_PostScript 
and 
.L ps_close_PostScript 
would be defined in the second
file. The second file references the user-defined procedures as \fLextern
char\fP. The first file is of the form \fIfilename.c\fP, and the second file
is of the form \fIfilename.h\fP. \fL.BAK\fP files will be generated if the files
already exist.
.sp
This option is valuable for controlling the size of the \*(Cp include files
in multiple source files. The \fIfilename.h\fP would only need to be included 
once.  Each source file would only need to include it's specific 
\fIfilename.c\fP file generated by this option. 
.SH "SEE ALSO"
.LP
.nf
\*(Nm - Chapter 9 "C Client Interface"
.fi
cpp(1) 
.SH TRADEMARK
.LP
\*(Px is a registered trademark of Adobe Systems, Inc.