From bbffe594b2f9a42bd98e4e9de6dae65a2008e54e Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sun, 19 May 2024 05:21:33 -0400 Subject: README.txt: renamed from README, tweaked. --- Makefile | 2 +- README | 85 --------------------------------------------------------- README.txt | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 92 insertions(+), 86 deletions(-) delete mode 100644 README create mode 100644 README.txt diff --git a/Makefile b/Makefile index 8aa1acc..d1bb32f 100644 --- a/Makefile +++ b/Makefile @@ -21,7 +21,7 @@ SCRIPTS=dasm2atasm a8utf8 MANS=a8eol.1 xfd2atr.1 atr2xfd.1 blob2c.1 cart2xex.1 fenders.1 xexsplit.1 xexcat.1 atrsize.1 rom2cart.1 unmac65.1 axe.1 dasm2atasm.1 a8utf8.1 blob2xex.1 xexamine.1 xex1to2.1 unprotbas.1 MAN5S=xex.5 MAN7S=atascii.7 -DOCS=README equates.inc *.dasm LICENSE ksiders/atr.txt +DOCS=README.txt equates.inc *.dasm LICENSE ksiders/atr.txt SUBDIRS=ksiders jindroush diff --git a/README b/README deleted file mode 100644 index b833186..0000000 --- a/README +++ /dev/null @@ -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 on irc.libera.chat ##atari. diff --git a/README.txt b/README.txt new file mode 100644 index 0000000..76003f8 --- /dev/null +++ b/README.txt @@ -0,0 +1,91 @@ +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. + +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. + +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 on irc.libera.chat ##atari. -- cgit v1.2.3