diff options
Diffstat (limited to 'blob2xex.rst')
-rw-r--r-- | blob2xex.rst | 24 |
1 files changed, 14 insertions, 10 deletions
diff --git a/blob2xex.rst b/blob2xex.rst index 18ebd6e..4166f64 100644 --- a/blob2xex.rst +++ b/blob2xex.rst @@ -20,19 +20,23 @@ DESCRIPTION =========== **blob2xex** creates an Atari 8-bit binary load (xex) file from one or -more files of arbitrary data. +more files of arbitrary data. Each input file will become a separate +segment in the binary load file. A run address can be added with the +**-r** option. -Each input file *requires* a **-l** *loadaddr* option, to set the load -address. Optionally, run and init addresses can be included. Also, -using **-o** and **-s**, it's possible to include only part of the -input file. To read from standard input, use **-** for the *infile*. +Each input file *requires* a **-l** *loadaddr* option, to set the +load address. Optionally, init addresses can be included, per-segment +(**-i**). Also, using **-o** and **-s**, it's possible to include only +part of the input file. To read from standard input, use **-** for the +*infile*. *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. Use -**-** to write to standard output. If *outfile* is a filename that -begins with a **-**, prefix it with "./", otherwise it'll be taken as -an option. +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. Addresses, offsets, and sizes may be given in decimal or hex. Hex addresses must be prefixed with either **$** or **0x**. @@ -40,7 +44,7 @@ addresses must be prefixed with either **$** or **0x**. OPTIONS ======= -A space is required between an option and its argument; use e.g. **-l 0x2000*, +A space is required between an option and its argument; use e.g. **-l 0x2000**, not **-l0x2000**. -l *loadaddr* |