unalf: actually use timestamps from the alf header (and add -T option to not use them).

1 files changed, 11 insertions, 7 deletions

diff --git a/src/unalf.1 b/src/unalf.1
index a8149c5..3306279 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-28" "0.2.0" "Urchlay's Atari 8-bit Tools"
+.TH "UNALF" 1 "2025-11-29" "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:
@@ -187,13 +187,18 @@ anywhere.
 .
 .INDENT 0.0
 .TP
+.B  \-T
+Ignore timestamps in \fIalf\-file\fP, when extracting. Normally the extracted files
+have their \fBmtime\fP set to the time saved in the archive. With \fB\-T\fP, the
+extracted files will have \fBmtime\fP set to the current time.
+.TP
 .B  \-v
 Verbose listing of archive contents, with compressed and original
 sizes, compression ration, date/time stamps, and checksum. The
 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".
+default values of "8 Jan 82  12:24:38a".
 .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
@@ -357,17 +362,16 @@ to standard output and text file EOL conversion.
 .IP \(bu 2
 Turning the screen off for speed makes no sense on modern operating
 systems, so there\(aqs no option for that.
+.IP \(bu 2
+The timestamps saved in the archive are actually used to set the
+date/time of the extracted files (though this can be disabled with \fB\-T\fP).
 .UNINDENT
 .sp
-Neither this \fBunalf\fP nor \fBDZ.COM\fP actually use the dates/times
-stored in the archive. Extracted files will have their timestamps set
-to the current date/time.
-.sp
 A note about the Atari filenames: \fBDZ.COM\fP is sometimes found on
 old disk images as \fBUNALF.COM\fP, and \fBLZ.COM\fP is sometimes called
 \fBALF.COM\fP or \fBALFER.COM\fP\&. I\(aqve used the original names partly
 out of respect for the original author, and partly to avoid confusion
-between my \fBunalf\fP and the Atari one.
+between my \fBalf\fP/\fBunalf\fP and his Atari ones.
 .SH BUGS
 .sp
 A minor one: \fBunalf\fP can\(aqt correctly extract files larger than about