aboutsummaryrefslogtreecommitdiff
path: root/src/unalf.1
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2025-11-21 03:57:48 -0500
committerB. Watson <urchlay@slackware.uk>2025-11-21 03:57:48 -0500
commit20aba7cceecad6c8bce5dba8990ea69e49137cd8 (patch)
treee6f797297140b09d366ab4c3b01dee02522e7f9d /src/unalf.1
parent232065f88feb93c999c99f085bce049bb73fae36 (diff)
downloadunalf-20aba7cceecad6c8bce5dba8990ea69e49137cd8.tar.gz
Refer to Atari programs by original names (LZ and DZ, not ALF and UNALF).
Diffstat (limited to 'src/unalf.1')
-rw-r--r--src/unalf.126
1 files changed, 18 insertions, 8 deletions
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