diff options
Diffstat (limited to 'abas2html.1')
| -rw-r--r-- | abas2html.1 | 168 |
1 files changed, 168 insertions, 0 deletions
diff --git a/abas2html.1 b/abas2html.1 new file mode 100644 index 0000000..65deaaf --- /dev/null +++ b/abas2html.1 @@ -0,0 +1,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. +. |