Refer to Atari programs by original names (LZ and DZ, not ALF and UNALF).

5 files changed, 52 insertions, 27 deletions

diff --git a/README.txt b/README.txt
index c0a0258..6f4b8d6 100644
--- a/README.txt
+++ b/README.txt
@@ -10,7 +10,9 @@ Linux and anything else that's POSIX-ish. It's also intended to
 be a repository of information about the ALF archiver (and UNALF
 dearchiver).
 
-The original ALF/UNALF programs for the Atari were written by Alfred.
+The original LZ.COM/DZ.COM (aka ALF/UNALF) programs for the Atari were
+written by Alfred.
+
 This project is by B. Watson (urchlay@slackware.uk).
 
 The rest of this file is a list of the contents of the git repository
@@ -26,15 +28,18 @@ Included in both the source and binary distributions:
   file structure is almost identical to ARC's. This file was taken from
   the arc-5.21q source.
 
-- doc/alf14.atr - the distribution disk for ALF version 1.4, as an Atari
-  8-bit single-density floppy disk image. This likely isn't the original
-  distribution disk, but it's the only one I've found on the various
-  archive sites.
+- doc/DZ.COM - the Atari executable of the ALF extractor (aka UNALF).
+  This and LZ.COM are the same files as the ones inside the .atr image.
+
+- doc/LZ.COM - the Atari executable of the ALF archiver (aka ALF).
+
+- doc/alf14.atr - bootable DOS 2.0S disk image, with LZ.COM (aka ALF),
+  DZ.COM (aka UNALF), and the documentation. This is not the original
+  distribution disk: there never was one. Alfred distributed these
+  files as an ARC archive on his BBS.
 
-- doc/alf14_doc.txt - the documentation for ALF and UNALF, extracted
-  from the disk image and converted from ATASCII to standard ASCII. Note
-  that the filenames are different: LZ.COM for ALF14.COM and DZ.COM for
-  UNALF14.COM.
+- doc/alf14_doc.txt - the documentation for LZ.COM and DZ.COM, extracted
+  from the disk image and converted from ATASCII to standard ASCII.
 
 - doc/fileformat.txt - documents how the ALF file format differs from ARC.
 
diff --git a/src/alfsum.1 b/src/alfsum.1
index 82919bf..0ef625c 100644
--- a/src/alfsum.1
+++ b/src/alfsum.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "ALFSUM" 1 "2025-11-20" "0.1.0" "Urchlay's Atari 8-bit Tools"
+.TH "ALFSUM" 1 "2025-11-21" "0.1.0" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 alfsum \- calculate ALF checksums
 .\" RST source for alfsum(1) man page. Convert with:
@@ -79,7 +79,7 @@ Error in command\-line arguments: no filenames given.
 .UNINDENT
 .SH COPYRIGHT
 .sp
-\fBunalf\fP is released under the WTPFL: Do WTF you want with this.
+\fBalfsum\fP is released under the WTPFL: Do WTF you want with this.
 .SH AUTHORS
 .INDENT 0.0
 .IP B. 3
diff --git a/src/alfsum.rst b/src/alfsum.rst
index 03ab2f5..d02f24d 100644
--- a/src/alfsum.rst
+++ b/src/alfsum.rst
@@ -70,7 +70,7 @@ EXIT STATUS
 COPYRIGHT
 =========
 
-**unalf** is released under the WTPFL: Do WTF you want with this.
+**alfsum** is released under the WTPFL: Do WTF you want with this.
 
 AUTHORS
 =======
diff --git a/src/unalf.1 b/src/unalf.1
index b6ca213..383974c 100644
--- a/src/unalf.1
+++ b/src/unalf.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "UNALF" 1 "2025-11-20" "0.1.0" "Urchlay's Atari 8-bit Tools"
+.TH "UNALF" 1 "2025-11-21" "0.1.0" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 unalf \- extract Atari 8-bit ALF archives
 .\" RST source for unalf(1) man page. Convert with:
@@ -39,11 +39,13 @@ unalf \- extract Atari 8-bit ALF archives
 unalf [\fB\-\-help\fP] [\fB\-aehtklLopqtv\fP] [\fB\-d\fP \fIdir\fP] [\fB\-x\fP \fIwildcard\fP] \fIalf\-file\fP [\fIwildcard\fP ...]
 .SH DESCRIPTION
 .sp
-\fBunalf\fP lists or extracts the contents of an \fIALF\fP archive.
+\fBunalf\fP lists, extracts, or tests the contents of an \fIALF\fP archive.
 .sp
 \fIALF\fP is a compressed archive format similar to \fBarc\fP(1), though
 not compatible with it. It was used on the Atari 8\-bit platform
