.\" 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 "ABAS2HTML" 1 "2025-03-26" "0.2.2" "Urchlay's Atari 8-bit Tools"
.SH NAME
abas2html \- Create HTML from tokenized Atari BASIC
.SH SYNOPSIS
.sp
\fBabas2html\fP [\fB\-h\fP] [\fB\-a\fP \fIaha\-opts\fP] [\fB\-b\fP \fIdialect\fP] [\fB\-m\fP] \fIinput\-file\fP [\fIoutput\-file\fP]
.SH DESCRIPTION
.sp
\fBabas2html\fP is a shell script wrapper for \fBlistbas\fP(1),
\fBlistamsb\fP(1), and \fBaha\fP(1). It creates an HTML file of the
program listing, with color syntax highlighting by default. ATASCII
characters are converted to Unicode equivalents, and inverse video is
displayed correctly.
.sp
\fIinput\-file\fP must be a tokenized BASIC program, either Atari 8K BASIC,
OSS BASIC/A+, Atari Microsoft BASIC, Turbo BASIC XL, OSS BASIC XL, or
OSS BASIC XE. You can specify the BASIC dialect (see \fB\-b\fP, below) or
let it be autodetected (via \fBwhichbas\fP(1)).
.sp
\fIoutput\-file\fP will be an HTML file, created by \fBaha\fP(1). If
no output filename is given, it will be costructed by changing the
filename extension to \fI\&.html\fP, or (if there is no extension) by adding
\fI\&.html\fP to the input filename.
.sp
\fBaha\fP can be installed from \fI\%https://github.com/theZiz/aha\fP or from
your distribution\(aqs package repository (e.g. \fBsbopkg \-i aha\fP on Slackware,
\fBapt install aha\fP on Debian or Ubuntu).
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-a
Next option is passed to \fBaha\fP(1). May be used multiple times.
Examples:
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
abas2html \-a \-b \-a \-n FOO.BAS    # black background, no header
abas2html \-a"\-b \-n" FOO.BAS      # same thing, quotes required
.ft P
.fi
.UNINDENT
.UNINDENT
.TP
.B  \-b
Set BASIC dialect. Default is autodetection. Valid dialects:
.sp
\fB\-ba\fP   Atari 8K BASIC
.sp
\fB\-ba+\fP  OSS BASIC/A+
.sp
\fB\-bm\fP   Atari Microsoft BASIC
.sp
\fB\-bt\fP   Turbo BASIC XL
.sp
\fB\-bxl\fP  OSS BASIC XL
.sp
\fB\-bxe\fP  OSS BASIC XE
.sp
\fB\-bic\fP  OSS Integer BASIC (cartridge version)
.sp
\fB\-bid\fP  OSS Integer BASIC (disk version)
.TP
.B  \-m
Monochrome: disable color syntax highlighting.
.UNINDENT
.SH ENVIRONMENT
.INDENT 0.0
.TP
.B \fBPATH\fP
The various programs executed are searched for in \fBPATH\fP\&. If you don\(aqt
have the utilities installed system\-wide, you can use something like:
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
PATH=.:$PATH ./abas2html <...>
.ft P
.fi
.UNINDENT
.UNINDENT
.TP
.B \fBLISTBAS_OPTS\fP
See \fBlistbas\fP(1) for usage. Note that Atari Microsoft BASIC programs
are listed with \fBlistamsb\fP, which is not affected by this environment
variable.
.TP
.B \fBA8CAT\fP, \fBCOLORIZE_AMSB\fP
Used by \fBlistamsb\fP(1) when listing Atari Microsoft BASIC programs.
.UNINDENT
.SH EXIT STATUS
.sp
0 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
\fBa8cat\fP(1),
\fBa8eol\fP(1),
\fBa8xd\fP(1),
\fBatr2xfd\fP(1),
\fBatrsize\fP(1),
\fBaxe\fP(1),
\fBbas2aplus\fP(1),
\fBblob2c\fP(1),
\fBblob2xex\fP(1),
\fBcart2xex\fP(1),
\fBcxrefbas\fP(1),
\fBdasm2atasm\fP(1),
\fBdiffbas\fP(1),
\fBdumpbas\fP(1),
\fBf2toxex\fP(1),
\fBfenders\fP(1),
\fBlistbas\fP(1),
\fBlistamsb\fP(1),
\fBprotbas\fP(1),
\fBrenumbas\fP(1),
\fBrom2cart\fP(1),
\fBunmac65\fP(1),
\fBunprotbas\fP(1),
\fBvxrefbas\fP(1),
\fBwhichbas\fP(1),
\fBxex1to2\fP(1),
\fBxexamine\fP(1),
\fBxexcat\fP(1),
\fBxexsplit\fP(1),
\fBxfd2atr\fP(1),
\fBxex\fP(5),
\fBatascii\fP(7),
\fBfauxtari\fP(7).
.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.
.