3.1 Assembler Interface Syntax
xc32-as directly, the assembler's command line has the following
general
form:xc32-as [options] [sourcefiles]The order of the assembly source files determines the order in which they are assembled.
The special character sequence, -- (two hyphens not
followed by any non-space character) represents the standard input file, and can be used to
indicate that source code will be passed to the assembler via the stdin
stream. If there are no options and no input files, then the assembler will also read from
stdin.
Except for -- (as described above), any command line
argument that begins with a hyphen (-) is an option. The
options are case sensitive. It is customary to declare options before the source files;
however, this is not mandatory. Each option changes the behavior of the assembler, but no
option changes the way another option works.
Some single-letter options require exactly one file name argument to
follow them. The file name may either immediately follow the option or it may be separated
by a space character. For example, to specify an output file named test.o, either of the option forms -o test.o
and -otest.o is acceptable.