mirror of
https://github.com/Ponce/slackbuilds
synced 2024-11-16 19:50:19 +01:00
c660a9d52c
Signed-off-by: B. Watson <urchlay@slackware.uk> Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
124 lines
3.1 KiB
Groff
124 lines
3.1 KiB
Groff
.\" 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.
|
|
.
|