Added dla2csv, dla2img. Split up docs.

1 files changed, 33 insertions, 0 deletions

diff --git a/BUILD.txt b/BUILD.txt
new file mode 100644
index 0000000..e28a41e
--- /dev/null
+++ b/BUILD.txt
@@ -0,0 +1,33 @@
+To build the DLA suite, you need a Unix/GNU like system (which might
+even be modern Windows), with the following software installed:
+
+- Required: A "make" command. This can be GNU or BSD make. The
+  Makefile doesn't use any special features, so pretty much any
+  version should be OK.
+
+- Required: "cl65", from CC65, the cross-compiler for the 6502. Any
+  recent version should do; I used 2.19.
+
+- Optional: "perl", the Perl 5 interpreter. Only used to generate the
+  file dlatbl.s. You only need Perl if you're going to modify the data
+  tables (the mkdlatbl.pl script).
+
+- Optional: "cc", a host C compiler (e.g. gcc or clang). Only used for
+  compiling dla2csv for the host.
+
+You should be able to build everything from a terminal by typing
+"make" in the source directory.
+
+Ideally, all the software should be found in your $PATH. If not,
+you can set the full paths by defining them on the make command line.
+Example that sets all 3:
+
+make CL65=/opt/cc65/bin/cl65 PERL=/usr/local/perl/bin/perl5 CC=/usr/bin/clang
+
+Also you could set CFLAGS and CL65FLAGS, if you can think of a reason
+to do that.
+
+If you have trouble building on Linux, ask me for help. I can be found
+on irc.libera.chat in the ##atari channel, as user name Urchlay. If
+you have trouble on other OSes, ask someone who actually knows about
+your OS (not me, I don't do Windows or Mac).