aboutsummaryrefslogtreecommitdiff
path: root/src/unalf.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2025-11-14 04:52:27 -0500
committerB. Watson <urchlay@slackware.uk>2025-11-14 04:52:27 -0500
commitafcaf14599cc82deeb321129382600521ec8e869 (patch)
tree084230b819a5c61ce8dbc09888c5d5ae88ed59c4 /src/unalf.rst
parente286ed23ae3cabfb75327d8512dc937b2ecf9be1 (diff)
downloadunalf-afcaf14599cc82deeb321129382600521ec8e869.tar.gz
Tweak man page.
Diffstat (limited to 'src/unalf.rst')
-rw-r--r--src/unalf.rst37
1 files changed, 27 insertions, 10 deletions
diff --git a/src/unalf.rst b/src/unalf.rst
index 9eaa0ad..a1cfb7e 100644
--- a/src/unalf.rst
+++ b/src/unalf.rst
@@ -20,7 +20,7 @@ extract Atari 8-bit ALF archives
SYNOPSIS
========
-unalf [**-aetklLopqv**] [**-d** *dir*] [**-x** *wildcard*] *alf-file* [*wildcard* ...]
+unalf [**-aetklLopqtv**] [**-d** *dir*] [**-x** *wildcard*] *alf-file* [*wildcard* ...]
DESCRIPTION
===========
@@ -47,6 +47,9 @@ OPTIONS
files are detected by name: **\*.txt**, **\*.doc**, **\*.lst** files
are considered text.
+ Note that *only* line-endings are converted. Other ATASCII characters
+ are left alone. If you need anything more in-depth, use **a8cat**\(1).
+
-aa
Convert line endings in all extracted files. This will corrupt any
executables or non-text data files, so use with caution.
@@ -87,6 +90,10 @@ OPTIONS
and warnings will still be printed. This is the default when **-p**
is used.
+-t
+ Test archive. Same as extraction, except the files are not written
+ anywhere.
+
-v
Verbose listing of archive contents, with compressed and original
sizes, compression ration, date/time stamps, and checksum. The
@@ -128,14 +135,14 @@ DIAGNOSTICS
Besides the standard error messages such as "no such file or directory":
-**unalf: this is an ARC file, not ALF**
+**this is an ARC file, not ALF**
Self-explanatory. Use the **arc**\(1) utility for this file.
-**unalf: not an ALF file**
+**not an ALF file**
Self-explanatory. Either the file is too small (less than 29 bytes)
or its first two bytes don't match the *ALF* signature **0x1a** **0x0f**\.
-**unalf: junk at EOF (ignored)**
+**junk at EOF (ignored)**
Usually this is caused by the .alf file being stored on a CP/M disk
at some time, or by a dumb file transfer protocol. Either way, the
file gets padded to the block size of the filesystem or protocol.
@@ -145,15 +152,24 @@ Besides the standard error messages such as "no such file or directory":
you know that this .alf file can't be appended to by the **ALF.COM**
aka **LZ.COM** Atari utility.
-**unalf: checksum error on** *<file>*
+**checksum error on** *<file>*
The archive is corrupt. If *<file>* is a text file, it may be
partially readable. If it's an executable or other binary file, it's
probably unrecoverable.
+**stack underrun/overrun**
+ Generally means the archive is corrupt. Valid ALF files should never
+ 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 does, you've found a bug in **unalf**, please send me the
+ .alf file via email (see **AUTHOR**, below).
+
NOTES
=====
-This **unalf** is 100% compatible with the original Atari **UNALF.COM**
+This **unalf** is 100% compatible with the original Atari **UNALF14.COM**
aka **DZ.COM**, with the following differences:
- There is no interactive mode. The file to extract must be given as
@@ -161,12 +177,13 @@ aka **DZ.COM**, with the following differences:
with the **-d** option.
- This **unalf** is capable of listing or testing the contents of an archive
- without extracting it.
+ without extracting it, plus other handy features such as extracting
+ to standard output and text file EOL conversion.
- Turning the screen off for speed makes no sense on modern operating
systems, so there's no option for that.
-Neither this **unalf** nor **UNALF.COM** actually use the dates/times
+Neither this **unalf** nor **UNALF14.COM** actually use the dates/times
stored in the archive. Extracted files will have their timestamps set
to the current date/time.
@@ -175,8 +192,8 @@ COPYRIGHT
**unalf** is released under the WTPFL: Do WTF you want with this.
-AUTHORS
-=======
+AUTHOR
+======
B. Watson <urchlay@slackware.uk>