From 1deab5d25136624f7e9a6d6446f5d218a243f56b Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Wed, 24 Apr 2024 15:04:50 -0400
Subject: blob2xex: initial implementation, needs testing.

---
 blob2xex.1 | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

(limited to 'blob2xex.1')

diff --git a/blob2xex.1 b/blob2xex.1
index 943a1e2..831519f 100644
--- a/blob2xex.1
+++ b/blob2xex.1
@@ -36,7 +36,7 @@ blob2xex \- Create Atari 8-bit executables from arbitrary data
 .
 .SH SYNOPSIS
 .sp
-blob2xex [\fB\-l\fP \fIloadaddr\fP [\fB\-r\fP \fIrunaddr\fP] [\fB\-i\fP \fIinitaddr\fP] [\fB\-o\fP \fIoffset\fP] [\fB\-s\fP \fIsize\fP] \fIinfile\fP] ... \fIoutfile\fP
+blob2xex \fIoutfile\fP [\fB\-r\fP \fIrunaddr\fP] [\fB\-l\fP \fIloadaddr\fP [\fB\-i\fP \fIinitaddr\fP] [\fB\-o\fP \fIoffset\fP] [\fB\-s\fP \fIsize\fP] \fIinfile\fP] ...
 .SH DESCRIPTION
 .sp
 \fBblob2xex\fP creates an Atari 8\-bit binary load (xex) file from one or
@@ -47,13 +47,17 @@ 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\&.
 .sp
-Only one \fIoutfile\fP is supported. When multiple input files are used,
-the resulting .xex file will have multiple segments. Use \fB\-\fP to
-write to standard output.
+\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.
 .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\&.
 .INDENT 0.0
 .TP
 .B \-l \fIloadaddr\fP
@@ -62,7 +66,7 @@ a \fB\-l\fP option.
 .TP
 .B \-r \fIrunaddr\fP
 Optional; set the run address. Since a .xex file can only have one run address,
-the last \fB\-r\fP option will be the one used when the file is loaded on the Atari.
+the last \fB\-r\fP option will be the one used.
 .TP
 .B \-i \fIinitaddr\fP
 Optional; set an init address, to be executed after the next segment loads.
@@ -71,7 +75,8 @@ Optional; set an init address, to be executed after the next segment loads.
 Optional; skip this many bytes of the next input file. Default is \fB0\fP\&.
 .TP
 .B \-s \fIsize\fP
-Optional; read this many bytes of the next input file. Default is the entire file.
+Optional; read this many bytes of the next input file. Default is the entire file,
+or \fB0xffff\fP (\fB65535\fP) if the file is longer than 64KB.
 .UNINDENT
 .SH EXAMPLES
 .sp
-- 
cgit v1.2.3