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