diff options
Diffstat (limited to 'blob2xex.rst')
| -rw-r--r-- | blob2xex.rst | 26 |
1 files changed, 21 insertions, 5 deletions
diff --git a/blob2xex.rst b/blob2xex.rst index 6bbbefc..9330445 100644 --- a/blob2xex.rst +++ b/blob2xex.rst @@ -32,11 +32,13 @@ part of the input file. To read from standard input, use **-** for the *outfile* must be given as the first argument. When multiple input files are used, the resulting .xex file will have multiple -segments. If *outfile* already exists, it will be overwritten. -If *outfile* is a filename that begins with a **-**, prefix it with -"./", otherwise it'll be taken as an option. Use **-** to write to -standard output. **blob2xex** will not write output to a terminal; -**-** must be used with redirection or a pipe. +segments. If *outfile* already exists, it will be *overwritten* +(or *deleted*, in case of error). Use **-** to write to standard +output. **blob2xex** will not write output to a terminal; **-** must +be used with redirection or a pipe. + +If *outfile* or any *infile* is a filename that begins with a **-**, +prefix it with "./", otherwise it'll be taken as an option. Addresses, offsets, and sizes may be given in decimal or hex. Hex addresses must be prefixed with either **$** or **0x**. @@ -74,6 +76,20 @@ not **-l0x2000**. -V, --version Print version number and exit. +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. + +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. + EXAMPLES ======== |