1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
.\" 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-18" "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
.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.
.
|
