diff options
Diffstat (limited to 'xex1to2.1')
| -rw-r--r-- | xex1to2.1 | 97 |
1 files changed, 97 insertions, 0 deletions
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. +. |