diff options
Diffstat (limited to 'system/cbmbasic/cbmbasic.1')
-rw-r--r-- | system/cbmbasic/cbmbasic.1 | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/system/cbmbasic/cbmbasic.1 b/system/cbmbasic/cbmbasic.1 new file mode 100644 index 000000000000..2f4273baac87 --- /dev/null +++ b/system/cbmbasic/cbmbasic.1 @@ -0,0 +1,94 @@ +.\" 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. +. |