From 190dfb3149ebb353b0bde2b108b9282bfcd58dcc Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Thu, 25 Apr 2024 00:11:30 -0400
Subject: blob2xex: made reading stdin work, limit segment size to end at
 $FFFF, warn if start/end addrs are in ROM, unlink output file on error.

---
 blob2xex.1 | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

(limited to 'blob2xex.1')

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
-- 
cgit v1.2.3