From 802b5a0760179d9a5fd2d241745733c42a67fcc4 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Fri, 28 Nov 2025 00:18:28 -0500 Subject: Update unalf man page. --- src/unalf.1 | 11 ++++++----- src/unalf.rst | 9 +++++---- 2 files changed, 11 insertions(+), 9 deletions(-) diff --git a/src/unalf.1 b/src/unalf.1 index 36b7802..3343162 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-27" "0.2.0" "Urchlay's Atari 8-bit Tools" +.TH "UNALF" 1 "2025-11-28" "0.2.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: @@ -288,15 +288,16 @@ Self\-explanatory. The ALF file ends before the compressed data does. \fBunalf\fP will continue after these messages occur. .INDENT 0.0 .TP -.B \fBjunk at EOF (ignored)\fP +.B \fBjunk at EOF (ignoring)\fP +Mostly harmless: does \fInot\fP imply data corruption. +.sp 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. 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 -\fBLZ.COM\fP (aka \fBALF.COM\fP) Atari utility. +This message means you can\(aqt append to the ALF file with \fBalf \-a\fP +or \fBLZ.COM\fP\&. You can, however, use \fBunalf \-f\fP to remove the junk. .TP .B \fBchecksum error on\fP \fI\fP The archive is corrupt. If \fI\fP is a text file, it may be diff --git a/src/unalf.rst b/src/unalf.rst index c6ad52c..e94fc21 100644 --- a/src/unalf.rst +++ b/src/unalf.rst @@ -242,15 +242,16 @@ Warnings **unalf** will continue after these messages occur. -**junk at EOF (ignored)** +**junk at EOF (ignoring)** + Mostly harmless: does *not* imply data corruption. + 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. Usually, the padding characters are **0x1a**, aka ASCII control-Z. - If you see this message, you can ignore it. It's intended to let - you know that this .alf file can't be appended to by the - **LZ.COM** (aka **ALF.COM**) Atari utility. + This message means you can't append to the ALF file with **alf -a** + or **LZ.COM**. You can, however, use **unalf -f** to remove the junk. **checksum error on** ** The archive is corrupt. If ** is a text file, it may be -- cgit v1.2.3