games/generator_cbiere: Updated for version 0.35r4.

Signed-off-by: dsomero <xgizzmo@slackbuilds.org>

6 files changed, 401 insertions, 17 deletions

diff --git a/games/generator_cbiere/README b/games/generator_cbiere/README
index f60d357667617..6578978c13222 100644
--- a/games/generator_cbiere/README
+++ b/games/generator_cbiere/README
@@ -3,4 +3,13 @@ generator_cbiere (Sega Genesis/MegaDrive emulator)
 This is a modified version of Generator, by James Ponder, based on
 version 0.35.
 
-Note: press Control-F to get out of fullscreen mode.
+Notes:
+
+1. the binary is installed as /usr/games/generator-gtk.
+
+2. press Control-F to get out of fullscreen mode.
+
+3. By default, the emulator is built with the "raze" (x86 assembly
+   language) CPU core on 32-bit x86 platforms, and "cmz80" (written in C)
+   on other platforms. If you for some reason want to use cmz80 on x86,
+   export Z80CORE=cmz80 in the script's environment.
diff --git a/games/generator_cbiere/generator-gtk.6 b/games/generator_cbiere/generator-gtk.6
new file mode 100644
index 0000000000000..5a2774c4ba6f7
--- /dev/null
+++ b/games/generator_cbiere/generator-gtk.6
@@ -0,0 +1,220 @@
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "GENERATOR-GTK 6"
+.TH GENERATOR-GTK 6 "2013-04-03" "0.35r4" "SlackBuilds.org"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+generator\-gtk \- Sega Genesis/Megadrive emulator
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+generator-gtk \fB[options]\fR \fB[rom\-file]\fR
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+generator-gtk is a platform independent Sega Genesis/Megadrive emulator
+with a \s-1GTK+2\s0 user interface, using \s-1SDL\s0 for display/audio/input.
+.PP
+generator-gtk is a modified version of Generator by James Ponder based
+on version 0.35. It is known to work on FreeBSD, NetBSD and Linux.
+.PP
+generator-gtk has some features not found in original Generator:
+.IP "\-" 4
+Support for \s-1BZIP2\s0, \s-1GZIP\s0 and \s-1ZIP\s0 compressed ROMs i.e., no more manual decompression or wasted disk space. Yay!
+.IP "\-" 4
+Support for X11's XVideo hardware acceleration by \s-1SDL\s0 for faster and smoother graphics.
+.IP "\-" 4
+Fullscreen support with or without the classic color frame.
+.IP "\-" 4
+\&\s-1SDL\s0 audio support (in favour of \s-1OSS\s0 Audio) which means you can use ESound and others for sharing the sound device among other applications.
+.IP "\-" 4
+Optional mute playing i.e., if you don't have a soundcard or the soundcard is busy you can still play.
+.IP "\-" 4
+Support for 48kHz sample rate (needs driver support).
+.IP "\-" 4
+Automagic \s-1CPU\s0 usage reduction which is especially cool for notebooks. The unpatched Generator uses more or less as much \s-1CPU\s0 as it can get even if needs far less than 10% on any modern system.
+.IP "\-" 4
+Working support for Game Genie codes.
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\-a" 4
+.IX Item "-a"
+Arcade mode. Start emulation immediately, in fullscreen. Only useful
+if a \s-1ROM\s0 file is also provided on the command line. This option is very
+useful with frontends.
+.IP "\-d" 4
+.IX Item "-d"
+Debug mode. This is for debugging emulated \s-1ROM\s0 code. This option adds a
+Debug menu item to the \s-1UI\s0, with options for disassembling \s-1RAM\s0 and \s-1ROM\s0,
+and a console that displays the machine registers and offers breakpoints
+and single-stepping.
+.Sp
+Note: The debug console can still be activated without the \fB\-d\fR option
+(by pressing control-D), however the disassembler will not be available.
+.IP "\-r \fIregion\fR" 4
+.IX Item "-r region"
+Set region to \fBeurope\fR, \fBjapan\fR, or \fBusa\fR. Default: autodetected, or
+read from config file. This option should only be needed to work around
+broken or mis-detected ROMs.
+.IP "\-w \fIwork-dir\fR" 4
+.IX Item "-w work-dir"
+Set work directory. Default: current directory.
+.IP "\-c \fIconfig-file\fR" 4
+.IX Item "-c config-file"
+Use alternative config file. Default: \fB~/.genrc\fR.
+.SH "FILES"
+.IX Header "FILES"
+.IP "~/.genrc" 4
+.IX Item "~/.genrc"
+Default config file (may be changed with \fB\-c\fR option). This file is
+created when the Emulation \-> Options \-> Save button is pressed, and
+(if it exists) is loaded when \fBgenerator-gtk\fR starts up. The file is
+human-editable and well-commented, although users are expected to use
+the Options dialog to change the settings.
+.IP "\s-1ROM\s0 files" 4
+.IX Item "ROM files"
+\&\s-1ROM\s0 types supported: .rom or .smd interleaved (autodetected). \s-1ROM\s0 files
+may be compressed with bzip2, gzip, or zip.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+.IP "Original Generator manual:" 4
+.IX Item "Original Generator manual:"
+http://www.squish.net/generator/manual.html
+.Sp
+This is the documentation for unmodified Generator 0.35. Much of the
+information in the original manual doesn't apply to \fBgenerator-gtk\fR.
+.IP "Christian Biere's generator-gtk documentation:" 4
+.IX Item "Christian Biere's generator-gtk documentation:"
+http://www.squish.net/generator/cbiere/generator/
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+Generator is (c) James Ponder 1997\-2003, all rights reserved.
+.PP
+generator-gtk is a modified version of generator, by Christian Biere.
+.PP
+This man page written by B. Watson for the SlackBuilds.org project,
+but it may be used by anyone.
diff --git a/games/generator_cbiere/generator-gtk.pod b/games/generator_cbiere/generator-gtk.pod
new file mode 100644
index 0000000000000..a0a1c0e0f236b
--- /dev/null
+++ b/games/generator_cbiere/generator-gtk.pod
@@ -0,0 +1,141 @@
+# pod source for generator-gtk.1
+# build man page with:
+# pod2man -s6 -r0.35r4 --stderr -nGENERATOR-GTK -c'SlackBuilds.org'
+
+=pod
+
+=head1 NAME
+
+generator-gtk - Sega Genesis/Megadrive emulator
+
+=head1 SYNOPSIS
+
+generator-gtk B<[options]> B<[rom-file]>
+
+=head1 DESCRIPTION
+
+generator-gtk is a platform independent Sega Genesis/Megadrive emulator
+with a GTK+2 user interface, using SDL for display/audio/input.
+
+generator-gtk is a modified version of Generator by James Ponder based
+on version 0.35. It is known to work on FreeBSD, NetBSD and Linux.
+
+generator-gtk has some features not found in original Generator:
+
+=over
+
+
+=item -
+
+Support for BZIP2, GZIP and ZIP compressed ROMs i.e., no more manual decompression or wasted disk space. Yay!
+
+=item -
+
+Support for X11's XVideo hardware acceleration by SDL for faster and smoother graphics.
+
+=item -
+
+Fullscreen support with or without the classic color frame.
+
+=item -
+
+SDL audio support (in favour of OSS Audio) which means you can use ESound and others for sharing the sound device among other applications.
+
+=item -
+
+Optional mute playing i.e., if you don't have a soundcard or the soundcard is busy you can still play.
+
+=item -
+
+Support for 48kHz sample rate (needs driver support).
+
+=item -
+
+Automagic CPU usage reduction which is especially cool for notebooks. The unpatched Generator uses more or less as much CPU as it can get even if needs far less than 10% on any modern system.
+
+=item -
+
+Working support for Game Genie codes.
+
+=back
+
+=head1 OPTIONS
+
+=over
+
+=item -a
+
+Arcade mode. Start emulation immediately, in fullscreen. Only useful
+if a ROM file is also provided on the command line. This option is very
+useful with frontends.
+
+=item -d
+
+Debug mode. This is for debugging emulated ROM code. This option adds a
+Debug menu item to the UI, with options for disassembling RAM and ROM,
+and a console that displays the machine registers and offers breakpoints
+and single-stepping.
+
+Note: The debug console can still be activated without the B<-d> option
+(by pressing control-D), however the disassembler will not be available.
+
+=item -r I<region>
+
+Set region to B<europe>, B<japan>, or B<usa>. Default: autodetected, or
+read from config file. This option should only be needed to work around
+broken or mis-detected ROMs.
+
+=item -w I<work-dir>
+
+Set work directory. Default: current directory.
+
+=item -c I<config-file>  
+
+Use alternative config file. Default: B<~/.genrc>.
+
+=back
+
+=head1 FILES
+
+=over
+
+=item ~/.genrc
+
+Default config file (may be changed with B<-c> option). This file is
+created when the Emulation -> Options -> Save button is pressed, and
+(if it exists) is loaded when B<generator-gtk> starts up. The file is
+human-editable and well-commented, although users are expected to use
+the Options dialog to change the settings.
+
+=item ROM files
+
+ROM types supported: .rom or .smd interleaved (autodetected). ROM files
+may be compressed with bzip2, gzip, or zip.
+
+=back
+
+=head1 SEE ALSO
+
+=over
+
+=item Original Generator manual:
+
+http://www.squish.net/generator/manual.html
+
+This is the documentation for unmodified Generator 0.35. Much of the
+information in the original manual doesn't apply to B<generator-gtk>.
+
+=item Christian Biere's generator-gtk documentation:
+
+http://www.squish.net/generator/cbiere/generator/
+
+=back
+
+=head1 AUTHOR
+
+Generator is (c) James Ponder 1997-2003, all rights reserved.
+
+generator-gtk is a modified version of generator, by Christian Biere.
+
+This man page written by B. Watson for the SlackBuilds.org project,
+but it may be used by anyone.
diff --git a/games/generator_cbiere/generator_cbiere.SlackBuild b/games/generator_cbiere/generator_cbiere.SlackBuild
index 7ee012f39dc38..9cdf0eb13d411 100644
--- a/games/generator_cbiere/generator_cbiere.SlackBuild
+++ b/games/generator_cbiere/generator_cbiere.SlackBuild
@@ -6,17 +6,21 @@
 
 # Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
 
