From c660a9d52ccb230ef89666232a2100b6cd90e37b Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Wed, 15 Jun 2022 14:02:46 -0400 Subject: games/atari800: Updated for version 5.0.0. Signed-off-by: B. Watson Signed-off-by: Willy Sudiarto Raharjo --- games/atari800/atari800.SlackBuild | 10 ++- games/atari800/atari800.info | 6 +- games/atari800/cart.6 | 124 +++++++++++++++++++++++++++++++++++++ games/atari800/cart.rst | 92 +++++++++++++++++++++++++++ 4 files changed, 227 insertions(+), 5 deletions(-) create mode 100644 games/atari800/cart.6 create mode 100644 games/atari800/cart.rst (limited to 'games/atari800') diff --git a/games/atari800/atari800.SlackBuild b/games/atari800/atari800.SlackBuild index c4ef137c6d..854d2ad339 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 fce9485241..d06eb989c3 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 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. +. diff --git a/games/atari800/cart.rst b/games/atari800/cart.rst new file mode 100644 index 0000000000..77a207d864 --- /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/ -- cgit v1.2.3