aboutsummaryrefslogtreecommitdiff
path: root/bas2aplus.1
diff options
context:
space:
mode:
Diffstat (limited to 'bas2aplus.1')
-rw-r--r--bas2aplus.125
1 files changed, 19 insertions, 6 deletions
diff --git a/bas2aplus.1 b/bas2aplus.1
index d263293..bdb1dd3 100644
--- a/bas2aplus.1
+++ b/bas2aplus.1
@@ -29,17 +29,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
..
.TH "BAS2APLUS" 1 "2024-07-21" "0.2.1" "Urchlay's Atari 8-bit Tools"
.SH NAME
-bas2aplus \- Convert Atari BASIC (and some BASIC XL) programs to BASIC/A+
+bas2aplus \- Convert Atari BASIC (and some BASIC XL/XE) programs to BASIC/A+
.SH SYNOPSIS
.sp
bas2aplus \fIinput\-file\fP \fIoutput\-file\fP
.SH DESCRIPTION
.sp
-\fBbas2aplus\fP reads an Atari BASIC or BASIC XL tokenized (SAVEd) program
+\fBbas2aplus\fP reads an Atari BASIC or BASIC XL/XE tokenized (SAVEd) program
and converts it to BASIC/A+.
.sp
All Atari BASIC programs can be successfully converted. Some BASIC
-XL operators have no equivalent in BASIC/A+, so programs using these
+XL/XE tokens have no equivalent in BASIC/A+, so programs using these
can\(aqt be converted (you will see messages on standard error, in that
case).
.SH OPTIONS
@@ -81,8 +81,8 @@ same developers. The token lists were rearranged so that it\(aqs
token\-compatible with Atari BASIC, and includes all the extra
commands/functions/etc from BASIC/A+... with different token numbers.
.sp
-BASIC XL has keywords and operators that don\(aqt exist in BASIC/A+. These
-are:
+BASIC XL has keywords and operators that don\(aqt exist in BASIC/A+,
+which can\(aqt be translated by \fBbas2aplus\fP\&. These are:
.INDENT 0.0
.TP
.B \fBNUM\fP
@@ -116,9 +116,22 @@ Also, BASIC XL supports hex constants, with a leading \fB$\fP\&. A+
doesn\(aqt support these, so they get converted to the equivalent decimal
constant. This is basically a cosmetic change; \fBA=$0600\fP assigns the
same value as \fBA=1536\fP\&.
+.SH BASIC XE
+.sp
+BASIC XE is the last in the series of OSS BASIC interpreters. It adds
+a few keywords to BASIC XL, which also don\(aqt exist in A+. These are:
+.INDENT 0.0
+.TP
+.B \fBEXTEND\fP
+This command is direct\-mode only, so it will never appear in a SAVEd
+program anyway.
+.TP
+.B \fBHITCLR\fP, \fBINVERSE\fP, \fBNORMAL\fP, \fBBLOAD\fP, \fBBSAVE\fP
+Not supported in either A+ or XL.
+.UNINDENT
.SH EXIT STATUS
.sp
-0 for success, non\-zero for failuse.
+0 for success, non\-zero for failure.
.SH COPYRIGHT
.sp
WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.