Command-Line Options

Usage

pbxa64 [options] <input files>

Options Reference

Option	Description
`-o <path>`	Output file path. Default depends on mode: `a.exe` (link), `a.obj` (compile-only), `a.asm` (assembly).
`-c`	Compile only — produce a `.o` COFF object file without linking.
`-S`	Emit assembly only — output `.asm` text file instead of binary. Includes comment header with compiler version and command line.
`--asm:<path>`	Save generated assembly to file, then continue compiling and linking (unlike `-S` which stops). Assembly includes comment header.
`--dump-tokens`	Dump the lexer token stream to stdout. Useful for debugging lexer behavior.
`--dump-ast, --emit-ast`	Dump the abstract syntax tree to stdout after parsing.
`--dump-ir, --emit-ir`	Dump the intermediate representation to stdout after IR lowering.
`-O0`	No optimization (default). Fastest compilation, no transforms applied.
`-O1`	Basic optimization — enables simple peephole and local transforms.
`-O2`	Aggressive optimization — enables all available optimization passes.
`-O3`	Maximum optimization — highest optimization level.
`-v, --verbose`	Verbose output — prints additional diagnostic information during compilation.
`-h, --help`	Show the help message and exit.
`--version`	Show version banner and exit.

Input Files

Extension	Frontend	Description
`.pb`	PowerBASIC	Primary PowerBASIC source file
`.bas`	PowerBASIC	PowerBASIC source file (alternate)
`.pbi`	PowerBASIC	PowerBASIC include file
`.mgc`	MGC	C-like intermediate language source

Examples

# Compile and link to executable
pbxa64 hello.pb -o hello.exe

# Compile to object file only
pbxa64 -c program.bas -o program.obj

# Generate assembly listing
pbxa64 -S program.pb -o program.asm

# Debug token stream
pbxa64 --dump-tokens hello.pb

# Debug AST
pbxa64 --dump-ast hello.pb

# Debug IR with optimization
pbxa64 --dump-ir -O1 program.mgc