+# 20130402 bkw:
+# - Updated for 0.35r4 (heh, it's only been out since 2008)
+# - Fixed homepage in .info file
+# - Added man page
+# - Documented Z80CORE option in README
+
 PRGNAM=generator_cbiere
-VERSION=${VERSION:-0.35r3}
+VERSION=${VERSION:-0.35r4}
 BUILD=${BUILD:-1}
 TAG=${TAG:-_SBo}
 
-# Automatically determine the architecture we're building on:
 if [ -z "$ARCH" ]; then
   case "$( uname -m )" in
     i?86) ARCH=i486 ;;
     arm*) ARCH=arm ;;
-    # Unless $ARCH is already set, use uname -m for all other archs:
        *) ARCH=$( uname -m ) ;;
   esac
 fi
@@ -26,9 +30,7 @@ TMP=${TMP:-/tmp/SBo}
 PKG=$TMP/package-$PRGNAM
 OUTPUT=${OUTPUT:-/tmp}
 
-# I am just not going to contort the script to turn the $VERSION
-# into the source filename. Caveat scriptor...
-SOURCE=generator-0.35-cbiere-r3
+SOURCE=generator-$( echo $VERSION | sed "s,r,-cbiere-r,")
 
 # The docs say the "raze" Z80 core is faster, but x86-only.
 # If you really want the "cmz80" core on an x86 box, set
