CPS(1) — USER COMMANDS
NAME
cps − construct C to interface
SYNOPSIS
cps [ −c ] [ −D symbol ] [ −I filename ] [ −i ] [ file ]
DESCRIPTION
compiles a specification file containing procedure names and code into a header file (filename.h) that can be included in programs. Only one input file can be specified, and if the filename.h file has been previously created, a backup copy of this file will be generated in the form filename.h.BAK before the new file is generated. The convention is for the input specification file to end in .cps.
OPTIONS
−cCompiles a file for faster loading by , and is not used to generate a specification file for programs. For example, the following command line: cps -c < input_file > output_file will convert the input_file from the ascii form of the , to the compressed binary form. When read by , the output_file will execute exactly the same as input_file, except that it will be faster. The −c option will not work if the input_file uses constructs like currentfile readstring, which are often used with the image primitive.
−D symbolDefines symbols to be passed onto the language pre-processor (cpp) which processes the input file.
−I filenameSpecifies include files. Passed on to the pre-processor.
−iGenerates two specification files: one that contains only the procedures and code that are user-defined, and one that contains other definitions required for the C- interface. For example, and would be defined in the second file. The second file references the user-defined procedures as extern char. The first file is of the form filename.c, and the second file is of the form filename.h. .BAK files will be generated if the files already exist. This option is valuable for controlling the size of the include files in multiple source files. The filename.h would only need to be included once. Each source file would only need to include it’s specific filename.c file generated by this option.
SEE ALSO
- Chapter 9 "C Client Interface"
TRADEMARK
is a registered trademark of Adobe Systems, Inc.
Sun Release 4.1 — Last change: 7 November 1987