aboutsummaryrefslogtreecommitdiff
path: root/src/unalf.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2025-11-16 06:37:09 -0500
committerB. Watson <urchlay@slackware.uk>2025-11-16 06:37:09 -0500
commit1bdf2f116885f5597fda0c8741322fbd888ef55f (patch)
tree031c86aeddbe4b02a8c8ef0833139dc95601941a /src/unalf.rst
parent272c07d0a63c40597372467a13556e3b197e0b03 (diff)
downloadunalf-1bdf2f116885f5597fda0c8741322fbd888ef55f.tar.gz
Update man page.
Diffstat (limited to 'src/unalf.rst')
-rw-r--r--src/unalf.rst24
1 files changed, 15 insertions, 9 deletions
diff --git a/src/unalf.rst b/src/unalf.rst
index ec5e1e6..1e31500 100644
--- a/src/unalf.rst
+++ b/src/unalf.rst
@@ -86,7 +86,8 @@ OPTIONS
-l
List filenames in archive, one per line, but do not extract. Use
- **-v** for more information (file size, etc).
+ **-v** for more information (file size, etc). Obeys *wildcards* and
+ the **-x**, **-L**, **-k** options.
.. list files in archive (filenames only).
@@ -116,9 +117,9 @@ OPTIONS
.. extract to stdout (enables -q).
-q
- Quiet extraction: do not print "Uncrunching *file*" messages. Errors
- and warnings will still be printed. This is the default when **-p**
- is used.
+ Quiet extraction or testing: do not print "Uncrunching *file*"
+ or "Testing *file*" messages. Errors and warnings will still be
+ printed. This is the default when **-p** is used.
.. quiet: don't print filenames during extraction.
@@ -136,6 +137,10 @@ OPTIONS
date and time are displayed, but in most .alf files these are the
default values of "8 Jan 82 12:24a".
+ Unlike **-l**, the **-v** listing shows the filenames exactly as
+ stored in the archive (ignores **-L**, enables **-k**), and always
+ shows all the files (ignores *wildcards* and **-x**).
+
.. verbose listing of archive contents.
-V, --version
@@ -179,7 +184,7 @@ EXIT STATUS
Success.
1
- Fatal error (I/O or bad command-line arguments).
+ Fatal error (I/O or bad command-line arguments, stack under/overrun).
2
Processing completed OK, but at least one file in the archive
@@ -216,10 +221,11 @@ Besides the standard error messages such as "no such file or directory":
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).
+ 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,
+ 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.
**bad Atari filename** *<filename>* *<reason>*
The filename stored in the ALF header doesn't follow the rules for