[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
CA-Clipper Compiler--CLIPPER.EXE
Compiles one or more program files (.prg) containing procedures and user-
defined functions to form an object file (.OBJ).
------------------------------------------------------------------------------
CLIPPER [<sourceFile> | @<scriptFile> [<option list>]]
Arguments
<sourceFile> is the name of the program file to compile to an object
file. If no extension is specified, (.prg) is assumed. The filename
can optionally include a drive designator and a path reference.
<scriptFile> is the name of an ASCII text file containing a list of
source files to compile into a single object file. The default
extension for this file is (.clp).
<option list> is a list of one or more options to control the course
of the compilation, all of which are described below. To get a list of
options, specify the compiler command line with no arguments.
Compiler Options
All options are shown in uppercase preceded by a slash (/). Note,
however, that options are not case-sensitive and that you can replace
the slash with a dash (-) if you prefer.
Some compiler options have arguments. If an option has arguments,
specify them after the option, with no space between the option and
its first argument.
/A
Declares any variable included in a PRIVATE, PUBLIC, or PARAMETERS
statement as MEMVAR.
/B
Includes debugging information in the object file.
/D<identifier>[=<text>]
Defines an identifier to the preprocessor with <text> assigned to the
<identifier> if specified.
/ES[<severityLevel>]
Specifies the severity level of warnings.
If <severityLevel> is 0 or omitted, the compiler does not set the DOS
ERRORLEVEL upon exit if warnings are encountered. This is the default
behavior of the compiler.
If <severityLevel> is 1, the compiler sets the DOS ERRORLEVEL upon exit
if warnings are encountered but still generates an .OBJ file.
If <severityLevel> is 2, the compiler sets the DOS ERRORLEVEL upon exit
if warnings are encountered and does not generate an .OBJ file. This
effectively promotes warnings to error status.
/I<pathName>
Adds the specified directory to the front of the INCLUDE path list.
Multiple /I options can be specified in the same compiler session to
specify several header file search directories.
/L
Excludes the program source code line numbers from the object file.
/M
Compiles only the current program file (.prg) suppressing automatic
search for program files (.prg) referenced in a program file with the
DO, SET FORMAT, and SET PROCEDURE commands.
/N
Suppresses the automatic definition of a procedure with the same name as
the program file (.prg).
/O<objFile>
Defines the name and/or location of the output object file.
/P
Preprocesses the program file (.prg) and copying the result to an output
file with a (.ppo) extension.
/Q
Prevents line numbers from displaying while compiling.
/R[<libFile>]
Embeds a library search request in the object file. If /R is specified
without <libFile> name, the default requests for CLIPPER.LIB,
EXTEND.LIB, DBFNTX.LIB, and TERMINAL.LIB are suppressed. Multiple /R
options can be specified in the same compiler session to embed more
than one library request.
/S
Checks the syntax of the current (.prg) file and no object file is
generated.
/T<pathName>
Specifies a different directory for temporary files generated during
compilation.
/U[<userStandardHeaderFile>]
Identifies an alternate standard header file to preprocess in place of
the supplied STD.CH which is used automatically.
/V
Forces the compiler to assume all references to undeclared or unaliased
variable names are public or private variables.
/W
Generates warning messages for undeclared or unaliased (ambiguous)
variable references.
/Z
Suppresses shortcutting optimizations on the logical operators .AND. and
.OR. This option is provided as an aid to isolating code that depends
on the behavior of older versions of CA-Clipper.
See Also:
SET CLIPPERCMD
SET INCLUDE
SET TMP
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson