This is a collection of Atari 8-bit related utilities I've written for
or ported to Linux. They should be usable as-is on other UNIX-like
systems, including Cygwin for MS-Windows.

a8eol      - Convert Atari 8-bit text files to/from UNIX / DOS / Mac Classic
             text file format.

a8utf8     - Convert Atari 8-bit text to UTF-8 encoded Unicode.

atr2xfd    - Convert an Atari 8-bit ATR disk image to a raw (XFD) image.

atrcheck   - Check an Atari 8-bit ATR disk image for various types of problems.

atrsize    - Change the size of an Atari 8-bit ATR disk image, or create
             a blank ATR image.

axe        - ATR/XFD Editor. Copy files into & out of ATR and XFD images,
             create blank ATR images, etc.

blob2c     - Create C source and header files from a binary file.

blob2xex   - Create a XEX file from arbitrary data.

cart2rom   - Convert an Atari800 CART image to a raw ROM image.

cart2xex   - Convert an Atari 8-bit ROM cartridge image to a binary load
             (XEX) file.

cxrefbas   - Code cross-reference for tokenized Atari 8-bit BASIC files.

dasm2atasm - Convert 6502 assembly in DASM syntax to ATASM (or MAC/65) format.

dumpbas    - Formatted hexdump for tokenized Atari 8-bit BASIC files.

fenders    - Install Fenders 3-sector loader in boot sectors of an ATR image.

listbas    - Detokenize (LIST) Atari 8-bit BASIC programs.

protbas    - LIST-protect Atari 8-bit BASIC programs.

renumbas   - Renumber Atari 8-bit BASIC programs.

rom2cart   - Convert a raw Atari 8-bit cartridge ROM image to a CART
             image for use with emulators such as Atari800.

unmac65    - Detokenize Atari 8-bit Mac/65 SAVEd files.

vxrefbas   - Variable cross-reference for tokenized Atari 8-bit BASIC files.

unprotbas  - Unprotect LIST-protected BASIC programs.

xex1to2    - Convert an Atari DOS 1.0 executable into a standard XEX file.

xexamine   - Show information on XEX files.

xexcat     - Concatenate Atari 8-bit executables (XEX) into a single XEX file.

xexsplit   - Split a multi-segment Atari 8-bit executable (XEX) into
             multiple single-segment files.

xfd2atr    - Convert an Atari 8-bit XFD (raw) disk image to an ATR image.

All are written in C, except a8utf8 and dasm2atasm which are written
in Perl. All utilities have man pages.

Also included is "equates.inc", a 6502 assembly header file that defines
the Atari 8-bit system equates. It's meant to be used with either the
DASM or ATASM 6502 cross assemblers.

Also included: collections of utilities by Ken Siders and Jindrich
Kubec. See the README.txt files in the ksiders/ and jindroush/
directories for details.

To install, use the standard "make && make install" process. The default
prefix for installation is /usr/local.

You may use "make install PREFIX=/somewhere/else" to install somewhere
other than /usr/local. Binaries will be installed to $PREFIX/bin, man
pages to $PREFIX/share/man/man1, and other documentation (including
equates.inc) to $PREFIX/share/doc/bw-atari8-tools. You also may use
BINDIR, MANDIR, MAN1DIR, and DOCDIR to explicitly set the installation
paths. Man pages are compressed with gzip by default. If your system
does not support gzipped man pages, try "make install GZIP_MAN=n". If
you're creating a distribution package (RPM, deb, Slackware tgz),
use "make install PREFIX=/usr DESTDIR=/tmp/whatever". This will
build everything for use in /usr, but actually install everything to
/tmp/whatever/usr, which can then be archived in whichever package
format you're using.

blob2c is not actually Atari-specific: it could be useful for any project
where the contents of a file need to be compiled as an unsigned char
array in a C program.

dasm2atasm is not Atari-specific, since the DASM and ATASM cross
assemblers can be used to develop code for any 6502-based platform
(though ATASM does have some nice extra features for the Atari 8-bit).
DASM supports several other CPUs besides the 6502, but dasm2atasm only
works with 6502 code.

The latest version of bw-atari8-tools can always be found at
https://slackware.uk/~urchlay/repos/bw-atari8-tools

-- B. Watson <urchlay@slackware.uk>; Urchlay on irc.libera.chat ##atari.