diff options
Diffstat (limited to 'games/ovcc/ovcc.6')
| -rw-r--r-- | games/ovcc/ovcc.6 | 145 |
1 files changed, 145 insertions, 0 deletions
diff --git a/games/ovcc/ovcc.6 b/games/ovcc/ovcc.6 new file mode 100644 index 0000000000..24f282aa5a --- /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. +. |