From 547b463ed5571815cacb77e8fe7e778a157612e3 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Sun, 28 Apr 2024 14:29:23 -0400 Subject: xexcat: tweak doc. --- xexcat.1 | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) (limited to 'xexcat.1') 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 -- cgit v1.2.3