-beginning in the late 1980s.
+beginning in the late 1980s. The Atari executables are \fBLZ.COM\fP
+for the compressor and \fBDZ.COM\fP for the decompressor. \fBunalf\fP is a
+port of \fBDZ.COM\fP for modern operating systems, with added features.
 .sp
 Extracted files are written to the current directory by
 default. Existing files are backed up by default (by adding a \fB~\fP
@@ -277,7 +279,7 @@ Generally means the archive is corrupt. Valid ALF files should never
 cause these errors.
 .sp
 If you have an ALF file that does this, try it with the Atari
-\fBUNALF14.COM\fP and see if it has the same problem. If it doesn\(aqt,
+\fBDZ.COM\fP and see if it has the same problem. If it doesn\(aqt,
 you\(aqve found a bug in \fBunalf\fP, please send me the .alf file via
 email (see \fBAUTHOR\fP, below). Actually, I\(aqd be interested to see
 the .alf file even if it doesn\(aqt work on the Atari either.
@@ -302,7 +304,7 @@ allow underscores in filenames.
 .UNINDENT
 .SH NOTES
 .sp
-This \fBunalf\fP is 100% compatible with the original Atari \fBUNALF14.COM\fP
+This \fBunalf\fP is 100% compatible with the original Atari \fBDZ.COM\fP
 aka \fBDZ.COM\fP, with the following differences:
 .INDENT 0.0
 .IP \(bu 2
@@ -318,13 +320,21 @@ Turning the screen off for speed makes no sense on modern operating
 systems, so there\(aqs no option for that.
 .UNINDENT
 .sp
-Neither this \fBunalf\fP nor \fBUNALF14.COM\fP actually use the dates/times
+Neither this \fBunalf\fP nor \fBDZ.COM\fP actually use the dates/times
 stored in the archive. Extracted files will have their timestamps set
 to the current date/time.
+.sp
+A note about the Atari filenames: \fBDZ.COM\fP is sometimes found on
+old disk images as \fBUNALF.COM\fP, and \fBLZ.COM\fP is sometimes called
+\fBALF.COM\fP or \fBALFER.COM\fP\&. I\(aqve used the original names partly
+out of respect for the original author, and partly to avoid confusion
+between my \fBunalf\fP and the Atari one.
 .SH COPYRIGHT
 .sp
-The original AlfCrunch for the Atari 8\-bit was released into the Public
-Domain. Portions of the Atari AlfCrunch code are included in \fBunalf\fP\&.
+The original AlfCrunch (\fBDZ.COM\fP and \fBLZ.COM\fP) for the Atari
+8\-bit was released into the Public Domain. Portions of the \fBDZ.COM\fP
+code are included in \fBunalf\fP, converted from 6502 instructions to
+C macros.
 .sp
 \fBunalf\fP is released under the WTPFL: Do WTF you want with this.
 .SH AUTHOR
diff --git a/src/unalf.rst b/src/unalf.rst
index d766f5d..32a3982 100644
--- a/src/unalf.rst
+++ b/src/unalf.rst
@@ -26,11 +26,13 @@ unalf [**--help**] [**-aehtklLopqtv**] [**-d** *dir*] [**-x** *wildcard*] *alf-f
 DESCRIPTION
 ===========
 
-**unalf** lists or extracts the contents of an *ALF* archive.
+**unalf** lists, extracts, or tests the contents of an *ALF* archive.
 
 *ALF* is a compressed archive format similar to **arc**\(1), though
 not compatible with it. It was used on the Atari 8-bit platform
-beginning in the late 1980s.
+beginning in the late 1980s. The Atari executables are **LZ.COM**
+for the compressor and **DZ.COM** for the decompressor. **unalf** is a
+port of **DZ.COM** for modern operating systems, with added features.
 
 Extracted files are written to the current directory by
 default. Existing files are backed up by default (by adding a **~**
@@ -231,7 +233,7 @@ Besides the standard error messages such as "no such file or directory":
   cause these errors.
 
   If you have an ALF file that does this, try it with the Atari
-  **UNALF14.COM** and see if it has the same problem. If it doesn't,
+  **DZ.COM** and see if it has the same problem. If it doesn't,
   you've found a bug in **unalf**, please send me the .alf file via
   email (see **AUTHOR**, below). Actually, I'd be interested to see
   the .alf file even if it doesn't work on the Atari either.
@@ -257,7 +259,7 @@ Besides the standard error messages such as "no such file or directory":
 NOTES
 =====
 
-This **unalf** is 100% compatible with the original Atari **UNALF14.COM**
+This **unalf** is 100% compatible with the original Atari **DZ.COM**
 aka **DZ.COM**, with the following differences:
 
 - There is no interactive mode. The file to extract must be given as
@@ -271,15 +273,23 @@ aka **DZ.COM**, with the following differences:
 - Turning the screen off for speed makes no sense on modern operating
   systems, so there's no option for that.
 
-Neither this **unalf** nor **UNALF14.COM** actually use the dates/times
+Neither this **unalf** nor **DZ.COM** actually use the dates/times
 stored in the archive. Extracted files will have their timestamps set
 to the current date/time.
 
+A note about the Atari filenames: **DZ.COM** is sometimes found on
+old disk images as **UNALF.COM**, and **LZ.COM** is sometimes called
+**ALF.COM** or **ALFER.COM**. I've used the original names partly
+out of respect for the original author, and partly to avoid confusion
+between my **unalf** and the Atari one.
+
 COPYRIGHT
 =========
 
-The original AlfCrunch for the Atari 8-bit was released into the Public
-Domain. Portions of the Atari AlfCrunch code are included in **unalf**.
+The original AlfCrunch (**DZ.COM** and **LZ.COM**) for the Atari
+8-bit was released into the Public Domain. Portions of the **DZ.COM**
+code are included in **unalf**, converted from 6502 instructions to
+C macros.
 
 **unalf** is released under the WTPFL: Do WTF you want with this.