diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/alfsum.1 | 4 | ||||
| -rw-r--r-- | src/alfsum.rst | 2 | ||||
| -rw-r--r-- | src/unalf.1 | 26 | ||||
| -rw-r--r-- | src/unalf.rst | 24 |
4 files changed, 38 insertions, 18 deletions
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. |