From 4449304aeed23df6b742d988d68f95c7a1b18867 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Mon, 29 Apr 2024 19:51:33 -0400
Subject: xex1to2: added.

---
 xex1to2.1 | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 xex1to2.1

(limited to 'xex1to2.1')

diff --git a/xex1to2.1 b/xex1to2.1
new file mode 100644
index 0000000..96b2c37
--- /dev/null
+++ b/xex1to2.1
@@ -0,0 +1,97 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "XEX1TO2" 1 "2024-04-29" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.SH NAME
+xex1to2 \- Convert an Atari DOS 1.0 executable to a standard Atari executable
+.\" RST source for xex1to2(1) man page. Convert with:
+.
+.\" rst2man.py xex1to2.rst > xex1to2.1
+.
+.SH SYNOPSIS
+.sp
+xex1to2 [\fIinfile\fP] [\fIoutfile\fP]
+.SH DESCRIPTION
+.sp
+\fBxex1to2\fP 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.
+.sp
+DOS 1.0\(aqs executable format is segmented, like the XEX format,
+but the signature bytes are \fB$84\fP, \fB$09\fP rather than \fB$FF\fP,
+\fB$FF\fP\&. Also, the signature bytes can \fIonly\fP occur for the first
+segment (the start of the file). Further segments just have a 4\-byte
+header with the start and end addresses.
+.sp
+All this utility really does is copy \fIinfile\fP to \fIoutfile\fP, replacing
+the first two bytes (which must be \fB$84\fP, \fB$09\fP) with \fB$FF\fP,
+\fB$FF\fP\&.
+.sp
+If \fIoutfile\fP is omitted, output is written to \fBstdout\fP\&. If \fIinfile\fP
+is also omitted, input is read from \fBstdin\fP\&. \fBxex1to2\fP will not
+write to \fBstdout\fP if it\(aqs a terminal.
+.sp
+To convert the other way, from a DOS 2.0 compatible XEX file to a DOS
+1.0 executable, use \fBxexcat \-1\fP\&.
+.SH EXIT STATUS
+.sp
+Exit status is zero for success, non\-zero for failure.
+.SH COPYRIGHT
+.sp
+WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
+.SH AUTHOR
+.INDENT 0.0
+.IP B. 3
+Watson <\fI\%urchlay@slackware.uk\fP>; Urchlay on irc.libera.chat \fI##atari\fP\&.
+.UNINDENT
+.SH SEE ALSO
+.sp
+\fBa8eol\fP(1),
+\fBa8utf8\fP(1),
+\fBatr2xfd\fP(1),
+\fBatrsize\fP(1),
+\fBaxe\fP(1),
+\fBblob2c\fP(1),
+\fBblob2xex\fP(1),
+\fBcart2xex\fP(1),
+\fBdasm2atasm\fP(1),
+\fBf2toxex\fP(1),
+\fBfenders\fP(1),
+\fBrom2cart\fP(1),
+\fBunmac65\fP(1),
+\fBxexamine\fP(1),
+\fBxexcat\fP(1),
+\fBxexsplit\fP(1),
+\fBxfd2atr\fP(1),
+\fBxex\fP(5).
+.sp
+Any good Atari 8\-bit book: \fIDe Re Atari\fP, \fIThe Atari BASIC  Reference
+Manual\fP,  the  \fIOS Users\(aq Guide\fP, \fIMapping the Atari\fP, etc.
+.\" Generated by docutils manpage writer.
+.
-- 
cgit v1.2.3