From 82538a0230ff580c1ba251e8756c881380585587 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Thu, 16 May 2024 04:53:00 -0400 Subject: blob2xex: 2nd and further segments load consecutively, if no -l options for them. --- blob2xex.1 | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) (limited to 'blob2xex.1') diff --git a/blob2xex.1 b/blob2xex.1 index 108d5b9..0780513 100644 --- a/blob2xex.1 +++ b/blob2xex.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BLOB2XEX" 1 "2024-05-03" "0.2.1" "Urchlay's Atari 8-bit Tools" +.TH "BLOB2XEX" 1 "2024-05-16" "0.2.1" "Urchlay's Atari 8-bit Tools" .SH NAME blob2xex \- Create Atari 8-bit executables from arbitrary data .\" RST source for blob2xex(1) man page. Convert with: @@ -44,8 +44,12 @@ 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 \fB\-r\fP option. .sp -Each input file \fIrequires\fP a \fB\-l\fP \fIloadaddr\fP option, to set the -load address. Optionally, init addresses can be included, per\-segment +The first input file \fIrequires\fP a \fB\-l\fP \fIloadaddr\fP option, to set the +load address. Further input files can have their load addresses set +with \fB\-l\fP, also. If an input file lacks a load address, it will +load at the next address after the previous file\(aqs ending address. +.sp +Optionally, init addresses can be included, per\-segment (\fB\-i\fP). Also, using \fB\-o\fP and \fB\-s\fP, it\(aqs possible to include only part of the input file. To read from standard input, use \fB\-\fP for the \fIinfile\fP\&. @@ -71,6 +75,11 @@ A space is required between an option and its argument; use e.g. \fB\-l 0x2000\f not \fB\-l0x2000\fP\&. .INDENT 0.0 .TP +.B \-l \fIloadaddr\fP +Required; set the load address of the next \fIinfile\fP\&. The first \fIinfile\fP +\fBmust\fP be preceded by a \fB\-l\fP option; it\(aqs optional for the 2nd and +further files. +.TP .B \-r \fIrunaddr\fP Optional; set the run address. Default is no run address. Since a \&.xex file can only have one run address, there\(aqs no point in giving @@ -78,10 +87,6 @@ multiple \fB\-r\fP options. If you do, the last one will be used. This option should be first on the command line (right after \fIoutfile\fP), or at least must occur before any \fIinfile\fP\&. .TP -.B \-l \fIloadaddr\fP -Required; set the load address of the next \fIinfile\fP\&. Each \fIinfile\fP -\fBmust\fP be preceded by a \fB\-l\fP option. -.TP .B \-i \fIinitaddr\fP Optional; set an init address, to be executed after the next segment loads. Default is no init address. -- cgit v1.2.3