aboutsummaryrefslogtreecommitdiff
path: root/xex1to2.rst
diff options
context:
space:
mode:
Diffstat (limited to 'xex1to2.rst')
-rw-r--r--xex1to2.rst48
1 files changed, 48 insertions, 0 deletions
diff --git a/xex1to2.rst b/xex1to2.rst
new file mode 100644
index 0000000..44464f8
--- /dev/null
+++ b/xex1to2.rst
@@ -0,0 +1,48 @@
+.. RST source for xex1to2(1) man page. Convert with:
+.. rst2man.py xex1to2.rst > xex1to2.1
+
+=======
+xex1to2
+=======
+
+------------------------------------------------------------------
+Convert an Atari DOS 1.0 executable to a standard Atari executable
+------------------------------------------------------------------
+
+.. include:: manhdr.rst
+
+SYNOPSIS
+========
+
+xex1to2 [*infile*] [*outfile*]
+
+DESCRIPTION
+===========
+
+**xex1to2** reads a binary load file created by Atari DOS 1.0 and
+converts it to a standard Atari executable, as used by Atari DOS 2.0S
+and all other Atari DOSes.
+
+DOS 1.0's executable format is segmented, like the XEX format,
+but the signature bytes are **$84**, **$09** rather than **$FF**,
+**$FF**. Also, the signature bytes can *only* occur for the first
+segment (the start of the file). Further segments just have a 4-byte
+header with the start and end addresses.
+
+All this utility really does is copy *infile* to *outfile*, replacing
+the first two bytes (which must be **$84**, **$09**) with **$FF**,
+**$FF**.
+
+If *outfile* is omitted, output is written to **stdout**. If *infile*
+is also omitted, input is read from **stdin**. **xex1to2** will not
+write to **stdout** if it's a terminal.
+
+To convert the other way, from a DOS 2.0 compatible XEX file to a DOS
+1.0 executable, use **xexcat -1**.
+
+EXIT STATUS
+===========
+
+Exit status is zero for success, non-zero for failure.
+
+.. include:: manftr.rst