Skip to content

Commit 0fca0e1

Browse files
committed
Add information in the Atari 5200 target to the compiler manual.
1 parent 74b781e commit 0fca0e1

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

compiler/USAGE.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,11 @@ following:
4949
- `atari-cart-int`: Compile to an Atari 8-bit cartridge image (`.rom`), with
5050
only integer support.
5151

52-
This example produces a cartridge image:
52+
- `atari-5200`: Compile to an Atari 5200 cartridge image (`.bin`), with only
53+
integer support. Note that not all statements are supported in the Atari
54+
5200, as the console lacks any file I/O.
55+
56+
This example produces a cartridge image for the Atari 8-bit computers:
5357

5458
fastbasic -t:atari-cart-fp myprog.bas
5559

@@ -62,6 +66,8 @@ The compiler generates various files from the basic source:
6266

6367
- `ROM` file, standard Atari 8-bit cartridge image.
6468

69+
- `BIN` file, standard Atari 5200 cartridge image.
70+
6571
- `LBL` file, a list of labels, useful for debugging. This file includes a
6672
label for each line number in the basic source, and the name is the same as
6773
the `XEX` / `ROM` file but with the `lbl` extension.
@@ -79,7 +85,7 @@ The compilation is a three step process:
7985

8086
- The compiler calls the `CA65` assembler to produce an object file.
8187

82-
- The compiler calls the `LD65` linker to join the object file with the runtime library, generating the `XEX` or `ROM`.
88+
- The compiler calls the `LD65` linker to join the object file with the runtime library, generating the `XEX`, `ROM` or `BIN` depending on the target.
8389

8490

8591
Advanced Usage
@@ -95,6 +101,9 @@ an `:` or an `=` to separate the option from the argument.
95101
Selects the compilation target. The target definitions are searched in the
96102
compiler installation folder, with an `.tgt` extension.
97103

104+
If this option is not given, the `default.tgt` file is loaded, currently this
105+
file simply includes the `atari-fp.tgt` file.
106+
98107
- **-v**
99108
Shows the compiler version.
100109

0 commit comments

Comments
 (0)