From 4856221ec9a08d472390df8a9f669854a811814c Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sat, 29 Nov 2025 04:22:46 -0500 Subject: Add DIAGNOSTICS to alf man page. --- src/alf.1 | 25 +++++++++++++++++++++++++ src/alf.rst | 21 +++++++++++++++++++++ 2 files changed, 46 insertions(+) diff --git a/src/alf.1 b/src/alf.1 index 87d0a36..9198ec4 100644 --- a/src/alf.1 +++ b/src/alf.1 @@ -130,6 +130,31 @@ Success. .B 1 Fatal error (I/O or bad command\-line arguments). .UNINDENT +.SH DIAGNOSTICS +.sp +Besides the standard error messages such as "no such file or directory", \fBalf\fP +can generate warnings about the filenames it\(aqs compressing: +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.TP +.B \fBfilename has underscore, OK on Sparta/MyDOS, not Atari DOS 2.x\fP +Not an actual problem, unless you try to extract this ALF file on +an Atari running Atari DOS 2.0/2.5, or any other DOS that doesn\(aqt +allow underscores in filenames. +.TP +.B \fBbad Atari filename\fP \fI\fP \fI\fP +The filename stored in the ALF header doesn\(aqt follow the rules for +Atari DOS filenames. \fI\fP will be something like "doesn\(aqt start +with A\-Z" or "invalid character". The filename will be printed with +any unprintable characters as hex values (e.g. \fB$01\fP). +.UNINDENT +.UNINDENT +.UNINDENT +.sp +The resulting \fIALF\fP archive will extract with \fBunalf\fP, but will have +problems with \fBDZ.COM\fP running on an Atari. Or you can just rename +the files so they comply with Atari DOS filename restrictions. .SH NOTES .SS Compatibility .sp diff --git a/src/alf.rst b/src/alf.rst index 4b011aa..59dc2af 100644 --- a/src/alf.rst +++ b/src/alf.rst @@ -104,6 +104,27 @@ EXIT STATUS 1 Fatal error (I/O or bad command-line arguments). +DIAGNOSTICS +=========== + +Besides the standard error messages such as "no such file or directory", **alf** +can generate warnings about the filenames it's compressing: + + **filename has underscore, OK on Sparta/MyDOS, not Atari DOS 2.x** + Not an actual problem, unless you try to extract this ALF file on + an Atari running Atari DOS 2.0/2.5, or any other DOS that doesn't + allow underscores in filenames. + + **bad Atari filename** ** ** + The filename stored in the ALF header doesn't follow the rules for + Atari DOS filenames. ** will be something like "doesn't start + with A-Z" or "invalid character". The filename will be printed with + any unprintable characters as hex values (e.g. **$01**). + +The resulting *ALF* archive will extract with **unalf**, but will have +problems with **DZ.COM** running on an Atari. Or you can just rename +the files so they comply with Atari DOS filename restrictions. + NOTES ===== -- cgit v1.2.3