From 4472fecc92ccf8ec327a8047080a1b9f80b1ac44 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Thu, 25 Apr 2024 02:23:04 -0400 Subject: blob2xex: tweak doc. --- blob2xex.rst | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) (limited to 'blob2xex.rst') 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, -- cgit v1.2.3