1 files changed, 28 insertions, 6 deletions
diff --git a/blob2xex.rst b/blob2xex.rst
index a3161ab..9984b2b 100644
--- a/blob2xex.rst
+++ b/blob2xex.rst
@@ -97,14 +97,36 @@ DIAGNOSTICS
 
 Error messages and warnings are printed to standard error, and are
 hopefully self-explanatory. Any message containing *fatal* causes
-**blob2xex** to exit without creating the output file.
+**blob2xex** to exit with nonzero status, without creating the output
+file.
 
 Messages containing *warning* are non-fatal, and the output file is
-created. The only warning messages are there to let you know if your
-.xex file's start/end addresses mean it would load into ROM (or, the
-unmapped area at **$C000** on a 400/800). Normally this means the .xex
-file won't load properly on the Atari, but feel free to ignore the
-warnings if you know exactly what you're doing.
+created. There are only a few possible warnings:
+
+  start/end address XXXX loads into ROM.
+    This means your .exe file's start/end addresses will load the
+    file into ROM (or the unmapped area at **$C000** on a 400/800).
+    Normally this means the .xex file won't load properly on the
+    Atari, but feel free to ignore this warning if you know exactly
+    what you're doing.
+
+  address would exceed $FFFF! truncated N bytes to N.
+    The segment would wrap around the Atari's 64KB address space.
+    **blob2xex** has truncated the input so the last address
+    loaded is **$FFFF**. This warning usually means you gave the
+    wrong load address or the wrong input file entirely.
+
+  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's no file for them to apply to. Probably you made
+    a typo or forgot the last input file.
+
+EXIT STATUS
+===========
+
+Zero for success (the output file was created), even if there were
+warnings. Non-zero for failure (the output file wasn't created).
 
 EXAMPLES
 ========