slackbuilds/system/cbmbasic/cbmbasic.1

95 lines
2.7 KiB
Groff

.\" 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 "CBMBASIC" 1 "2022-12-27" "1.0+20221218_352a313" "SlackBuilds.org"
.SH NAME
cbmbasic \- port of Commodore 64 BASIC to modern systems
.\" RST source for cbmbasic(1) man page. Convert with:
.
.\" rst2man.py cbmbasic.rst > cbmbasic.1
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
\fBcbmbasic\fP
.sp
\fBcbmbasic\fP \fIprogram.bas\fP
.SH DESCRIPTION
.sp
\fBcbmbasic\fP is a 100% compatible version of Commodore\(aqs version of
Microsoft BASIC 6502 as found on the Commodore 64. You can use it in
interactive mode or pass a BASIC file as a command line parameter.
.sp
\fBcbmbasic\fP does not emulate 6502 code; all code is completely native. On a 1 GHz CPU you get about 1000x speed compared to a 1 MHz 6502.
.sp
There are no command\-line options.
.SH USAGE
.sp
You can use \fBcbmbasic\fP in interactive mode by just running the binary
without parameters, or you can specify an ASCII\-encoded BASIC program
on the command line. You can also use \fBcbmbasic\fP as a UNIX scripting
language by adding a hashbang line to your BASIC program and making
it executable:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ ls \-l hello.bas
\-rwxr\-xr\-x 1 mist staff 40 7 Apr 21:30 hello.bas
$ cat hello.bas
#!/usr/bin/env cbmbasic
PRINT"HELLO WORLD!"
$ ./hello.bas
HELLO WORLD!
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\fBcbmbasic\fP implements a small plugin system that lets developers add
additional statements, functions etc. Right now, you can turn this on
with \fBSYS 1\fP (turn off with \fBSYS 0\fP) and use the new statements
LOCATE \fIy\fP, \fIx\fP (set cursor position), SYSTEM \fIstring\fP (run shell
command) and the extended WAIT \fIport\fP, \fImask\fP, which implements the
Bill Gates easter egg.
.SH AUTHORS
.sp
\fBcbmbasic\fP was ported by Michael Steil and James Abbatiello. The
original 6502 version was written by Microsoft.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
The cbmbasic homepage: \fI\%https://github.com/mist64/cbmbasic\fP
.\" Generated by docutils manpage writer.
.