aboutsummaryrefslogtreecommitdiff
path: root/blob2xex.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-04-25 02:23:04 -0400
committerB. Watson <urchlay@slackware.uk>2024-04-25 02:23:04 -0400
commit4472fecc92ccf8ec327a8047080a1b9f80b1ac44 (patch)
tree978677e3f97635a1cf4a8d7b0c05973aae222152 /blob2xex.rst
parentd08f4bbaa91d841a2416a5728aa1a5f0ed5dd071 (diff)
downloadbw-atari8-tools-4472fecc92ccf8ec327a8047080a1b9f80b1ac44.tar.gz
blob2xex: tweak doc.
Diffstat (limited to 'blob2xex.rst')
-rw-r--r--blob2xex.rst21
1 files changed, 13 insertions, 8 deletions
diff --git a/blob2xex.rst b/blob2xex.rst
index 9699c2b..af6a220 100644
--- a/blob2xex.rst
+++ b/blob2xex.rst
@@ -38,7 +38,10 @@ 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.
+prefix it with "./", otherwise it'll be taken as an option. The GNU
+style **--** (end of options) isn't implemented because it doesn't
+make sense here. How often do you really use **-** at the start of a
+filename, anyway?
Addresses, offsets, and sizes may be given in decimal or hex. Hex
addresses must be prefixed with either **$** or **0x**.
@@ -50,21 +53,23 @@ A space is required between an option and its argument; use e.g. **-l 0x2000**,
not **-l0x2000**.
-r *runaddr*
- Optional; set the run address. Since a .xex file can only have one
- run address, there's no point in giving multiple **-r** options. If
- you do, the last one will be used. This option should be first on
- the command line (right after *outfile*), or at least must occur
- before any *infile*.
+ Optional; set the run address. Default is no run address. Since a
+ .xex file can only have one run address, there's no point in giving
+ multiple **-r** options. If you do, the last one will be used. This
+ option should be first on the command line (right after *outfile*),
+ or at least must occur before any *infile*.
-l *loadaddr*
- Set the load address of the next *infile*. Each *infile* must be preceded by
- a **-l** option.
+ Required; set the load address of the next *infile*. Each *infile*
+ **must** be preceded by a **-l** option.
-i *initaddr*
Optional; set an init address, to be executed after the next segment loads.
+ Default is no init address.
-o *offset*
Optional; skip this many bytes of the next input file. Default is **0**.
+ See the **Complex Example** below.
-s *size*
Optional; read this many bytes of the next input file. Default is the entire file,