aboutsummaryrefslogtreecommitdiff
path: root/xexcat.1
diff options
context:
space:
mode:
Diffstat (limited to 'xexcat.1')
-rw-r--r--xexcat.133
1 files changed, 24 insertions, 9 deletions
diff --git a/xexcat.1 b/xexcat.1
index 70bded7..8b94f98 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-26" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "XEXCAT" 1 "2024-04-27" "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:
@@ -38,7 +38,7 @@ xexcat \- Concatenate Atari 8-bit executables (XEX) into a single XEX file.
.
.SH SYNOPSIS
.sp
-\fIxexcat\fP [\fI\-hvc\fP] [\-l \fIaddress\fP [\-r \fIaddress\fP] [\-i \fIaddress\fP] [\-o \fIoutfile.xex\fP] [\fIinfile.xex\fP] [\fIinfile.xex ...\fP]
+\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)
@@ -56,13 +56,6 @@ optional \fI$FFFF\fP header.
.SH OPTIONS
.INDENT 0.0
.TP
-.B \-h
-Print a short help message and exit.
-.TP
-.B \-v
-Verbose operation. Each segment\(aqs information is printed to
-standard error, including start/end address and length.
-.TP
.B \-c
Check only; no output file is written. Equivalent to \fB\-v \-o /dev/null\fP\&.
.TP
@@ -91,6 +84,28 @@ is 0, all run addresses from all input files are ignored,
and the output file will not contain a run address segment
at all. Such a file can still be loaded from DOS, but it will
not execute (user will be returned to the DOS menu).
+.TP
+.B \-a
+"Automatic" run address: Force the output file\(aqs run address to the
+load address of the first segment.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f 1|2
+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.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-h
+Print a short help message and exit.
+.TP
+.B \-v
+Verbose operation. Each segment\(aqs information is printed to
+standard error, including start/end address and length.
.UNINDENT
.SH NOTES
.sp