diff options
author | B. Watson <urchlay@slackware.uk> | 2024-05-19 05:21:33 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2024-05-19 05:21:33 -0400 |
commit | bbffe594b2f9a42bd98e4e9de6dae65a2008e54e (patch) | |
tree | f3a9be4b24c39da4d65cd2d59b53e447633a64b3 /README | |
parent | 264afef117442f5b1e83183ecd27046b6ecf71b5 (diff) | |
download | bw-atari8-tools-bbffe594b2f9a42bd98e4e9de6dae65a2008e54e.tar.gz |
README.txt: renamed from README, tweaked.
Diffstat (limited to 'README')
-rw-r--r-- | README | 85 |
1 files changed, 0 insertions, 85 deletions
@@ -1,85 +0,0 @@ -This is a collection of Atari 8-bit related utilities I've written for 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. - -axe - ATR/XFD Editor. Copy files into & out of ATR and XFD images, - create blank ATR images, etc. - -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. - -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. - -dasm2atasm - Convert 6502 assembly in DASM syntax to ATASM (or MAC/65) format. - -fenders - Install Fenders 3-sector loader in boot sectors of an ATR image. - -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. - -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. - -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. |