diff options
Diffstat (limited to 'games/atari800/cart.6')
| -rw-r--r-- | games/atari800/cart.6 | 124 |
1 files changed, 124 insertions, 0 deletions
diff --git a/games/atari800/cart.6 b/games/atari800/cart.6 new file mode 100644 index 0000000000..9153c92eac --- /dev/null +++ b/games/atari800/cart.6 @@ -0,0 +1,124 @@ +.\" 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 "CART" 6 "2022-06-15" "5.0.0" "SlackBuilds.org" +.SH NAME +cart \- convert raw Atari 8-bit ROM images to Atari800 CART files. +.\" RST source for cart(1) man page. Convert with: +. +.\" rst2man.py cart.rst > cart.6 +. +.\" rst2man.py comes from the SBo development/docutils package. +. +.SH SYNOPSIS +.sp +cart \fIromfile\fP \fIcartfile\fP \fIcarttype\fP +.sp +cart \fB\-l\fP +.sp +cart \fB\-p\fP \fIromfile\fP +.SH DESCRIPTION +.sp +\fBcart\fP creates an Atari800 CART image file from a raw Atari 8\-bit ROM +image file by adding a 16\-byte \fBCART\fP header. +.sp +The \fIromfile\fP is a file containing a raw Atari 8\-bit ROM image +dump. It must be of the correct size for the \fIcarttype\fP argument +(e.g. for type 1, "Standard 8KB cartridge", the file must be exactly +8192 bytes). +.sp +Output is written to \fIcartfile\fP\&. This must be a different filename +from \fIromfile\fP (in\-place conversion is not supported). \fIcartfile\fP will +be exactly 16 bytes longer than \fIromfile\fP (e.g. for type 1, it will be +8208 bytes). +.sp +The \fIcarttype\fP argument is numeric, one of the supported types. The +list can be viewed with \fBcart \-l\fP\&. If you\(aqre not sure of the correct +type for a given ROM, you can narrow it down by running \fBcart \-p\fP +\fIromfile\fP, which will show all the possible types that match the size +of the ROM. +.sp +There is no corresponding tool to convert a CART image back to a raw +ROM file, but this can be done with e.g. \fBdd\fP(1): +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +dd if=image.cart of=image.raw bs=1 skip=16 +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +\&...or \fBhead\fP(1) and \fBcat\fP(1): +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +cat image.cart | ( head \-c16 >/dev/null ; cat ) > image.raw +.ft P +.fi +.UNINDENT +.UNINDENT +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-l +Show the complete list of supported cartridge types. +.UNINDENT +.INDENT 0.0 +.TP +.B \-p \fIromfile\fP +Show the list of cartridge types that match the size of \fIromfile\fP\&. +.UNINDENT +.SH COPYRIGHT +.sp +See the file /usr/doc/atari800\-5.0.0/COPYING for license information. +.SH AUTHORS +.sp +\fBcart\fP is part of the \fBatari800\fP(6) distribution. See +/usr/doc/atari800\-5.0.0/CREDITS for the list of authors. +.sp +This man page written for the SlackBuilds.org project +by B. Watson, and is licensed under the WTFPL. +.SH SEE ALSO +.sp +\fBatari800\fP(6) +.INDENT 0.0 +.TP +.B Full documentation for the CART file format: +/usr/doc/atari800\-5.0.0/cart.txt +.TP +.B The \fBatari800\fP website: +\fI\%https://atari800.github.io/\fP +.UNINDENT +.\" Generated by docutils manpage writer. +. |