games/atari800: Updated for version 5.0.0.

Signed-off-by: B. Watson <urchlay@slackware.uk>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
This commit is contained in:
B. Watson 2022-06-15 14:02:46 -04:00 committed by Willy Sudiarto Raharjo
parent ff20196e28
commit c660a9d52c
No known key found for this signature in database
GPG key ID: 3F617144D7238786
4 changed files with 227 additions and 5 deletions

View file

@ -6,6 +6,10 @@
# Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
# 20220615 bkw:
# - update for 5.0.0.
# - add man page for new cart utility.
# 20220407 bkw: BUILD=2, strip binary.
# 20200303 bkw:
@ -25,8 +29,8 @@
cd $(dirname $0) ; CWD=$(pwd)
PRGNAM=atari800
VERSION=${VERSION:-4.2.0}
BUILD=${BUILD:-2}
VERSION=${VERSION:-5.0.0}
BUILD=${BUILD:-1}
TAG=${TAG:-_SBo}
PKGTYPE=${PKGTYPE:-tgz}
@ -131,6 +135,8 @@ sed '/^\.TH *ATARI800 *1/s| 1 | 6 |' $PKG/usr/man/man1/$PRGNAM.1 | \
$PKG/usr/man/man6/$PRGNAM.6.gz
rm -rf $PKG/usr/man/man1
gzip -9c < $CWD/cart.6 > $PKG/usr/man/man6/cart.6.gz
cat $CWD/$PRGNAM.SlackBuild > $PKGDOCDIR/$PRGNAM.SlackBuild
[ ! -d ../DOC ] && cd src

View file

@ -1,8 +1,8 @@
PRGNAM="atari800"
VERSION="4.2.0"
VERSION="5.0.0"
HOMEPAGE="https://atari800.github.io/"
DOWNLOAD="https://github.com/atari800/atari800/releases/download/ATARI800_4_2_0/atari800-4.2.0-src.tgz"
MD5SUM="695031b9bc3461cd18ec9090779d984b"
DOWNLOAD="https://github.com/atari800/atari800/releases/download/ATARI800_5_0_0/atari800-5.0.0-src.tgz"
MD5SUM="f5dc10d461d0241a5978a0998028e49a"
DOWNLOAD_x86_64=""
MD5SUM_x86_64=""
REQUIRES=""

124
games/atari800/cart.6 Normal file
View file

@ -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.
.

92
games/atari800/cart.rst Normal file
View file

@ -0,0 +1,92 @@
.. RST source for cart(1) man page. Convert with:
.. rst2man.py cart.rst > cart.6
.. rst2man.py comes from the SBo development/docutils package.
.. |version| replace:: 5.0.0
.. |date| date::
====
cart
====
----------------------------------------------------------
convert raw Atari 8-bit ROM images to Atari800 CART files.
----------------------------------------------------------
:Manual section: 6
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|
SYNOPSIS
========
cart *romfile* *cartfile* *carttype*
cart **-l**
cart **-p** *romfile*
DESCRIPTION
===========
**cart** creates an Atari800 CART image file from a raw Atari 8-bit ROM
image file by adding a 16-byte **CART** header.
The *romfile* is a file containing a raw Atari 8-bit ROM image
dump. It must be of the correct size for the *carttype* argument
(e.g. for type 1, "Standard 8KB cartridge", the file must be exactly
8192 bytes).
Output is written to *cartfile*. This must be a different filename
from *romfile* (in-place conversion is not supported). *cartfile* will
be exactly 16 bytes longer than *romfile* (e.g. for type 1, it will be
8208 bytes).
The *carttype* argument is numeric, one of the supported types. The
list can be viewed with **cart -l**. If you're not sure of the correct
type for a given ROM, you can narrow it down by running **cart -p**
*romfile*, which will show all the possible types that match the size
of the ROM.
There is no corresponding tool to convert a CART image back to a raw
ROM file, but this can be done with e.g. **dd**\(1)::
dd if=image.cart of=image.raw bs=1 skip=16
...or **head**\(1) and **cat**\(1)::
cat image.cart | ( head -c16 >/dev/null ; cat ) > image.raw
OPTIONS
=======
-l Show the complete list of supported cartridge types.
-p *romfile*
Show the list of cartridge types that match the size of *romfile*.
COPYRIGHT
=========
See the file /usr/doc/atari800-|version|/COPYING for license information.
AUTHORS
=======
**cart** is part of the **atari800**\(6) distribution. See
/usr/doc/atari800-|version|/CREDITS for the list of authors.
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
SEE ALSO
========
**atari800**\(6)
Full documentation for the CART file format:
/usr/doc/atari800-|version|/cart.txt
The **atari800** website:
https://atari800.github.io/