diff options
Diffstat (limited to 'src/alf.1')
| -rw-r--r-- | src/alf.1 | 31 |
1 files changed, 21 insertions, 10 deletions
@@ -36,7 +36,7 @@ alf \- create Atari 8-bit ALF archives . .SH SYNOPSIS .sp -alf [\fB\-\-help\fP] | [\fB\-a\fP | \fB\-o\fP ] [\fB\-t[dgz]\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\fP [\fIfile\fP ...] .SH DESCRIPTION .sp \fBalf\fP creates \fIALF\fP archives. @@ -114,6 +114,11 @@ Use zero for timestamps (0 ??? 80 12:00a). . .INDENT 0.0 .TP +.B \-v +Verbose operation. Shows more information about what \fBalf\fP is doing. +Can be given twice for more detail, or 3 times to dump the token +tables (\fIlots\fP of output; for debugging only). +.TP .B \-V\fP,\fB \-\-version Show \fBunalf\fP version number and exit. .UNINDENT @@ -132,10 +137,9 @@ 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 +Besides the standard error messages such as "no such file or +directory": +.SS Filenames .INDENT 0.0 .TP .B \fBfilename has underscore, OK on Sparta/MyDOS, not Atari DOS 2.x\fP @@ -149,12 +153,19 @@ Atari DOS filenames. \fI<reason>\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. +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. +.SS File Size +.INDENT 0.0 +.TP +.B \fBthis file is too large; only compressing the first 16MB.\fP +The \fIALF\fP file format doesn\(aqt support files larger than +16MB. Actually the \fIfile format\fP does, but the decompressor +(either \fBDZ.COM\fP or \fBunalf\fP) does not. +.UNINDENT .SH NOTES .SS Compatibility .sp |