blob2xex: tweak doc.

1 files changed, 19 insertions, 5 deletions

diff --git a/blob2xex.1 b/blob2xex.1
index 757d68d..5858db2 100644
--- a/blob2xex.1
+++ b/blob2xex.1
@@ -52,11 +52,13 @@ part of the input file. To read from standard input, use \fB\-\fP for the
 .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.
-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.
+segments. If \fIoutfile\fP already exists, it will be \fIoverwritten\fP
+(or \fIdeleted\fP, in case of error). 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
+If \fIoutfile\fP or any \fIinfile\fP is a filename that begins with a \fB\-\fP,
+prefix it with "./", otherwise it\(aqll be taken as an option.
 .sp
 Addresses, offsets, and sizes may be given in decimal or hex. Hex
 addresses must be prefixed with either \fB$\fP or \fB0x\fP\&.
@@ -95,6 +97,18 @@ Print usage message and exit.
 .B  \-V\fP,\fB  \-\-version
 Print version number and exit.
 .UNINDENT
+.SH DIAGNOSTICS
+.sp
+Error messages and warnings are printed to standard error, and are
+hopefully self\-explanatory. Any message containing \fIfatal\fP causes
+\fBblob2xex\fP to exit without creating the output file.
+.sp
+Messages containing \fIwarning\fP are non\-fatal, and the output file is
+created. The only warning messages are there to let you know if your
+\&.xex file\(aqs start/end addresses mean it would load into ROM (or, the
+unmapped area at \fB$C000\fP on a 400/800). Normally this means the .xex
+file won\(aqt load properly on the Atari, but feel free to ignore the
+warnings if you know exactly what you\(aqre doing.
 .SH EXAMPLES
 .SS Simple Example
 .sp