OpenGrok

1.2  cgd $NetBSD: README,v 1.2 1995/03/21 12:14:21 cgd Exp $
1.1  jtc
1.1  jtc Bog is a fairly portable simulation of Parker Brother's game of Boggle and
1.1  jtc is similar to the 4.[23] BSD "boggle" and Sun's "boggletool".
1.1  jtc Bog has not been derived from any proprietary code.
1.1  jtc It has been tested on the Sun 3 under SunOS 3.2 and on the Atari 1040ST (MWC).
1.1  jtc
1.1  jtc What You Need
1.1  jtc
1.1  jtc You will need curses/termcap and a large word list.
1.1  jtc The minix word list or /usr/dict/words will do nicely.
1.1  jtc The word list must already be sorted (you can use "sort -c" to check).
1.1  jtc
1.1  jtc Contents
1.1  jtc
1.1  jtc 	README		- this file
1.1  jtc 	Makefile
1.1  jtc 	bog.man		- half-hearted man page (use the game's help command)
1.1  jtc 	bog.h		- configuration and header info
1.1  jtc 	bog.c		- machine independent game code
1.1  jtc 	word.c		- machine independent word list routines
1.1  jtc 	help.c		- (curses) help routine
1.1  jtc 	mach.c		- (curses) display code
1.1  jtc 	prtable.c	- ditto
1.1  jtc 	timer.c		- machine dependent (os) input polling
1.1  jtc 	mkdict.c	- convert a word list to a bog dictionary
1.1  jtc 	mkindex.c	- create an index file for the bog dictionary
1.1  jtc 	showdict.c	- print a bog dictionary to stdout
1.1  jtc
1.1  jtc Portability
1.1  jtc
1.1  jtc - I've tried to make bog.c (the program logic) independent of the I/O.
1.1  jtc   My plan was to make it straightforward to adapt the game to run under a
1.1  jtc   windowing system (eg., Suntools, GEM).  I have no plan to actually do this.
1.1  jtc   I've stuck to a small subset of the curses routines.
1.1  jtc - The program runs with the input in raw mode.
1.1  jtc - If you want the running timer you must #define TIMER in bog.h
1.1  jtc   and insert the input polling code in timer.c for your system.  There is
1.1  jtc   already code there for BSD, SYSV, and ATARI.
1.1  jtc
1.1  jtc Setup
1.1  jtc
1.1  jtc 1. Check bog.h and Makefile and edit to fit your environment
1.1  jtc 2. "make all"
1.1  jtc    This will make all the binaries and create the dictionary and index files
1.1  jtc 3. Move "dict", "dict.ind", and "helpfile" to where you specified in bog.h
1.1  jtc 4. Play away
1.1  jtc
1.1  jtc Distribution
1.1  jtc
1.1  jtc You may use this software for your enjoyment and you may share it with others.
1.1  jtc You may not sell this software or use it for any commercial purposes
1.1  jtc whatsoever.  All modified versions of the software that you redistribute must
1.1  jtc clearly indicate your changes.
1.1  jtc
1.1  jtc If you come across any bugs or make any changes you'd like to share please
1.1  jtc send mail to me rather than posting to the net.
1.1  jtc
1.1  jtc Enjoy. [But beware: boggle can be addictive!]
1.1  jtc
1.1  jtc -----
1.1  jtc Barry Brachman           | UUCP:    {alberta,uw-beaver,uunet}!
1.1  jtc Dept. of Computer Science|           ubc-vision!ubc-csgrads!brachman
1.1  jtc Univ. of British Columbia| Internet: brachman (a] cs.ubc.ca
1.1  jtc Vancouver, B.C. V6T 1W5  |           brachman%ubc.csnet (a] csnet-relay.arpa
1.1  jtc (604) 228-5010           | brachman (a] ubc.csnet