aboutsummaryrefslogtreecommitdiff
path: root/blob2xex.1
diff options
context:
space:
mode:
Diffstat (limited to 'blob2xex.1')
-rw-r--r--blob2xex.138
1 files changed, 32 insertions, 6 deletions
diff --git a/blob2xex.1 b/blob2xex.1
index 0780513..ee00503 100644
--- a/blob2xex.1
+++ b/blob2xex.1
@@ -117,14 +117,40 @@ Print version number and exit.
.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.
+\fBblob2xex\fP to exit with nonzero status, 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.
+created. There are only a few possible warnings:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.TP
+.B start/end address XXXX loads into ROM.
+This means your .exe file\(aqs start/end addresses will load the
+file 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 this warning if you know exactly
+what you\(aqre doing.
+.TP
+.B address would exceed $FFFF! truncated N bytes to N.
+The segment would wrap around the Atari\(aqs 64KB address space.
+\fBblob2xex\fP has truncated the input so the last address
+loaded is \fB$FFFF\fP\&. This warning usually means you gave the
+wrong load address or the wrong input file entirely.
+.TP
+.B extra arguments after last input file ignored.
+You gave at least one option that would affect the next file,
+after the last file on the command line. Such options are ignored,
+since there\(aqs no file for them to apply to. Probably you made
+a typo or forgot the last input file.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SH EXIT STATUS
+.sp
+Zero for success (the output file was created), even if there were
+warnings. Non\-zero for failure (the output file wasn\(aqt created).
.SH EXAMPLES
.SS Simple Example
.sp