diff options
| author | B. Watson <urchlay@slackware.uk> | 2024-04-24 15:04:50 -0400 |
|---|---|---|
| committer | B. Watson <urchlay@slackware.uk> | 2024-04-24 15:04:50 -0400 |
| commit | 1deab5d25136624f7e9a6d6446f5d218a243f56b (patch) | |
| tree | ab232233646e7d7778c43349b0186f09b660d25e /blob2xex.rst | |
| parent | 53a0578bd0605cfa39e7d8d126aa78fb216527d3 (diff) | |
| download | bw-atari8-tools-1deab5d25136624f7e9a6d6446f5d218a243f56b.tar.gz | |
blob2xex: initial implementation, needs testing.
Diffstat (limited to 'blob2xex.rst')
| -rw-r--r-- | blob2xex.rst | 17 |
1 files changed, 11 insertions, 6 deletions
diff --git a/blob2xex.rst b/blob2xex.rst index bbf0e0f..cf5bf10 100644 --- a/blob2xex.rst +++ b/blob2xex.rst @@ -14,7 +14,7 @@ Create Atari 8-bit executables from arbitrary data SYNOPSIS ======== -blob2xex [**-l** *loadaddr* [**-r** *runaddr*] [**-i** *initaddr*] [**-o** *offset*] [**-s** *size*] *infile*] ... *outfile* +blob2xex *outfile* [**-r** *runaddr*] [**-l** *loadaddr* [**-i** *initaddr*] [**-o** *offset*] [**-s** *size*] *infile*] ... DESCRIPTION =========== @@ -27,9 +27,10 @@ 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*. -Only one *outfile* is supported. When multiple input files are used, -the resulting .xex file will have multiple segments. Use **-** to -write to standard output. +*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. Addresses, offsets, and sizes may be given in decimal or hex. Hex addresses must be prefixed with either **$** or **0x**. @@ -37,13 +38,16 @@ addresses must be prefixed with either **$** or **0x**. OPTIONS ======= +A space is required between an option and its argument; use e.g. **-l 0x2000*, +not **-l0x2000**. + -l *loadaddr* Set the load address of the next *infile*. Each *infile* must be preceded by a **-l** option. -r *runaddr* Optional; set the run address. Since a .xex file can only have one run address, - the last **-r** option will be the one used when the file is loaded on the Atari. + the last **-r** option will be the one used. -i *initaddr* Optional; set an init address, to be executed after the next segment loads. @@ -52,7 +56,8 @@ OPTIONS Optional; skip this many bytes of the next input file. Default is **0**. -s *size* - Optional; read this many bytes of the next input file. Default is the entire file. + Optional; read this many bytes of the next input file. Default is the entire file, + or **0xffff** (**65535**) if the file is longer than 64KB. EXAMPLES ======== |