From 96f910dae2456013ebc932be60c57e7712dbec69 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sat, 6 Dec 2025 05:30:38 -0500 Subject: Document file=NAME syntax. --- src/alf.1 | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) (limited to 'src/alf.1') diff --git a/src/alf.1 b/src/alf.1 index ae374fb..0f519b8 100644 --- a/src/alf.1 +++ b/src/alf.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 "ALF" 1 "2025-12-04" "0.4.0" "Urchlay's Atari 8-bit Tools" +.TH "ALF" 1 "2025-12-06" "0.4.0" "Urchlay's Atari 8-bit Tools" .SH NAME alf \- create Atari 8-bit ALF archives .\" RST source for alf(1) man page. Convert with: @@ -36,7 +36,7 @@ alf \- create Atari 8-bit ALF archives . .SH SYNOPSIS .sp -alf [\fB\-\-help\fP] | [\fB\-\-version\fP | \fB\-V\fP | [\fB\-a\fP | \fB\-o\fP ] [\fB\-t[dgz]\fP] [\fB\-v\fP] \fIalf\-file\fP \fIfile\fP [\fIfile\fP ...] +alf [\fB\-\-help\fP] | [\fB\-\-version\fP | \fB\-V\fP | [\fB\-a\fP | \fB\-o\fP ] [\fB\-t[dgz]\fP] [\fB\-v\fP] \fIalf\-file\fP \fIfile[=NAME]\fP [\fIfile[=NAME]\fP ...] .SH DESCRIPTION .sp \fBalf\fP creates \fIALF\fP archives. @@ -159,6 +159,24 @@ With either of the above, 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. +.INDENT 0.0 +.TP +.B \fBduplicate Atari filename\fP \fI\fP +You gave the same filename twice, or you gave two (or more) filenames that +convert to the same "8.3" Atari filename. Example: \fIfoo.bar\fP and \fIfoo.barf\fP +both get stored as \fIFOO.BAR\fP\&. You can avoid this by using the \fIfile=NAME\fP +syntax, e.g.: +.INDENT 7.0 +.INDENT 3.5 +.sp +.nf +.ft C +$ alf ARCHIVE.ALF foo.bar foo.barf=FOO.BRF +.ft P +.fi +.UNINDENT +.UNINDENT +.UNINDENT .SS File Size .INDENT 0.0 .TP -- cgit v1.2.3