speccydev/README.md

# Development tools for the ZX Spectrum

The Dockerfile is the basis of the devcontainer and can be changed to add or remove tools. It will take a long time to build locally, so by default the devcontainer will pull a prebuilt version. Edit `.devcontainer/devcontainer.json` if you would rather build your own.

The devcontainer contains:
- pasmo (assembler)
- sjasmplus (assembler)
- z80asm (assembler)
- z80dasm (disassembler)
- zmakebas (creates BASIC programs)
- z88dk (C compiler and other utilities including assembler)
- utilities from the FUSE emulator:
    - audio2tape
    - createhdf
    - fmfconv
    - listbasic
    - profile2map
    - raw2hdf
    - rzxcheck
    - rzxdump
    - rzxtool
    - scl2trd
    - snap2tzx
    - snapconv
    - snapdump
    - tape2pulses
    - tape2wav
    - tapeconv
    - tzxlist
- zx0 (binary compressor)
- dzx0 (binary decompressor)
- ZX BASIC (aka Boriel BASIC)
    - zxbc (BASIC compiler)
    - zxbasm (assembler)
    - zxbpp (preprocessor)
- ttttt (converts binaries into .tap blocks)
- git (version control)
- make (build control)

Build the example project by running `make` from the terminal or the VSCode extension.

Debug in the built in simulator or in CSpect externally (example CSpect invocation on Windows would be `CSpect.exe -w2 -debug -remote`).
*Note: to use CSpect debugging from a Linux host you will have to edit the file `.vscode/launch.json` to change the `"hostname"` parameter to `"localhost"`*
typo 2025-04-26 22:53:52 +00:00			`# Development tools for the ZX Spectrum`
Add example project, devcontainer config and debugger config 2025-04-26 23:30:03 +01:00
reinstate z88dk by building ourselves 2025-04-29 09:11:57 +00:00			The Dockerfile is the basis of the devcontainer and can be changed to add or remove tools. It will take a long time to build locally, so by default the devcontainer will pull a prebuilt version. Edit `.devcontainer/devcontainer.json` if you would rather build your own.
Add example project, devcontainer config and debugger config 2025-04-26 23:30:03 +01:00
Expand the README 2025-04-27 22:06:28 +00:00			`The devcontainer contains:`
			`- pasmo (assembler)`
			`- sjasmplus (assembler)`
			`- z80asm (assembler)`
			`- z80dasm (disassembler)`
			`- zmakebas (creates BASIC programs)`
reinstate z88dk by building ourselves 2025-04-29 09:11:57 +00:00			`- z88dk (C compiler and other utilities including assembler)`
Expand the README 2025-04-27 22:06:28 +00:00			`- utilities from the FUSE emulator:`
			`- audio2tape`
			`- createhdf`
			`- fmfconv`
			`- listbasic`
			`- profile2map`
			`- raw2hdf`
			`- rzxcheck`
			`- rzxdump`
			`- rzxtool`
			`- scl2trd`
			`- snap2tzx`
			`- snapconv`
			`- snapdump`
			`- tape2pulses`
			`- tape2wav`
			`- tapeconv`
			`- tzxlist`
			`- zx0 (binary compressor)`
			`- dzx0 (binary decompressor)`
Add Boriel BASIC 2025-04-28 08:59:46 +00:00			`- ZX BASIC (aka Boriel BASIC)`
			`- zxbc (BASIC compiler)`
			`- zxbasm (assembler)`
			`- zxbpp (preprocessor)`
Expand the README 2025-04-27 22:06:28 +00:00			`- ttttt (converts binaries into .tap blocks)`
			`- git (version control)`
			`- make (build control)`
Add example project, devcontainer config and debugger config 2025-04-26 23:30:03 +01:00
			Build the example project by running `make` from the terminal or the VSCode extension.

Typo 2025-04-26 22:52:46 +00:00			Debug in the built in simulator or in CSpect externally (example CSpect invocation on Windows would be `CSpect.exe -w2 -debug -remote`).
Expand the README 2025-04-27 22:06:28 +00:00			Note: to use CSpect debugging from a Linux host you will have to edit the file `.vscode/launch.json` to change the `"hostname"` parameter to `"localhost"`