xexcat: tweak doc.

1 files changed, 14 insertions, 9 deletions

diff --git a/xexcat.1 b/xexcat.1
index 8b94f98..522bedf 100644
--- a/xexcat.1
+++ b/xexcat.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 "XEXCAT" 1 "2024-04-27" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "XEXCAT" 1 "2024-04-28" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 xexcat \- Concatenate Atari 8-bit executables (XEX) into a single XEX file.
 .\" RST source for xexcat(1) man page. Convert with:
@@ -41,13 +41,14 @@ xexcat \- Concatenate Atari 8-bit executables (XEX) into a single XEX file.
 \fBxexcat\fP [\fB\-hvc\fP] [\fB\-f\fP \fI1\fP | \fI2\fP] [\fB\-l\fP \fIaddress\fP [\fB\-r\fP \fIaddress\fP]  [\fB\-i\fP  \fIaddress\fP] [\fB\-o\fP  \fIoutfile.xex\fP] [\fIinfile.xex\fP] [\fIinfile.xex ...\fP]
 .SH DESCRIPTION
 .sp
-\fBxexcat\fP  reads  one or more Atari executables (XEX/BIN/COM/etc)
-from the given filenames, and writes a single Atari  executable
-containing  all the segments from all the input files to \fIoutfile\fP\&.
+\fBxexcat\fP reads one or more Atari executables (XEX/BIN/COM/etc),
+or \fBdasm\fP(1) \fB\-f1\fP, \fB\-f2\fP files; it writes a single Atari
+executable containing all the segments from all the input files to
+\fIoutfile\fP\&.
 .sp
-To  read  from  standard input, \fIinfile\fP may be omitted, or given as
-\fB\-\fP\&. To write to standard output, \fB\-o\fP \fIoutfile\fP may be  omitted,
-or  given  as \fB\-o\-\fP\&.
+To read from standard input, \fIinfile\fP may be omitted, or given as
+\fB\-\fP\&. To write to standard output, \fB\-o\fP \fIoutfile\fP may be omitted,
+or given as \fB\-o\-\fP\&.
 .sp
 The  output  file  is  a valid Atari executable, including the
 required \fI$FFFF\fP header for the first segment. If there are multiple
@@ -91,12 +92,16 @@ load address of the first segment.
 .UNINDENT
 .INDENT 0.0
 .TP
-.B \-f 1|2
+.B \fB\-f\fP \fI1\fP | \fI2\fP
 Input file(s) are \fBdasm\fP(1) object files created by \fB\-f1\fP or
 \fB\-f2\fP options, rather than .xex files. \fB\-f1\fP files can\(aqt contain
 run or init addresses, so you\(aqll probably want to use \fB\-r\fP,
 \fB\-a\fP, and/or \fB\-i\fP with these. \fB\-f2\fP files can contain run or
-init addresses. The output file is still a .xex file.
+init addresses. The output file is still a .xex file. Note that this
+flag affects all input files: if you\(aqre trying to join a \fBdasm\fP
+file with a .xex file, it must be done in two steps: convert the
+\fBdasm\fP file to a .xex, then combine the two .xex files with a
+second run of \fBxexcat\fP\&.
 .UNINDENT
 .INDENT 0.0
 .TP