From eb5931167b60e44a8bdbcaf2e4b59e8112ac02b1 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Fri, 26 Apr 2024 14:22:34 -0400 Subject: f2toxex: added (stub). --- f2toxex.rst | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 f2toxex.rst (limited to 'f2toxex.rst') diff --git a/f2toxex.rst b/f2toxex.rst new file mode 100644 index 0000000..85d29a1 --- /dev/null +++ b/f2toxex.rst @@ -0,0 +1,66 @@ +.. RST source for f2toxex(1) man page. Convert with: +.. rst2man.py f2toxex.rst > f2toxex.1 + +======= +f2toxex +======= + +------------------------------------------------------------- +Convert a DASM "-f2" object file to an Atari 8-bit executable +------------------------------------------------------------- + +.. include:: manhdr.rst + +SYNOPSIS +======== + +f2toxex [ [**-h** | **-v** ] | *infile* [*outfile*] ] + +DESCRIPTION +=========== + +**f2toxex** converts an object code file created by the **dasm**\(1) +assembler, using its **-f2** option, to an Atari 8-bit executable +(.xex file). + +*infile* may be **-** to read from standard input. *outfile* may be +**-** to write to standard output. + +If *outfile* is omitted, the output will be written to: + +- If reading from standard input, write to standard output. + +- If reading from a file whose name ends with an extension, replace + the extension with *.xex*. + +- Otherwise, append *.xex* to the input filename. + +NOTES +===== + +The DASM -f2 output format is described in section **3.3.4** of the +DASM manual (**dasm.pdf**). It's reproduced here for reference: + + RAS (Random Access Segment). The output file contains one + or more hunks. Each hunk consists of a 2 byte origin (little- + endian), 2 byte length (little-endian), and that number of data + bytes. The hunks occur in the same order as initialized segments + in the assembly. There are no restrictions to segment ordering + (i.e. reverse indexed ORG statements are allowed). The next hunk + begins after the previous hunk's data, until the end of the file. + +OPTIONS +======= + +-h + Print a short help message and exit. + +-v + Verbose operation. + +EXIT STATUS +=========== + +Exit status is zero for success, non-zero for failure. + +.. include:: manftr.rst -- cgit v1.2.3