@@ -67,7 +69,8 @@ CXXFLAGS="$SLKCFLAGS" \
   --with-sdl-audio \
   --build=$ARCH-slackware-linux
 
-make
+# Have to force -j1 or the build fails. Bummer.
+make -j1
 make install-strip DESTDIR=$PKG
 
 # Icon by Deleket (Jojo Mendoza), downloaded from:
@@ -75,9 +78,20 @@ make install-strip DESTDIR=$PKG
 mkdir -p $PKG/usr/share/pixmaps
 cat $CWD/$PRGNAM.png > $PKG/usr/share/pixmaps/$PRGNAM.png
 
+# .desktop file by SlackBuild author
 mkdir -p $PKG/usr/share/applications
 cat $CWD/$PRGNAM.desktop > $PKG/usr/share/applications/$PRGNAM.desktop
 
+# man page by SlackBuild author
+mkdir -p $PKG/usr/man/man6
+if [ ! -e $CWD/generator-gtk.6 ]; then
+  pod2man \
+    -s6 -r0.35r4 --stderr -nGENERATOR-GTK -c'SlackBuilds.org' \
+    $CWD/generator-gtk.pod \
+    > $CWD/generator-gtk.6
+fi
+gzip -9c < $CWD/generator-gtk.6 > $PKG/usr/man/man6/generator-gtk.6.gz
+
 mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
 cp AUTHORS COPYING ChangeLog LICENSE NEWS README TODO docs/* \
   $PKG/usr/doc/$PRGNAM-$VERSION
diff --git a/games/generator_cbiere/generator_cbiere.info b/games/generator_cbiere/generator_cbiere.info
index b443a47035250..7df7d20b1a4ab 100644
--- a/games/generator_cbiere/generator_cbiere.info
+++ b/games/generator_cbiere/generator_cbiere.info
@@ -1,8 +1,8 @@
 PRGNAM="generator_cbiere"
-VERSION="0.35r3"
-HOMEPAGE="http://www.ghostwhitecrab.com/generator/"
-DOWNLOAD="http://mirrors.kernel.org/gentoo/distfiles/generator-0.35-cbiere-r3.tar.bz2"
-MD5SUM="5ab81706482d2c2c9932521a25dbae28"
+VERSION="0.35r4"
+HOMEPAGE="http://www.squish.net/generator/cbiere/generator/"
+DOWNLOAD="http://www.squish.net/generator/cbiere/generator/generator-0.35-cbiere-r4.tar.bz2"
+MD5SUM="db4142912872a3f34d6d4e3bfe693b64"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES=""
diff --git a/games/generator_cbiere/slack-desc b/games/generator_cbiere/slack-desc
index bc4bca9a3e1c8..67ce98c3765c5 100644
--- a/games/generator_cbiere/slack-desc
+++ b/games/generator_cbiere/slack-desc
@@ -1,9 +1,9 @@
 # HOW TO EDIT THIS FILE:
-# The "handy ruler" below makes it easier to edit a package description.  Line
-# up the first '|' above the ':' following the base package name, and the '|'
-# on the right side marks the last column you can put a character in.  You must
-# make exactly 11 lines for the formatting to be correct.  It's also
-# customary to leave one space after the ':'.
+# The "handy ruler" below makes it easier to edit a package description.
+# Line up the first '|' above the ':' following the base package name, and
+# the '|' on the right side marks the last column you can put a character in.
+# You must make exactly 11 lines for the formatting to be correct.  It's also
+# customary to leave one space after the ':' except on otherwise blank lines.
 
                 |-----handy-ruler------------------------------------------------------|
 generator_cbiere: generator_cbiere (Sega Genesis/MegaDrive emulator)