Commit | Line | Data |
---|---|---|
ca76b8cb KB |
1 | |
2 | Bog is a fairly portable simulation of Parker Brother's game of Boggle and | |
3 | is similar to the 4.[23] BSD "boggle" and Sun's "boggletool". | |
4 | Bog has not been derived from any proprietary code. | |
5 | It has been tested on the Sun 3 under SunOS 3.2 and on the Atari 1040ST (MWC). | |
6 | ||
7 | What You Need | |
8 | ||
9 | You will need curses/termcap and a large word list. | |
10 | The minix word list or /usr/dict/words will do nicely. | |
11 | The word list must already be sorted (you can use "sort -c" to check). | |
12 | ||
13 | Contents | |
14 | ||
15 | README - this file | |
16 | Makefile | |
17 | bog.man - half-hearted man page (use the game's help command) | |
18 | bog.h - configuration and header info | |
19 | bog.c - machine independent game code | |
20 | word.c - machine independent word list routines | |
21 | help.c - (curses) help routine | |
22 | mach.c - (curses) display code | |
23 | prtable.c - ditto | |
24 | timer.c - machine dependent (os) input polling | |
25 | mkdict.c - convert a word list to a bog dictionary | |
26 | mkindex.c - create an index file for the bog dictionary | |
27 | showdict.c - print a bog dictionary to stdout | |
28 | ||
29 | Portability | |
30 | ||
31 | - I've tried to make bog.c (the program logic) independent of the I/O. | |
32 | My plan was to make it straightforward to adapt the game to run under a | |
33 | windowing system (eg., Suntools, GEM). I have no plan to actually do this. | |
34 | I've stuck to a small subset of the curses routines. | |
35 | - The program runs with the input in raw mode. | |
36 | - If you want the running timer you must #define TIMER in bog.h | |
37 | and insert the input polling code in timer.c for your system. There is | |
38 | already code there for BSD, SYSV, and ATARI. | |
39 | ||
40 | Setup | |
41 | ||
42 | 1. Check bog.h and Makefile and edit to fit your environment | |
43 | 2. "make all" | |
44 | This will make all the binaries and create the dictionary and index files | |
45 | 3. Move "dict", "dict.ind", and "helpfile" to where you specified in bog.h | |
46 | 4. Play away | |
47 | ||
48 | Distribution | |
49 | ||
50 | You may use this software for your enjoyment and you may share it with others. | |
51 | You may not sell this software or use it for any commercial purposes | |
52 | whatsoever. All modified versions of the software that you redistribute must | |
53 | clearly indicate your changes. | |
54 | ||
55 | If you come across any bugs or make any changes you'd like to share please | |
56 | send mail to me rather than posting to the net. | |
57 | ||
58 | Enjoy. [But beware: boggle can be addictive!] | |
59 | ||
60 | ----- | |
61 | Barry Brachman | UUCP: {alberta,uw-beaver,uunet}! | |
62 | Dept. of Computer Science| ubc-vision!ubc-csgrads!brachman | |
63 | Univ. of British Columbia| Internet: brachman@cs.ubc.ca | |
64 | Vancouver, B.C. V6T 1W5 | brachman%ubc.csnet@csnet-relay.arpa | |
65 | (604) 228-5010 | brachman@ubc.csnet |