diff options
Diffstat (limited to 'blob2xex.rst')
-rw-r--r-- | blob2xex.rst | 34 |
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 ======== |