Echelon Neuron C User Manual

Page 225

Advertising
background image

Neuron C Programmer’s Guide

213

Usage: [optional command(s)] argument

...

(Remaining output not listed here)

Most command switches come in two forms, a short form and a long form. The
short form must be prefixed with a single slash '/' or dash '-' and consists of a

single, case-sensitive, character that identifies the command.

Example of short form:

C:\>NCC -DMYMACRO ...

Short command switches can be separated from their respective values with a

single space or an equal sign. Short command switches do not require a
separator; the value can follow the command identifier immediately, as shown

above.
The long form of the command must be prefixed with a double dash '- -', followed
by the verbose, case-sensitive, name of the command.

Example of long form:
C:\>NCC - -define=MYMACRO ...

Long command switches do require a separator, which can consist of a single

space, or an equal sign.

Multiple command switches can be separated by a single space.

Example:
C:\>NCC - -define=MYMACRO1 - -define=MYMACRO2 ...

Commands of a Boolean type need not be followed by a value, in which case yes is

assumed. Possible values for Boolean commands are yes, on, 1, +, no, off, 0, - (a

minus character).

Example:
C:\>NCC - -kerneldbg=yes ...

This is equivalent to the line shown below (because the Boolean type commands
default to yes):

C:\>NCC - -kerneldbg ...

Commands can be read from the command line as shown in the examples above,
and they can also be read from a command file (script), which contains empty

lines, lines starting with a semicolon (comment lines), or lines containing one
command switch on each line (with value as applicable).
For brevity, the short command syntax is most commonly used on the interactive

command line, whereas the long command line syntax is preferred for command
files due to its more self-explanatory nature.

Example command file:

; Example command file, containing
; some of the Exporter's commands
; Created Wednesday, November 21, 2008, 20:42:20

--bootflags=1024
--infolder=d:\lm\Source\EPR\23305\Development\IM
--outfolder=d:\lm\Source\EPR\23305\Development

Advertising