1
0
mirror of https://github.com/KarolS/millfork.git synced 2026-04-20 18:16:35 +00:00

More label file formats

This commit is contained in:
Karol Stasiak
2019-06-14 11:39:11 +02:00
parent 5ca6988039
commit 3852b2dbe9
38 changed files with 253 additions and 84 deletions
+14 -1
View File
@@ -28,7 +28,20 @@ no extension for BBC micro program file,
* `-s` Generate also the assembly output. It is not compatible with any assembler, but it serves purely informational purpose. The file has the same nam as the output file and the extension is `.asm`.
* `-g` Generate also the label file. The label file contains labels with their addresses, with duplicates removed. It can be loaded into the monitor of the Vice emulator for debugging purposes. The file has the same name as the output file and the extension is `.lbl`.
* `-g` Generate also the label file. The label file contains labels with their addresses, with duplicates removed.
It can be loaded into the monitor of the emulator for debugging purposes.
The file has the same name as the output file.
The extension and the file format are platform-dependent.
* `-G <format>` The same as `-g`, but with the specified format:
* `-G vice` format compatible with the Vice emulator. The extension is `.lbl`.
* `-G nesasm` format used by the NESASM assembler. The extension is `.fns`.
* `-G sym` format used by the WLA DX assembler. The extension is `.sym`.
* `-G fceux` multi-file format used by the FCEUX emulator. The extension is `.nl`.
* `-I <dir>;<dir>` The include directories.
Those directories are searched for modules and platform definitions.
+13
View File
@@ -141,6 +141,9 @@ Default: the same as `segment_NAME_end`.
* `segment_NAME_datastart` the first address used for non-zeropage variables, or `after_code` if the variables should be allocated after the code.
Default: `after_code`.
* `segment_NAME_bank` the bank number the segment belongs to. Default: `0`.
For better debugging on NES, RAM segments should use bank number `$ff`.
#### `[output]` section
* `style` how multi-segment programs should be output:
@@ -178,3 +181,13 @@ Default: `after_code`.
* `bbc_inf` should the `.inf` file with file metadata for BBC Micro be created
* `gb_checksum` should the main output file be patched with Game Boy-compatible checksums
* `labels` format of the label file:
* `vice` (the default) format compatible with the Vice emulator. The extension is `.lbl`.
* `nesasm` format used by the NESASM assembler. The extension is `.fns`.
* `sym` format used by the WLA/DX assembler. The extension is `.sym`.
* `fceux` multi-file format used by the FCEUX emulator. The extension is `.nl`.
+15 -14
View File
@@ -31,19 +31,20 @@ x64 hello_world.prg
The following options are obligatory when compiling your sources:
* `-o FILENAME` specifies the base name for your output file, an appropriate file extension will be appended
(`prg` for Commodore,
`xex` for Atari computers,
`a2` for Apple,
`asm` for assembly output,
`lbl` for label file,
`inf` for BBC file metadata,
`dsk` for PC-88,
`tap` for ZX Spectrum,
`rom` for MSX cartridges,
`com` for CP/M,
`nes` for Famicom,
`bin` for Atari 2600)
* `-o FILENAME` specifies the base name for your output file, an appropriate file extension will be appended:
`prg` for Commodore;
`crt` for Commodore cartridges;
`xex` for Atari computers;
`a2` for Apple;
`dsk` for PC-88;
`tap` for ZX Spectrum;
`rom` for MSX cartridges;
`com` for CP/M;
`nes` for Famicom;
`bin` for Atari 2600;
`inf` for BBC file metadata;
`asm` for assembly output;
`lbl`, `nl`, `fns`, or `sym` for label file
* `-t PLATFORM` specifies the target platform.
Each platform is defined in an `.ini` file in the include directory.
@@ -62,7 +63,7 @@ You may be also interested in the following:
* `-fsource-in-asm` show original Millfork source in the assembly output
* `-g` additionally generate a label file, in format compatible with VICE emulator
* `-g` additionally generate a label file
* `-r PROGRAM` automatically launch given program after successful compilation