diff options
Diffstat (limited to 'blob2xex.1')
| -rw-r--r-- | blob2xex.1 | 24 |
1 files changed, 19 insertions, 5 deletions
@@ -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 |