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
|
=========
abas2html
=========
--------------------------------------
Create HTML from tokenized Atari BASIC
--------------------------------------
.. include:: manhdr.rst
SYNOPSIS
========
**abas2html** [**-h**] [**-a** *aha-opts*] [**-b** *dialect*] [**-m**] *input-file* [*output-file*]
DESCRIPTION
===========
**abas2html** is a shell script wrapper for **listbas**\(1),
**listamsb**\(1), and **aha**\(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.
*input-file* 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 **-b**, below) or
let it be autodetected (via **whichbas**\(1)).
*output-file* will be an HTML file, created by **aha**\(1). If
no output filename is given, it will be costructed by changing the
filename extension to *.html*, or (if there is no extension) by adding
*.html* to the input filename.
**aha** can be installed from https://github.com/theZiz/aha or from
your distribution's package repository (e.g. **sbopkg -i aha** on Slackware,
**apt install aha** on Debian or Ubuntu).
OPTIONS
=======
-a Next option is passed to **aha**\(1). May be used multiple times.
Examples::
abas2html -a -b -a -n FOO.BAS # black background, no header
abas2html -a"-b -n" FOO.BAS # same thing, quotes required
-b Set BASIC dialect. Default is autodetection. Valid dialects:
**-ba** Atari 8K BASIC
**-ba+** OSS BASIC/A+
**-bm** Atari Microsoft BASIC
**-bt** Turbo BASIC XL
**-bxl** OSS BASIC XL
**-bxe** OSS BASIC XE
**-bic** OSS Integer BASIC (cartridge version)
**-bid** OSS Integer BASIC (disk version)
-m Monochrome: disable color syntax highlighting.
ENVIRONMENT
===========
**PATH**
The various programs executed are searched for in **PATH**. If you don't
have the utilities installed system-wide, you can use something like::
PATH=.:$PATH ./abas2html <...>
**LISTBAS_OPTS**
See **listbas**\(1) for usage. Note that Atari Microsoft BASIC programs
are listed with **listamsb**, which is not affected by this environment
variable.
**COLORIZE_AMSB**
Used by **listamsb**\(1) when listing Atari Microsoft BASIC programs.
EXIT STATUS
===========
0 for success, non-zero for failure.
.. include:: manftr.rst
|
