Skip to content

Commit 51f4779

Browse files
committed
Update readme
1 parent 3414ac4 commit 51f4779

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

README.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ Disassembly of the Sinclair QL's operating system, version "JS".
33

44
The Sinclair QL came with an operating system in ROM called QDOS. Version "JS" is the last version that was available in the UK.
55

6-
This is a commented disassembly of the ROM that has been available online and was created by Wolfgang Goeller. Additional comments by Richard Zidlicky.
6+
This is a commented disassembly of the ROM that has been available online and was created by Wolfgang Goeller. Additional comments by Richard Zidlicky and Daniele Terdina.
77

88
## History
99
1. Disassembly and comments by Wolfgang Goeller (downloaded from the *Maya* FTP archive in the early days of the Internet).
1010
2. Additional comments by Richard Zidlicky (also available on Dilwyn's web site).
1111
3. Additional comments by Daniele Terdina (also available on Q-emuLator's web site).
12-
4. Minor changes to cross-assemble with Asm68K_QL
12+
4. Minor changes to cross-assemble with Asm68K_QL and generate accurate binary.
1313

1414
## Building with the GST assembler
1515
According to a comment in system_asm, it's possible to assemble the ROM code with the GST Macro Assembler. It needs a 256 KB memory expansion and using the -NOLIST option to avoid running out of space.
@@ -18,5 +18,11 @@ Use the [original sources](https://github.com/CodeDreamer/JS_ROM/releases/tag/or
1818
## Building with Asm68K
1919
Using the Asm68K cross-assembler, assemble with:
2020
```
21-
Asm68K system_asm
22-
```
21+
Asm68K --noopt system_asm
22+
```
23+
The --noopt is not necessary, but makes the output closer to the original.
24+
25+
## Releases
26+
Available GitHub releases (code snapshots):
27+
- `original` is the original disassembly published in the 90s, plus some additional comments.
28+
- `accurate` produces code identical to the JS ROM when assembled with Asm68K_QL, with one exception: some jumps in the original ROM use "absolute long" addressing (probably by mistake), while the assembler generates "absolute short" addressing. There is no functional difference, and the disassembly already included NOPs to keep the following code at the original address.

0 commit comments

Comments
 (0)