Warning

You're browsing the old v2.x documentation. This version is no longer maintained. Click here to go the v3.x documentation.

This is an old revision of the document!


Usage

Usage in GUI

The recommended application to edit and compile XC=BASIC programs is XC=EDIT by Oliver Hermanni. It supports the entire development process without having to use the command line at all.

Command line usage

Since version 1.0, the DASM executable is included in the project and XC=BASIC sources can be compiled to machine code using a single command.

Usage in Windows:

xcb.bat source.bas target.prg

Usage in Linux:

./xcb source.bas target.prg

Usage in macOS:

./xcbmac source.bas target.prg

That's all you have to use in most of the cases. However, you can still use the binaries in the bin/ directory to see and debug the intermediate assembly listing.

The command line usage of the binarry is:

xcbasic64 source.bas > target.asm

You can omit the output redirection if you just want to see the result on the screen.

The target then can be compiled using DASM:

dasm target.asm

Or using a singe line command:

xcbasic64 source.bas > target.asm && dasm target.asm