README 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. $NetBSD: README,v 1.2 1995/03/21 12:14:21 cgd Exp $
  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. What You Need
  7. You will need curses/termcap and a large word list.
  8. The minix word list or /usr/dict/words will do nicely.
  9. The word list must already be sorted (you can use "sort -c" to check).
  10. Contents
  11. README - this file
  12. Makefile
  13. bog.man - half-hearted man page (use the game's help command)
  14. bog.h - configuration and header info
  15. bog.c - machine independent game code
  16. word.c - machine independent word list routines
  17. help.c - (curses) help routine
  18. mach.c - (curses) display code
  19. prtable.c - ditto
  20. timer.c - machine dependent (os) input polling
  21. mkdict.c - convert a word list to a bog dictionary
  22. mkindex.c - create an index file for the bog dictionary
  23. showdict.c - print a bog dictionary to stdout
  24. Portability
  25. - I've tried to make bog.c (the program logic) independent of the I/O.
  26. My plan was to make it straightforward to adapt the game to run under a
  27. windowing system (eg., Suntools, GEM). I have no plan to actually do this.
  28. I've stuck to a small subset of the curses routines.
  29. - The program runs with the input in raw mode.
  30. - If you want the running timer you must #define TIMER in bog.h
  31. and insert the input polling code in timer.c for your system. There is
  32. already code there for BSD, SYSV, and ATARI.
  33. Setup
  34. 1. Check bog.h and Makefile and edit to fit your environment
  35. 2. "make all"
  36. This will make all the binaries and create the dictionary and index files
  37. 3. Move "dict", "dict.ind", and "helpfile" to where you specified in bog.h
  38. 4. Play away
  39. Enjoy. [But beware: boggle can be addictive!]
  40. -----
  41. Barry Brachman | UUCP: {alberta,uw-beaver,uunet}!
  42. Dept. of Computer Science| ubc-vision!ubc-csgrads!brachman
  43. Univ. of British Columbia| Internet: brachman@cs.ubc.ca
  44. Vancouver, B.C. V6T 1W5 | brachman%ubc.csnet@csnet-relay.arpa
  45. (604) 228-5010 | brachman@ubc.csnet
  46. Note: Barry Brachman has confirmed that boggle is under the standard
  47. BSD licence, and he is no longer supporting the game, so bug reports
  48. should go to the appropriate distributor.