README
1sdlroids - an enhanced shoot-the-asteroids game.
2Copyright (C) 1991 Edward Hutchins.
3Unix/Linux port by Russell Marks, 2000.
4SDL port by David Hedbor <david@hedbor.org>
5
6
7DESCRIPTION
8-----------
9
10Hyperoid was a really cool little game for Windows 3.x. It's
11essentially an Asteroids clone, with decent game physics and
12enhancements over the original game.
13
14Once you've installed sdlroid , READ THE MAN PAGE. Some things about
15it are a bit non-obvious, and it can save time to have them pointed
16out.
17
18Some of the improvements over xhyperoid are:
19
20- Pause functionality.
21- Fullscreen mode.
22- Less flickering.
23- Nicer place area (you can see the borders) and better edge handling
24 (things just don't pop from one side to another).
25- Uses SDL, and thus supports a more platforms. Can also use the esound
26 daemon if SDL is compiled with it.
27- Added configure scripts to simplify porting to different platforms.
28
29
30LICENSE
31-------
32
33GPL. See COPYING for details.
34
35
36INSTALLATION
37------------
38
39See INSTALL for details.
40
41CONTACTING ME
42-------------
43
44My email address is david@hedbor.org. The original Unix port was done
45by Russell Marks, russell.marks@ntlworld.com. There are no known ways
46of contacting the original author, Edward Hutchins as far as I or
47Russell know.
48
49Enjoy the game. If you have any suggestions for improvements, let me
50know.
51
README.petopt
1 Petopt 0.x
2
3 Copyright (c) 1999 Peter Eriksson <pen@lysator.liu.se>
4
5
6
7Petopt is a free command line argument parser. It handles short and
8long options, including abbreviated long options. See the file "tst.c"
9for a demonstration of how it's used.
10
11It is mainly intended to be included in other programs.
12
13
14
15LICENSE:
16
17This program is free software; you can redistribute it and/or
18modify it as you wish - as long as you don't claim that you wrote
19it.
20
21This program is distributed in the hope that it will be useful,
22but WITHOUT ANY WARRANTY; without even the implied warranty of
23MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
24
25
26
27DOWNLOAD:
28
29Petopt's main FTP site is located at:
30
31 ftp://ftp.lysator.liu.se/pub/unix/petopt/
32
README.xhyperoid
1xhyperoid - an enhanced shoot-the-asteroids game.
2Copyright (C) 1991 Edward Hutchins.
3Unix/Linux port by Russell Marks, 2000.
4
5This program is free software; you can redistribute it and/or modify
6it under the terms of the GNU General Public License as published by
7the Free Software Foundation; either version 2 of the License, or (at
8your option) any later version.
9
10This program is distributed in the hope that it will be useful, but
11WITHOUT ANY WARRANTY; without even the implied warranty of
12MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13General Public License for more details.
14
15You should have received a copy of the GNU General Public License
16along with this program; if not, write to the Free Software
17Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18
19
20Description
21-----------
22
23Hyperoid was a really cool little game for Windows 3.x. It's
24essentially an Asteroids clone, but with a few extra features. There
25are three reasons I ported it:
26
27 - the decent game physics and enhancements over the original game
28 make it probably my favourite Asteroids variant;
29
30 - it's always sucked having to run it under Windows (admittedly, you
31 can run the original under Wine, but it's less than ideal);
32
33 - it's the first GPL'd program I ever saw, which gives it a certain
34 special something for me. :-)
35
36One of the first things I did on porting it was to add sound, so
37that's another plus. :-)
38
39Once you've installed it, READ THE MAN PAGE. Some things about it are
40a bit non-obvious, and it can save time to have them pointed out...
41
42
43Installation
44------------
45
46Despite the `xhyperoid' name, there are actually two versions - one
47for X, and one for svgalib. The X version requires GTK+ (it probably
48needs 1.2.x or better).
49
50(You can get GTK+ from http://www.gtk.org if you don't already have
51it, but if you run Linux you probably do, or can install a `gtk'
52package from your distribution (be sure to install any `gtk-devel' or
53similar too). Much the same is true of svgalib -
54http://www.svgalib.org for that.)
55
56You can choose to compile either version, or both. Here's what to do:
57
58 make x # for xhyperoid (X version) only
59or
60 make vga # for vhyperoid (svgalib version) only
61or
62 make # for both
63
64If you don't know what to do, `make x' is probably safest.
65
66After that's finished, do (as root) `make install'. And as I say, be
67sure to read the man page. :-)
68
69(BTW, the X version stands a fair chance of working on non-Linux
70machines, though you'll probably have to comment out DO_SOUND in the
71Makefile. I'd like to know of any success or failure anyone has with
72this.)
73
74
75Contacting me
76-------------
77
78You can email me at russell.marks@ntlworld.com.
79
80Unfortunately, I don't have any contact details for the original
81author of Hyperoid (Edward Hutchins); as far as I can tell, his email
82address as given in README.orig seems to have been valid until at
83least 1994, but doesn't work any more. There is a snail-mail address
84for him in README.orig if you're desperate :-), but as it dates from
851991, it may or may not be valid any more.
86
87
88Have fun,
89-Rus.
90