Initial importHEADmain

1 files changed, 25 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9480ab4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# ZX Spectrum BASIC cross-compilation
+
+This is an easy way to write Sinclair BASIC for the ZX Spectrum using a regular
+PC thanks to BAS2TAP by M. van der Heide (see [bas2tap.doc](bas2tap.doc) for
+details).
+
+It compiles to "bytecode" that will be run by the ZX Spectrum, and not into
+machine code.
+
+Requirements:
+
+* Make (GNU Make recommended)
+* A C compiler (the Makefile expects GCC)
+* a ZX Spectrum emulator (optional; for `make fuse` -- FUSE GTK is expected)
+
+"Basically" edit `game.bas` with you editor of choice and run `make` to
+compile it to tokens in a `.tap` file that can be loaded in a ZX Spectrum
+emulator.
+
+Optionally you can run `make fuse` or `make zxsec` to load that tape on an emulator.
+
+Given that most of the functionality comes from BAS2TAP, that has a weird
+licence (that claims to be open source, but not sure it is!), this is
+distributed under the same terms of BAS2TAP.
+