aboutsummaryrefslogtreecommitdiff
path: root/blob2xex.1
diff options
context:
space:
mode:
Diffstat (limited to 'blob2xex.1')
-rw-r--r--blob2xex.119
1 files changed, 12 insertions, 7 deletions
diff --git a/blob2xex.1 b/blob2xex.1
index 108d5b9..0780513 100644
--- a/blob2xex.1
+++ b/blob2xex.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 "BLOB2XEX" 1 "2024-05-03" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "BLOB2XEX" 1 "2024-05-16" "0.2.1" "Urchlay's Atari 8-bit Tools"
.SH NAME
blob2xex \- Create Atari 8-bit executables from arbitrary data
.\" RST source for blob2xex(1) man page. Convert with:
@@ -44,8 +44,12 @@ more files of arbitrary data. Each input file will become a separate
segment in the binary load file. A run address can be added with the
\fB\-r\fP option.
.sp
-Each input file \fIrequires\fP a \fB\-l\fP \fIloadaddr\fP option, to set the
-load address. Optionally, init addresses can be included, per\-segment
+The first input file \fIrequires\fP a \fB\-l\fP \fIloadaddr\fP option, to set the
+load address. Further input files can have their load addresses set
+with \fB\-l\fP, also. If an input file lacks a load address, it will
+load at the next address after the previous file\(aqs ending address.
+.sp
+Optionally, init addresses can be included, per\-segment
(\fB\-i\fP). Also, using \fB\-o\fP and \fB\-s\fP, it\(aqs possible to include only
part of the input file. To read from standard input, use \fB\-\fP for the
\fIinfile\fP\&.
@@ -71,6 +75,11 @@ A space is required between an option and its argument; use e.g. \fB\-l 0x2000\f
not \fB\-l0x2000\fP\&.
.INDENT 0.0
.TP
+.B \-l \fIloadaddr\fP
+Required; set the load address of the next \fIinfile\fP\&. The first \fIinfile\fP
+\fBmust\fP be preceded by a \fB\-l\fP option; it\(aqs optional for the 2nd and
+further files.
+.TP
.B \-r \fIrunaddr\fP
Optional; set the run address. Default is no run address. Since a
\&.xex file can only have one run address, there\(aqs no point in giving
@@ -78,10 +87,6 @@ multiple \fB\-r\fP options. If you do, the last one will be used. This
option should be first on the command line (right after \fIoutfile\fP),
or at least must occur before any \fIinfile\fP\&.
.TP
-.B \-l \fIloadaddr\fP
-Required; set the load address of the next \fIinfile\fP\&. Each \fIinfile\fP
-\fBmust\fP be preceded by a \fB\-l\fP option.
-.TP
.B \-i \fIinitaddr\fP
Optional; set an init address, to be executed after the next segment loads.
Default is no init address.