Man page: group diagnostics into fatal errors and warnings.

1 files changed, 19 insertions, 10 deletions

diff --git a/src/unalf.1 b/src/unalf.1
index b424038..5ca8547 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-21" "0.1.0" "Urchlay's Atari 8-bit Tools"
+.TH "UNALF" 1 "2025-11-22" "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:
@@ -250,15 +250,22 @@ has a bad checksum.
 .SH DIAGNOSTICS
 .sp
 Besides the standard error messages such as "no such file or directory":
+.SS Fatal errors
+.sp
+\fBunalf\fP will exit with status 1 immediately after these errors:
 .INDENT 0.0
 .TP
-.B \fBthis is an ARC file, not ALF\fP
+.B \fBfatal: this is an ARC file, not ALF\fP
 Self\-explanatory. Use the \fBarc\fP(1) utility for this file.
 .TP
-.B \fBnot an ALF file\fP
+.B \fBfatal: not an ALF file\fP
 Self\-explanatory. Either the file is too small (less than 29 bytes)
 or its first two bytes don\(aqt match the \fIALF\fP signature \fB0x1a\fP \fB0x0f\fP\&.
 .TP
+.B \fBfatal: stack underrun/overrun\fP
+Generally means the archive is corrupt. Valid ALF files should never
+cause these errors.
+.TP
 .B \fBjunk at EOF (ignored)\fP
 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
@@ -266,17 +273,19 @@ file gets padded to the block size of the filesystem or protocol.
 Usually, the padding characters are \fB0x1a\fP, aka ASCII control\-Z.
 .sp
 If you see this message, you can ignore it. It\(aqs intended to let
-you know that this .alf file can\(aqt be appended to by the \fBALF.COM\fP
-aka \fBLZ.COM\fP Atari utility.
+you know that this .alf file can\(aqt be appended to by the
+\fBLZ.COM\fP (aka \fBALF.COM\fP) Atari utility.
+.UNINDENT
+.SS Warnings
+.sp
+\fBunalf\fP will continue after these messages occur.
+.INDENT 0.0
 .TP
 .B \fBchecksum error on\fP \fI<file>\fP
 The archive is corrupt. If \fI<file>\fP is a text file, it may be
 partially readable. If it\(aqs an executable or other binary file, it\(aqs
-probably unrecoverable.
-.TP
-.B \fBstack underrun/overrun\fP
-Generally means the archive is corrupt. Valid ALF files should never
-cause these errors.
+probably unrecoverable. \fBunalf\fP will try to extract the rest of
+the archive, but will exit with status 2 when it\(aqs done.
 .sp
 If you have an ALF file that does this, try it with the Atari
 \fBDZ.COM\fP and see if it has the same problem. If it doesn\(aqt,