aboutsummaryrefslogtreecommitdiff
path: root/blob2xex.1
diff options
context:
space:
mode:
Diffstat (limited to 'blob2xex.1')
-rw-r--r--blob2xex.126
1 files changed, 15 insertions, 11 deletions
diff --git a/blob2xex.1 b/blob2xex.1
index cf118b1..51344f8 100644
--- a/blob2xex.1
+++ b/blob2xex.1
@@ -40,26 +40,30 @@ blob2xex \fIoutfile\fP [\fB\-v\fP] [\fB\-r\fP \fIrunaddr\fP] [\fB\-l\fP \fIloada
.SH DESCRIPTION
.sp
\fBblob2xex\fP creates an Atari 8\-bit binary load (xex) file from one or
-more files of arbitrary data.
+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, run and init addresses can be included. 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\&.
+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
+(\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\&.
.sp
\fIoutfile\fP must be given as the first argument. When multiple
input files are used, the resulting .xex file will have multiple
-segments. If \fIoutfile\fP already exists, it will be overwritten. Use
-\fB\-\fP to write to standard output. If \fIoutfile\fP is a filename that
-begins with a \fB\-\fP, prefix it with "./", otherwise it\(aqll be taken as
-an option.
+segments. If \fIoutfile\fP already exists, it will be overwritten.
+If \fIoutfile\fP is a filename that begins with a \fB\-\fP, prefix it with
+"./", otherwise it\(aqll be taken as an option. Use \fB\-\fP to write to
+standard output. \fBblob2xex\fP will not write output to a terminal;
+\fB\-\fP must be used with redirection or a pipe.
.sp
Addresses, offsets, and sizes may be given in decimal or hex. Hex
addresses must be prefixed with either \fB$\fP or \fB0x\fP\&.
.SH OPTIONS
.sp
-A space is required between an option and its argument; use e.g. \fB\-l 0x2000*,
-not **\-l0x2000\fP\&.
+A space is required between an option and its argument; use e.g. \fB\-l 0x2000\fP,
+not \fB\-l0x2000\fP\&.
.INDENT 0.0
.TP
.B \-l \fIloadaddr\fP