mirror of
https://github.com/Ponce/slackbuilds
synced 2024-11-16 19:50:19 +01:00
16cc68401e
Signed-off-by: bedlam <dave@slackbuilds.org> Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
145 lines
4.6 KiB
Groff
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.
|
|
.
|