games/ovcc: Added (CoCo 3 emulator)

Signed-off-by: bedlam <dave@slackbuilds.org>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

1 files changed, 145 insertions, 0 deletions

diff --git a/games/ovcc/ovcc.6 b/games/ovcc/ovcc.6
new file mode 100644
index 0000000000000..24f282aa5a599
--- /dev/null
+++ b/games/ovcc/ovcc.6
@@ -0,0 +1,145 @@
+.\" 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.
+.