diff options
| -rw-r--r-- | src/unalf.1 | 26 | ||||
| -rw-r--r-- | src/unalf.rst | 24 |
2 files changed, 31 insertions, 19 deletions
diff --git a/src/unalf.1 b/src/unalf.1 index 27d9522..7d62a01 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-15" "0.1.0" "Urchlay's Atari 8-bit Tools" +.TH "UNALF" 1 "2025-11-16" "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: @@ -110,7 +110,8 @@ named \fBFOO\fP, so \fBunalf\fP does the same by default. .TP .B \-l List filenames in archive, one per line, but do not extract. Use -\fB\-v\fP for more information (file size, etc). +\fB\-v\fP for more information (file size, etc). Obeys \fIwildcards\fP and +the \fB\-x\fP, \fB\-L\fP, \fB\-k\fP options. .UNINDENT .\" list files in archive (filenames only). . @@ -148,9 +149,9 @@ been warned. .INDENT 0.0 .TP .B \-q -Quiet extraction: do not print "Uncrunching \fIfile\fP" messages. Errors -and warnings will still be printed. This is the default when \fB\-p\fP -is used. +Quiet extraction or testing: do not print "Uncrunching \fIfile\fP" +or "Testing \fIfile\fP" messages. Errors and warnings will still be +printed. This is the default when \fB\-p\fP is used. .UNINDENT .\" quiet: don't print filenames during extraction. . @@ -171,6 +172,10 @@ output format is similar to that of \fBarc \-v\fP, minus the \fIStowage\fP column, since \fIALF\fP doesn\(aqt support multiple compression types. The date and time are displayed, but in most .alf files these are the default values of "8 Jan 82 12:24a". +.sp +Unlike \fB\-l\fP, the \fB\-v\fP listing shows the filenames exactly as +stored in the archive (ignores \fB\-L\fP, enables \fB\-k\fP), and always +shows all the files (ignores \fIwildcards\fP and \fB\-x\fP). .UNINDENT .\" verbose listing of archive contents. . @@ -225,7 +230,7 @@ unalf filename.alf \(aq*.txt\(aq Success. .TP .B 1 -Fatal error (I/O or bad command\-line arguments). +Fatal error (I/O or bad command\-line arguments, stack under/overrun). .TP .B 2 Processing completed OK, but at least one file in the archive @@ -262,10 +267,11 @@ probably unrecoverable. 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 does, you\(aqve found a bug in \fBunalf\fP, please send me the -\&.alf file via email (see \fBAUTHOR\fP, below). +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, +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. .TP .B \fBbad Atari filename\fP \fI<filename>\fP \fI<reason>\fP The filename stored in the ALF header doesn\(aqt follow the rules for 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 |