Skip to content

Commit

Permalink
doc: Improved documentation for .ROM and .START directives.
Browse files Browse the repository at this point in the history
Closes #121
  • Loading branch information
Fubukimaru committed Nov 5, 2023
1 parent 3186bd9 commit b17ed9d
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions doc/asmsx.md
Original file line number Diff line number Diff line change
Expand Up @@ -530,7 +530,10 @@ code at the function `msx_bios_vars()` in `dura.y`.

`.ROM` Indicates that a ROM header should be generated. It is important to use
.PAGE directive first to define start address. .START directive can be used to
indicate the start address for the program.
indicate the start address for the program and it should be used *before* the
.ROM directive. Use this directive **after** relocating the program counter with
.ORG or .PAGE directives. This is needed as ROM will write the header of the ROM
which is already ROM data.

`.MegaROM [mapper]` Generates header for specified MegaROM mapper. This
directive will also set start address to sub-page 0 of selected mapper, so
Expand Down Expand Up @@ -561,7 +564,8 @@ program. The default extension of the output file is BIN.
because COM files are always loaded at 0100h.

`.START X` Indicates the starting execution address for ROM, MegaROM and BIN
files, if it is not at the beginning of the file.
files, if it is not at the beginning of the file. Use it before any .ROM-like
directive.

`.SEARCH` For ROMs and MegaROMs to that start on page 1 (4000h),
it automatically finds and sets slot and subslot on page 2 (8000h).
Expand Down

0 comments on commit b17ed9d

Please sign in to comment.