slackbuilds_ponce/games/ovcc/ovcc.6
B. Watson 16cc68401e
games/ovcc: Added (CoCo 3 emulator)
Signed-off-by: bedlam <dave@slackbuilds.org>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
2023-05-27 08:08:48 +07:00

145 lines
4.6 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 "OVCC" 6 "2023-05-23" "1.6.0+20230510_f6c395c" "SlackBuilds.org"
.SH NAME
ovcc \- TRS-80 CoCo 3 emulator
.\" RST source for ovcc(1) man page. Convert with:
.
.\" rst2man.py ovcc.rst > ovcc.6
.
.SH SYNOPSIS
.sp
\fBovcc\fP [\fIquickload\-file\fP]
.SH DESCRIPTION
.sp
\fBovcc\fP is "the portable and open Virtual Color Computer", an emulator
for the TRS\-80 Color Computer 3.
.sp
This man page documents \fBovcc\fP as packaged by SlackBuilds.org.
.sp
[\fIquickload\-file\fP] can be a cartridge ROM image (\fB*.rom\fP or \fB*.ccc\fP)
or a binary executable (\fB*.bin\fP). If the file exists, it will be
loaded into the emulator at startup and executed. The filename
extensions are required, although they are case\-insensitive.
.sp
There are no other command\-line options.
.SH KEYBOARD
.sp
The keyboard is laid out like the CoCo 3, meaning that e.g. the
double\-quote is \fIShift\-2\fP\&.
.sp
While \fBovcc\fP is running, press \fIF12\fP for a list of keyboard commands.
.SH DISK IMAGES
.sp
To use a disk image (\fB*.dsk\fP), first connect the floppy drive:
select \fICartridge\fP \-> \fILoad Cart\fP \-> \fBlibfd502.so\fP\&. After doing
this, the \fICartridge\fP menu will now have entries for 4 drives. Select
\fIFD\-502 Drive 0\fP \-> \fIInsert\fP, then use the file selector to navigate
to the disk image. If necessary, you can choose \fIFile\fP \-> \fIHard Reset\fP
or press \fIF9\fP to reboot the Coco 3.
.sp
Note that it\(aqs easier to move or symlink the disk images into the
\fB~/.ovcc\fP directory, since this is the default location for the file
selector.
.sp
All the inserted media are remembered in the config file, so when
you exit and re\-run \fBovcc\fP, the devices and disks will still be
connected and loaded.
.SH FILES
.INDENT 0.0
.TP
.B /usr/games/ovcc
Shell script wrapper, which sets up the per\-user working directory if
needed, \fBchdir\fPs to it, and executes the real executable.
.TP
.B /usr/libexec/ovcc/ovcc
The actual executable. Normally you don\(aqt want to call this directly.
Since \fBovcc\fP was ported from Windows, it expects to find its config
files, ROMs, and loadable modules in the directory it was launched from.
.TP
.B ~/.ovcc
Per\-user working directory for \fBovcc\fP\&. If this dir doesn\(aqt exist, the
\fBovcc\fP wrapper script will create it. Contents:
.INDENT 7.0
.TP
.B Vcc.ini
The config file. Human\-readable and (if you\(aqre careful), editable. However,
the primary way to change the settings here is to use the graphical user
interface. Any changes made there will be written to this file.
.TP
.B Vcc.ini_bck
Backup of the config file, created whenever \fBovcc\fP is about to overwrite the
config.
.TP
.B lib*.so
Loadable modules which emulate various hardware that can be attached to the
CoCo 3. In the GUI, you load these from the Cartridge menu. The standard
floppy disk module is \fBlibfd502.so\fP\&. These are symlinks to the real files
in the package.
.sp
For a description of each emulated device, see:
.sp
\fI\%https://raw.githubusercontent.com/VCCE/VCC/main/README.md\fP
.TP
.B *.rom
ROM images.
.sp
\fBcoco3.rom\fP is automatically loaded when the emulator starts up.
.sp
\fBdisk11.rom\fP is loaded when the \fBlibfd502.so\fP module is loaded.
.sp
Other modules may require other ROM images (not included in the SBo package).
.UNINDENT
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/ovcc\-1.6.0+20230510_f6c395c/README.md for license information.
.SH AUTHORS
.sp
ovcc was ported from the original VCC by Joseph Forgione.
.sp
VCC was written by the VCC Developement Team.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
The ovcc homepage: \fI\%https://github.com/WallyZambotti/OVCC\fP
.sp
The original (Windows\-only) VCC homepage: \fI\%https://github.com/VCCE/VCC/\fP
.sp
The TRS\-80 Color Computer Archive, which has lots of software for TRS\-80
CoCo machines, including the CoCo 3:
.sp
\fI\%https://colorcomputerarchive.com/\fP
.sp
\fBxroar\fP(6), which can emulate the Color Computer 2.
.\" Generated by docutils manpage writer.
.