f2toxex: added (stub).

1 files changed, 66 insertions, 0 deletions

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