mirror of
https://github.com/KarolS/millfork.git
synced 2026-04-23 21:17:27 +00:00
Documentation update
This commit is contained in:
@@ -12,11 +12,21 @@
|
||||
|
||||
## I/O options
|
||||
|
||||
* `-o <file>` – Output filename, without extension. Extension will be added automatically, `.prg` for Commodore, `.a2` for Apple and `.xex` for Atari.
|
||||
* `-o <file>` – Output filename, without extension.
|
||||
Extension will be added automatically,
|
||||
`.prg` for Commodore (including LUnix/LNG),
|
||||
`.a2` for Apple,
|
||||
`.xex` for Atari computers,
|
||||
`.bin` for Atari VCS,
|
||||
`.nes` for NES,
|
||||
no extension for BBC micro program file,
|
||||
`.inf` for BBC Micro metadata,
|
||||
`.d88` for PC-88 disk images,
|
||||
`.tap` for ZX-Spectrum tape images.
|
||||
|
||||
* `-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 nam 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 Vice emulator for debugging purposes. The file has the same name as the output file and the extension is `.lbl`.
|
||||
|
||||
* `-I <dir>;<dir>` – The include directories. The current working directory is also an include directory. Those directories are searched for modules and platform definitions.
|
||||
|
||||
|
||||
@@ -41,12 +41,19 @@ Every platform is defined in an `.ini` file with an appropriate name.
|
||||
* `ro_arrays` – whether the compiler should warn upon array writes, default is `false`
|
||||
|
||||
* `prevent_jmp_indirect_bug` – whether the compiler should try to avoid the indirect JMP bug,
|
||||
default is `false` on 65C02-compatible processors and `true` elsewhere
|
||||
default is `false` on 65C02-compatible or non-6502 processors and `true` elsewhere
|
||||
|
||||
* `compact_dispatch_params` – whether parameter values in return dispatch statements may overlap other objects, default is `true`
|
||||
This may cause problems if the parameter table is stored next to a hardware register that has side effects when reading.
|
||||
|
||||
* `lunix` – generate relocatable code for LUnix/LNG, default is `false`
|
||||
|
||||
* `zeropage_register` – reserve 2 bytes of zero page as a pseudoregister to increase language features.
|
||||
Default: `true` if targeting a 6502-based architecture, `false` otherwise.
|
||||
|
||||
* `inline` - inline functions automatically by default, default is `false`.
|
||||
|
||||
* `ipo` - enable interprocedural optimization, default is `false`.
|
||||
|
||||
|
||||
#### `[allocation]` section
|
||||
@@ -107,6 +114,8 @@ Default: `after_code`.
|
||||
|
||||
* `d88` - a D88 floppy disk image for PC-88
|
||||
|
||||
* `tap` - a tape disk image for ZX Spectrum
|
||||
|
||||
* `extension` – target file extension, with or without the dot
|
||||
|
||||
* `bbc_inf` – should the `.inf` file with file metadata for BBC Micro be created
|
||||
@@ -6,7 +6,7 @@ Currently, Millfork supports creating disk- or tape-based programs for Commodore
|
||||
and cartridge-based programs for Famicom/NES and Atari 2600,
|
||||
but it may be expanded to support other 6502-based and Z80-based platforms in the future.
|
||||
|
||||
To add a custom platform yourself, see [the custom platform adding guide](./custom-plaftorm.md).
|
||||
To add a custom platform yourself, see [the custom platform adding guide](./custom-platform.md).
|
||||
|
||||
## Supported platforms
|
||||
|
||||
|
||||
Reference in New Issue
Block a user