summaryrefslogtreecommitdiffstats
path: root/system/vice/man
diff options
context:
space:
mode:
Diffstat (limited to 'system/vice/man')
-rw-r--r--system/vice/man/c1541.1162
-rw-r--r--system/vice/man/cartconv.1247
-rw-r--r--system/vice/man/petcat.1219
-rw-r--r--system/vice/man/vice.1183
-rw-r--r--system/vice/man/vsid.124
5 files changed, 835 insertions, 0 deletions
diff --git a/system/vice/man/c1541.1 b/system/vice/man/c1541.1
new file mode 100644
index 0000000000..5182a99e46
--- /dev/null
+++ b/system/vice/man/c1541.1
@@ -0,0 +1,162 @@
+.TH C1541 1 "May 2018" "VICE"
+.SH NAME
+c1541 \- a stand alone disk image maintenance program
+.SH SYNOPSIS
+.IR c1541
+[options] [image]
+.SH DESCRIPTION
+.IR c1541
+is a stand alone program that can be used for D64, D71, D81, X64 and G64
+disk image file maintenance. It is part of the
+.IR VICE
+emulator.
+.P
+.IR c1541
+can be used both in interactive and batch mode. It will start in interactive
+mode if no images and no options are specified or if one image is specified;
+when started in interactive mode, command line editing and command history
+are available.
+.P
+Each command line option for use in batch mode has an interactive mode
+counterpart, that is shown in parenthesis.
+.TP 8
+.B \-@ \fIcommand\fR
+execute CBM DOS command
+.TP
+.B \-attach \fIimage\fR (attach \fIimage\fR)
+attach \fIimage\fR for use. All consequent commands in interactive mode will
+refer to this image.
+.TP
+.B \-bam [\fIunit\fR] | \fItrack-min\fR \fItrack_max\fR [\fIunit\fR] (bam [\fIunit\fR] | \fItrack-min\fR \fItrack_max\fR [\fIunit\fR])
+show bam bitmap of an imagem optionally specifying unit and/or a slice of the tracks using \fItrack-min\fR and \fItrack-max\fR.
+.TP
+.B \-bcopy \fIsrc_trk\fR \fIsrc_sec\fR \fIdst_trk\fR \fIdst_sec\fR [\fIsrc_unit\fR [\fIdst_unit\fR]] (bcopy \fIsrc_trk\fR \fIsrc_sec\fR \fIdst_trk\fR \fIdst_sec\fR [\fIsrc_unit\fR [\fIdst_unit\fR]])
+copy a block to another block. When not using the optional unit numbers, the block is copied among the current unit. If one unit (\fIsrc_unit\fR) is specified that unit is used for both source and destination. Using both unit number allows copying blocks between different units.
+.TP
+.B \-bfill \fItrack\fR \fIsector\fR \fIvalue\fR \fI[unit]\fR (bfill \fItrack\fR \fIsector\fR \fIvalue\fR \fI[unit]\fR)
+fill a block with a single value.
+.TP
+.B \-block \fItrack\fR \fIsector\fR \fI[offset]\fR \fI[unit]\fR (block \fItrack\fR \fIsector\fR \fI[offset]\fR \fI[unit]\fR)
+show disk blocks in hex format.
+.TP
+.B \-bpoke [\fI[@unit:]\fR \fItrack\fR \fIsector\fR \fIoffset\fR \fIdata\fR (bpoke [\fI[@unit:]\fR \fItrack\fR \fIsector\fR \fIoffset\fR \fIdata\fR)
+poke data into a block. The \fIdata\fR list should be at least a single byte. Multiple prefixes for the data are supported: 0x/$ for hex, 0b/% for binary, & for octal and unadorned for plain decimal.
+.TP
+.B \-bread \fIfilename\fR \fItrack\fR \fIsector\fR [\fIunit\fR] (bread \fIfilename\fR \fItrack\fR \fIsector\fR [\fIunit\fR])
+read a block from the disk image at (\fItrack\fR,\fIsector\fR) and write it to the host file system as \fIfilename\fR.
+.TP
+.B \-bwrite \fIfilename\fR \fItrack\fR \fIsector\fR [\fIunit\fR] (bwrite \fIfilename\fR \fItrack\fR \fIsector\fR [\fIunit\fR])
+write a block from \fIfilename\fR on the host file system to a disk image at (\fItrack\fR,\fIsector\fR).
+.TP
+.B \-chain \fItrack\fR \fIsector\fR \fi[unit]\fR (chain \fItrack\fR \fIsector\fR \fI[unit]\fR)
+show block chain starting at (\fItrack\fR,\fIsector\fR). The last number shown is the number of bytes in the final block.
+.TP
+.B \-copy \fIimage\fR \fIoldname1\fR \fI[oldname2...]\fR \fInewname\fR (copy \fIoldname1\fR \fI[oldname2...]\fR \fInewname\fR)
+concatenate \fIoldname1\fR, \fIoldname2\fR... into \fInewname\fR on \fIimage\fR
+(can be used to copy files).
+.TP
+.B \-delete \fIimage\fR \fIfiles...\fR (delete \fIfiles...\fR)
+delete \fIfiles\fR from \fIimage\fR
+.TP
+.B \-dir \fI[pattern]\fR (dir \fI[pattern]\fR)
+list directory. See the \fBlist\fR command for details.
+.TP
+.B \-extract \fIimage\fR (extract \fIimage\fR)
+extract all files from \fIimage\fR.
+.TP
+.B \-format \fIimage\fR (format \fIimage\fR '\fIname,id\fR')
+format the disk image \fIimage\fR with the specified label. \fIimage\fR is
+created if it does not exist.
+.TP
+.B \-geosextract \fIsource\fR (geosextract \fIsource\fR)
+extract all the files to the file system and GEOS Convert them.
+.TP
+.B \-geosread \fIsource\fR \fI[destination]\fR (geosread \fIsource\fR \fI[destination]\fR)
+read GEOS \fIsource\fR from the disk image and copy it as a Convert file into
+\fIdestination\fR in the file system. If \fIdestination\fR is not specified,
+copy it into a file with the same name as \fIsource\fR.
+Please note that since GEOS files are stored in ASCII, violating CBMDOS
+conventions, the filename should be given in inverted case.
+.TP
+.B \-geoswrite \fIsource\fR (geoswrite \fIsource\fR)
+write GEOS Convert file \fIsource\fR from the file system on a disk image.
+.TP
+.B \-help \fI[command]\fR (help)
+show help on all commands or more detailed help on a specific \fIcommand\fR
+.TP
+.B \-info \fIimage\fR \fI[unit]\fR (info \fI[unit]\fR)
+show information about image (format, geometry, error-block, write-protect)
+.TP
+.B \-list \fI[pattern]\fR (list)
+list directory. The optional \fIpattern\fR accepts the usual
+CBM DOS wildcards (\fB*\fR and \fB?\fR) and also supports file type selection
+with '=X', where \fBX\fR is one of \fBS\fR, \fBP\fR, \fBU\fR or \fBR\fR.
+Multiple sub patterns can be specified by using comma's.
+.TP
+.B \-name \fIdiskname[,id]\fR \fI[unit]\fR (name \fIdiskname[,id]\fR \fI[unit]\fR)
+set diskname and optionally id.
+.TP
+.B \-p00save \fIenable\fR \fI[unit]\fR (p00save \fIenable\fR \fI[unit\fR)
+save P00 files to the file system.
+.TP
+.B \-read \fIimage\fR \fI1541name\fR \fI[fsname]\fR (read \fI1541name\fR \fI[fsname]\fR)
+extract \fI1541name\fR from the disk image into \fIfsname\fR (\fI1541name\fR
+by default) from \fIimage\fR.
+.TP
+.B \-rename \fIoldname\fR \fInewname\fR (rename \fIoldname\fR \fInewname\fR)
+rename files. The files must be on the same drive.
+.TP
+.B \-show \fI'copying'\fR|\fI'warranty'\fR (show \fI'copying'\fR|\fI'warranty'\fR)
+show license or warranty information.
+.TP
+.B \-tape \fIimage\fR \fItapeimage\fR \fI[files...]\fR (tape \fIimage\fR \fItapeimage\fR \fI[files...]\fR)
+transfer \fIfiles\fR from \fItapeimage\fR to \fIimage\fR (default is all files).
+.TP
+.B \-unlynx \fIarchive\fR \fI[unit]\fR (unlynx \fIarchive\fR \fI[unit]\fR)
+dissolve Lynx \fIarchive\fR.
+.TP
+.B \-validate \fIimage\fR (validate)
+validate \fImage\fR.
+.TP
+.B \-verbose \fR[off] (verbose [off])
+set verbose mode. Output extra logging information, disable with \fBverbose off\fR.
+.TP
+.B \-write \fIimage\fR \fIfsname\fR \fI[1541name]\fR (write \fIfsname\fR \fI[1541name]\fR)
+write \fIfsname\fR to \fIimage\fR as \fI1541name\fR (\fIfsname\fR by default).
+(works with \fIP00\fR files as well).
+.TP
+.B \-zcreate \fIx64name\fR \fIzipname\fR [\fIlabel,id\fR] (zcreate \fIx64name\fR \fIzipname\fR [\fIlabel,id\fR]
+create an X64 disk image from four Zipcoded files named \fI1!zipname\fR through
+\fI4!zipname\fR.
+.P
+When more than one command is specified in batch mode, all of them are
+executed in the same order they have on the command line.
+.P
+If you use
+.B \-
+as a file name, it stands for \fIstdin\fR or \fIstdout\fR.
+.P
+Exit interactive mode with either \fBexit\fR or \fBquit\fR.
+.SH SEE ALSO
+.BR vice(1),
+.BR cartconv(1),
+.BR petcat(1)
+.P
+@HTMLDOC@
+.SH AUTHORS
+Teemu Rantanen <tvr@cs.hut.fi>
+.br
+Ettore Perazzoli <ettore@comm2000.it>
+.br
+Andreas Boose <boose@linux.rz.fh-hannover.de>
+.br
+Jouko Valta <jopi@stekt.oulu.fi>
+.P
+with improvements by
+.P
+.br
+Olaf Seibert <rhialto@mbfys.kun.nl>
+.br
+Gerhard Wesp <gwesp@cosy.sbg.ac.at>
+.br
+Bas Wassink <b.wassink@ziggo.nl>
diff --git a/system/vice/man/cartconv.1 b/system/vice/man/cartconv.1
new file mode 100644
index 0000000000..4bf0a7dae8
--- /dev/null
+++ b/system/vice/man/cartconv.1
@@ -0,0 +1,247 @@
+.TH CARTCONV 1 "March 2017" "VICE"
+.SH NAME
+cartconv \- a stand alone cartridge conversion program
+.SH SYNOPSIS
+.IR cartconv
+[options]
+.SH DESCRIPTION
+.IR cartconv
+is a cartridge conversion utility, it can convert between binary and .crt
+images and it can 'insert' binary and/or .crt images into the EPROM type of
+cartridges. It is part of the
+.IR VICE
+emulator.
+.TP 8
+.B \-i \fIinput name\fR
+This parameter is mandatory, it should contain the name of the binary/.crt
+file you want to convert. For the EPROM type of cartridges this parameter
+can be used multiple times to insert images into the resulting file.
+.TP
+.B \-o \fIoutput name\fR
+This parameter is mandatory, it should contain the name of the binary/.crt
+file you want to convert the input file to.
+.TP
+.B \-t \fIcarttype\fR
+This parameter is optional. It is only needed when converting to a .crt
+file. See below for the supported cartridge types.
+.TP
+.B \-n \fIcart name\fR
+This parameter is optional and is used as the cartridge name when creating
+a .crt file.
+.TP
+.B \-l \fIloadaddress\fR
+This parameter is optional and is used as the load-address when converting
+a .crt file to a .prg file, or when converting to a generic type .crt file.
+.TP
+.B \-f \fIinput name\fR
+This parameter is optional, and is meant to output information about the
+named file. It can't be used in conjuction with any of the other parameters.
+.TP
+.B \-r
+This parameter is optional, it enables repair mode (accept broken input files)
+.TP
+.B \-q
+This parameter is optional, it disables all non-error messages
+.P
+
+The following cartridge types are supported:
+
+.TP
+.B bin
+Binary .bin file (Default crt->bin)
+.TP
+.B normal
+Generic 8kB/12kB/16kB .crt file (Default bin->crt)
+.TP
+.B prg
+Binary C64 .prg file with load-address
+.TP
+.B ulti
+Ultimax mode 4kB/8kB/16kB .crt file
+.TP
+.B ap
+Atomic Power .crt file
+.TP
+.B ar2
+Action Replay MK2 .crt file
+.TP
+.B ar3
+Action Replay MK3 .crt file
+.TP
+.B ar4
+Action Replay MK4 .crt file
+.TP
+.B ar5
+Action Replay V5 .crt file
+.TP
+.B cap
+Capture .crt file
+.TP
+.B comal
+Comal 80 .crt file
+.TP
+.B dep256
+Dela EP256 .crt file, extra files can be inserted
+.TP
+.B dep64
+Dela EP64 .crt file, extra files can be inserted
+.TP
+.B dep7x8
+Dela EP7x8 .crt file, extra files can be inserted
+.TP
+.B din
+Dinamic .crt file
+.TP
+.B dsm
+Diashow-Maker .crt file
+.TP
+.B easy
+EasyFlash .crt file
+.TP
+.B ecr
+Easy Calc Result .crt file
+.TP
+.B epyx
+Epyx FastLoad .crt file
+.TP
+.B exos
+EXOS .crt file
+.TP
+.B expert
+Expert Cartridge .crt file
+.TP
+.B f64
+Formel 64 .crt file
+.TP
+.B fc1
+The Final Cartridge .crt file
+.TP
+.B fc3
+The Final Cartridge III .crt file
+.TP
+.B fcp
+Final Cartridge Plus .crt file
+.TP
+.B ff
+Freeze Frame .crt file
+.TP
+.B fm
+Freeze Machine .crt file
+.TP
+.B fp
+Fun Play .crt file
+.TP
+.B gk
+Game Killer .crt file
+.TP
+.B gmod2
+GMod2 .crt file
+.TP
+.B gs
+C64 Games System .crt file
+.TP
+.B ide64
+IDE64 .crt file
+.TP
+.B ieee
+IEEE-488 Interface .crt file
+.TP
+.B kcs
+KCS Power Cartridge .crt file
+.TP
+.B ks
+Kingsoft .crt file
+.TP
+.B mach5
+MACH 5 .crt file
+.TP
+.B md
+Magic Desk .crt file
+.TP
+.B mf
+Magic Formel .crt file
+.TP
+.B mikro
+Mikro Assembler .crt file
+.TP
+.B mmc64
+MMC64 .crt file
+.TP
+.B mmcr
+MMC Replay .crt file
+.TP
+.B mv
+Magic Voice .crt file
+.TP
+.B ocean
+Ocean .crt file
+.TP
+.B p64
+Prophet64 .crt file
+.TP
+.B pf
+Pagefox .crt file
+.TP
+.B rep256
+REX 256k EPROM Cart .crt file, extra files can be inserted
+.TP
+.B rgcd
+RGCD .crt file
+.TP
+.B ross
+ROSS .crt file
+.TP
+.B rr
+Retro Replay .crt file
+.TP
+.B rrnet
+RR-Net MK3 .crt file
+.TP
+.B ru
+REX Utility .crt file
+.TP
+.B s64
+Snapshot 64 .crt file
+.TP
+.B sb
+Structured BASIC .crt file
+.TP
+.B se5
+Super Explode V5.0 .crt file
+.TP
+.B sg
+Super Games .crt file
+.TP
+.B silver
+Silverrock 128K Cartridge .crt file
+.TP
+.B simon
+Simons' BASIC .crt file
+.TP
+.B ss4
+Super Snapshot V4 .crt file
+.TP
+.B ss5
+Super Snapshot V5 .crt file
+.TP
+.B star
+Stardos .crt file
+.TP
+.B wl
+Westermann Learning .crt file
+.TP
+.B ws
+Warp Speed .crt file
+.TP
+.B zaxxon
+Zaxxon .crt file
+@end table
+
+.SH SEE ALSO
+.BR vice(1),
+.BR c1541(1),
+.BR petcat(1)
+.P
+@HTMLDOC@
+.SH AUTHORS
+Marco van den Heuvel <blackystardust68@yahoo.com>
diff --git a/system/vice/man/petcat.1 b/system/vice/man/petcat.1
new file mode 100644
index 0000000000..e49cc3afc5
--- /dev/null
+++ b/system/vice/man/petcat.1
@@ -0,0 +1,219 @@
+.TH PETCAT 1 "March 2017" "VICE" "C64 Program Development"
+.nr X
+.SH NAME
+petcat \- convert and display PETSCII or BASIC files
+.SH SYNOPSIS
+.IR petcat
+[
+.B \-text
+|
+\-<\fIversion\fR>
+|
+.B \-w<\fIversion\fR>
+|
+.B \-k<\fIversion\fR>
+] [
+.B \-l \fIhexaddr\fR
+] [
+.B \-c
+|
+.B \-nc
+] [
+.B \-o \fIoutfile\fR
+] [
+.B \-skip \fIoffset\fR
+] [
+\--
+] [
+.B file list
+]
+.SH DESCRIPTION
+.IR petcat
+converts input files from the most common CBM file formats into
+printable ASCII form and writes to standard output. The type
+of input file is determined automatically, if possible, and
+appropriate conversion is performed.
+Since a few of the BASIC versions have keywords defined differently,
+the right conversion has to be selected on the command line.
+Where such confusion cannot happen, automatical recognition of input
+is used. This is useful when expanding several files at once or if
+the program contains code for several versions, selected according to
+the hardware; eg. Simons' Basic vs. Basic 7.0.
+.br
+Please note that each input file is converted individually,
+but the output is produced as continuous flow. Also, all input
+files that are read trough a pipe, are concatenated before they
+reach
+.IR petcat
+so any machine language section in between the BASIC programs causes
+all consecutive files to be taken as one machine language program.
+For that reason files containing machine language parts attached to
+them must be input separately, otherwise the remaining files won't
+be expanded.
+.IR petcat
+recognizes normal PETSCII text files (SEQ), program files containing
+directory listing, and BASIC programs. Both the original CBM files and
+files with a PC64 `P00' header are accepted. The different BASIC versions
+are not automatically distinguished, but standard C64 and C128 versions
+are used as default.
+.br
+In order to tokenize a text file into a BASIC binary file the desired
+BASIC version must be exclusively specified so that correct set of
+keywords will be used.
+If line numbers are not found in the beginning of each program line,
+the cruncher creates the missing line numbers by adding 2 to the numeric
+value of previous one.
+Since also line numbers deviating from strictly ascendind order are
+accepted, care must be taken when editing such a program on a C64 again.
+.SS Clarification
+.LP
+Since CBM programs usually contain unprintable characters, a way to
+specify them has been created.
+Normally,
+.IR petcat
+uses the same codes as most printers, but for tokenizing programs
+scanned from magazines, it can use the following convention:
+.br
+.TP 12
+.BR "{DOWN}"
+stands for single control code
+.TP
+.BR "{6 RIGHT}"
+contains amout of consecutive codes
+.TP
+List of valid mnemonics:
+.br
+{wht} {dish} {ensh} {swlc} {down} {rvon} {home} {del} {esc} {red}
+{rght} {grn} {blu} {orng} {F1} {F3} {F5} {F7} {F2} {F4} {F6} {F8}
+{sret} {swuc} {blk} {up} {rvof} {clr} {inst} {brn} {lred} {gry1}
+{gry2} {lgrn} {lblu} {gry3} {pur} {left} {yel} {cyn}
+.TP
+List of alternate mnemonics:
+.br
+{wht} {up/lo lock on} {up/lo lock off} {return} {lower case} {down}
+{rvs on} {home} {delete} {esc} {red} {right} {grn} {blu} {orange}
+{f1} {f3} {f5} {f7} {f2} {f4} {f6} {f8} {shift return} {upper case}
+{blk} {up} {rvs off} {clr} {insert} {brown} {lt red} {grey1} {grey2}
+{lt green} {lt blue} {grey3} {pur} {left} {yel} {cyn}
+.SH OPTIONS
+.TP 8
+.B \-l \fIload_address\fR
+Specify \fIload_address\fR (in hex) for tokenized program.
+.TP
+.B \-c
+Causes
+.IR petcat
+to interpret also control characters.
+By default, these strings are the same as used by printers. However,
+an alternate set is attempted whenever none within the primary set
+matches. Default is ON, unless text mode is selected.
+.TP
+.B \-nc
+Suppress control codes.
+.TP
+.B \-f
+Force overwrite of existing output file. Default true.
+.TP
+.B \-h
+Print filename and start address for each Basic file expanded. Default true.
+.TP
+.B \-nh
+Suppress file header in printout.
+.TP
+.B \-o \fIfile\fR
+Redirect output to the specified \fIfile\fR. This option overrules -h.
+When \fIfile\fP has extension `.P00' and also -w option is specified, the PC64
+file header is written automatically. .P00 file cannot be written on stdout
+but to a file only.
+.TP
+.B \-skip \fIoffset\fR
+Skip \fIoffset\fR bytes in the beginning of input file.
+.TP
+.B \-text
+Force text mode even if the input file looks like a Basic program, i.e.
+the first byte in file is 01.
+.TP
+.B \-k<\fIversion\fR>
+Just prints all valid keywords for the specified Basic \fIversion\fR.
+Without any \fIversion\fR, all names of supported BASIC versions are
+listed instead.
+.TP
+.B \-w<\fIversion\fR>
+Tokenise program listing using keywords set from the specified Basic
+\fIversion\fR.
+.TP
+\-<\fIversion\fR>
+Changes the set of keywords for the specified Basic \fIversion\fR and
+expands tokenized input file.
+Without this option
+.IR petcat
+uses V7.0 keywords in expanding.
+.SS Versions
+.TP 14
+.B 1
+Basic 1.0
+.TP
+.B 2
+Basic 2.0
+.TP
+.B a
+Basic 2.0 with AtBasic
+.TP
+.B t
+Basic 2.0 with Turtle Basic
+.TP
+.B super su se
+Basic 2.0 with Super Expander
+.TP
+.B simon si
+Basic 2.0 and Simons' Basic
+.TP
+.B speech sp
+Basic 2.0 with Speech Basic v2.7
+.TP
+.B 4
+Basic 4.0
+.TP
+.B 4e
+Basic 4.0 Extension
+.TP
+.B 3
+Basic 3.5
+.TP
+.B 7
+Basic 7.0
+.TP
+.B 10
+Basic 10.0
+.SH RESTRICTIONS
+.LP
+Line numbers must be less than 65536.
+Maximum line length is 255 bytes. Leading white space is ignored.
+Blank lines and line numbers not followed by any text are rejected.
+While expanding, Machine Language section concatenated to a BASIC
+program is ignored.
+While crunching, control codes that appear outside quotes are not
+interpreted.
+The low order byte of load address must be "01".
+.SH SEE ALSO
+.BR cat(1),
+.BR tr(1),
+.BR sed(1),
+.BR fvcbm(1),
+.BR petlp(1),
+.BR cbmconvert(1),
+.BR iso2asc(1),
+.BR ascii(7),
+.BR "\fICBM Tokens Documentation\fP",
+.BR "CBM's \fIProgrammers' Reference Guide\fP series"
+.P
+@HTMLDOC@
+.SH AUTHOR
+ Jouko Valta (jopi@stekt.oulu.fi)
+.SH Thanks to
+ Frederik Ekman (d91fe@lelle.pt.hk-r.se)
+ Marko M\(:akel\(:a (msmakela@nic.funet.fi)
+ Russell Alphey (r.alphey@dce.vic.gov.au)
+ Andr\('e Fachat (a.fachat@physik.tu-chemnitz.de)
+ Onno Ebbinge (ebbin200@hio.tem.NHL.NL)
+ Frank Kontros (jeno@kontr.uzhgorod.ua)
diff --git a/system/vice/man/vice.1 b/system/vice/man/vice.1
new file mode 100644
index 0000000000..b15ee17c81
--- /dev/null
+++ b/system/vice/man/vice.1
@@ -0,0 +1,183 @@
+.TH VICE 1 "August 2021" VICE "SlackBuilds.org"
+.SH NAME
+VICE - Versatile Commodore Emulator and Virtual Commodore Environment
+.SH DESCRIPTION
+.I VICE
+is a multi-platform emulator of the Commodore PET, CBM-II,
+VIC20, C64, C64DTV, C128 and Plus4 8-bit computers. The emulators run as
+separate programs, but have the same user interface, share the same
+settings and support the same file formats. Also some external
+utilities are provided.
+.P
+VICE is made up of the following programs:
+.TP 8
+.B x64
+a fast Commodore 64 emulator
+.TP
+.B x64sc
+an accurate Commodore 64 emulator
+.TP
+.B xscpu64
+an accurate SCPU64 emulator
+.TP
+.B x64dtv
+a C64DTV emulator
+.TP
+.B x128
+a Commodore 128 emulator
+.TP
+.B xvic
+a Commodore VIC20 emulator
+.TP
+.B xpet
+a Commodore PET emulator
+.TP
+.B xplus4
+a Commodore Plus4 emulator
+.TP
+.B xcbm2
+a Commodore CBM-II (6x0/7x0) emulator
+.TP
+.B xcbm5x0
+a Commodore CBM-II (5x0) emulator
+.TP
+.B vsid \fI[*]\fR
+a SID player
+.TP
+.B c1541 \fI[*]\fR
+a stand-alone disk image maintenance utility;
+.TP
+.B petcat \fI[*]\fR
+a Commodore BASIC (de)tokenizer;
+.TP
+.B cartconv \fI[*]\fR
+a cartridge file (bin<--->crt) converter;
+.PP
+Programs marked with \fI[*]\fR have their own man pages.
+.PP
+Any of the above programs can be run with the \fB\-\-help\fR option to
+get a list of command\-line options; there are too many to list here.
+You might want to pipe the output through a pager, e.g.
+.PP
+.B
+x64 \-\-help | less
+.PP
+The whole documentation for these programs is available in HTML
+format; the main file should be installed on your system as
+@HTMLDOC@
+.P
+The same documentation is available in PDF form as
+@PDFDOC@, or by selecting \fIHelp \-> Browse Manual\fR from within the emulator.
+.P
+For up to date news about VICE, have a look at the official home page
+at
+.P
+.RS
+http://vice-emu.sourceforge.net/
+.SH SEE ALSO
+.BR petcat(1),
+.BR cartconv(1),
+.BR c1541(1)
+.SH AUTHORS
+Marco van den Heuvel <blackystardust68@yahoo.com>
+.br
+Fabrizio Gennari <fabrizio.ge@tiscalinet.it>
+.br
+Groepaz <groepaz@gmx.net>
+.br
+Errol Smith <strobey@users.sourceforge.net>
+.br
+Olaf Seibert <rhialto@falu.nl>
+.br
+Marcus Sutton <loggedoubt@gmail.com>
+.br
+Kajtar Zsolt <soci@c64.rulez.org>
+.br
+AreaScout <areascout@gmx.at>
+.br
+Bas Wassink <b.wassink@ziggo.nl>
+.br
+Michael C. Martin <mcmartin@gmail.com>
+.br
+David Hogan <david.q.hogan@gmail.com>
+.br
+Martin Pottendorfer <pottendo@gmx.net>
+.br
+Stefan Haubenthal <polluks@users.sourceforge.net>
+.br
+BSzili <col.lawrence@gmail.com>
+.br
+Andreas Matthies <andreas.matthies@gmx.net>
+.br
+Daniel Kahlin <daniel@kahlin.net>
+.br
+Benjamin 'BeRo' Rosseaux <benjamin@rosseaux.com>
+.br
+Ulrich Schulz <peiselulli@t-online.de>
+.br
+Thomas Giesel <skoe@directbox.com>
+.br
+Ingo Korb <ingo@akana.de>
+.br
+Antti S. Lankila <alankila@bel.fi>
+.br
+Christian Vogelgsang <chris@vogelgsang.org>
+.br
+Dag Lem <resid@nimrod.no>
+.br
+Spiro Trikaliotis <Spiro.Trikaliotis@gmx.de>
+.br
+Hannu Nuotio <hannu.nuotio@tut.fi>
+.br
+Andreas Boose <viceteam@t-online.de>
+.br
+Tibor Biczo <crown@mail.matav.hu>
+.br
+M. Kiesel <mayne@users.sourceforge.net>
+.br
+Andreas Dehmel <zarquon@t-online.de>
+.br
+David Hansel <david@hansels.net>
+.br
+Markus Brenner <markus@brenner.de>
+.br
+Thomas Bretz <tbretz@ph.tum.de>
+.br
+Daniel Sladic <sladic@eecg.toronto.edu>
+.br
+Andr\('e Fachat <fachat@physik.tu-chemnitz.de>
+.br
+Ettore Perazzoli <ettore@comm2000.it>
+.br
+Teemu Rantanen <tvr@cs.hut.fi>
+.br
+Jouko Valta <jopi@stekt.oulu.fi>
+.br
+Jarkko Sonninen <sonninen@lut.fi>
+.br
+Mikkel Holm Olsen <vice-dk@symlink.dk>
+.br
+Manuel Antonio Rodriguez Bas <formater@winuaespanol.com>
+.br
+Paul Dub\('e
+.br
+Czirkos Zoltan <cirix@fw.hu>
+.br
+Karai Csaba <cskarai@freemail.hu>
+.br
+Andrea Musuruane <musuruan@bmm.it>
+.br
+Jesse Lee <interpreters.jesse@gmail.com>
+.br
+Jarek Sobolewski <r@sledinmay.com>
+.br
+Michael Litvinov <litvinov.m@i.ua>
+.br
+Peter Krefting <peter@softwolves.pp.se>
+.br
+Emir Akaydin (aka: Skate) <emir@akaydin.com>
+.br
+with several contributions from other people around the world; see the
+HTML documentation for more information.
+
+
diff --git a/system/vice/man/vsid.1 b/system/vice/man/vsid.1
new file mode 100644
index 0000000000..705dc75415
--- /dev/null
+++ b/system/vice/man/vsid.1
@@ -0,0 +1,24 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH VSID 1 "August 19, 2021" SlackBuilds.org
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.SH NAME
+vsid \- Play Commdore 64 SID music files
+.SH SYNOPSIS
+.B vsid
+.RI [vice-options]
+.RI musicfile.sid
+.SH DESCRIPTION
+.B vsid
+passes a Commodore 64 SID music file to the VICE x64 emulator, which
+then plays the default song. Any options given will also be passed to
+the emulator; in particular, use \fB\-sounddev <pulse|alsa|sdl>\fR
+to choose audio driver.
+.SH SEE ALSO
+.BR x64 (1),
+.BR sidplay (1).
+.SH AUTHOR
+This manual page was written by Zed Pobre <zed@debian.org>,
+for the Debian GNU/Linux system (but may be used by others).
+It was modified by B. Watson <urchlay@slackware.uk> for the
+SlackBuilds.org project.