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>

4 files changed, 227 insertions, 5 deletions

diff --git a/games/atari800/atari800.SlackBuild b/games/atari800/atari800.SlackBuild
index c4ef137c6de6e..854d2ad33985b 100644
--- a/games/atari800/atari800.SlackBuild
+++ b/games/atari800/atari800.SlackBuild
@@ -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
 
diff --git a/games/atari800/atari800.info b/games/atari800/atari800.info
index fce9485241c3e..d06eb989c3c92 100644
--- a/games/atari800/atari800.info
+++ b/games/atari800/atari800.info
@@ -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=""
diff --git a/games/atari800/cart.6 b/games/atari800/cart.6
new file mode 100644
index 0000000000000..9153c92eac308
--- /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.
+.
diff --git a/games/atari800/cart.rst b/games/atari800/cart.rst
new file mode 100644
index 0000000000000..77a207d864874
--- /dev/null
+++ b/games/atari800/cart.rst
@@ -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/