1 files changed, 247 insertions, 0 deletions
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>