README for Pente 2.2.1, 30 November 1997 QUICK BUILD RULES: Run "./configure", then "make", then "pente". If all goes well, you're now playing the game! MORE ABOUT COMPILING: To compile Pente, you need an ANSI compatible C compiler, such as gcc. If you want a graphic interface, you need X11R3 or later; otherwise you will only be able to use the curses or text interfaces. Pente will intelligently configure itself to run on the interfaces available. Pente uses Gnu's "autoconfig" utility. To build a makefile, type "./configure" and (hopefully) configure will do the rest. If you have problems building, see the end of this document. Once you have a Makefile you may want to edit the following parts: prefix, bindir, mandir: These should point to the directories where the executable and the man pages should be put. These can also be set with "configure --prefix=...", etc. CC This is the C compiler that will be used. If you want to use a different compiler than the one that "configure" wants to use, you shouldn't just change the Makefile. Instead, set the shell environment variable "CC" to the name of your C compiler before running "configure". If you just change the Makefile after "configure" runs, then "configure" will build configuration files for the wrong compiler. CFLAGS: Set this to optimize as well as your C compiler can. "configure" will try to guess at the best value. LFLAGS: If configure doesn't add all the libraries it needs you can add them here. After you have built the Makefile and (optionally) edited it, you can build pente by typing "make". You can then run pente straight from the build area. There will be a symbolic link, "pente", that you can run. The actual binary will be called "pente-<computer name>". For example, on my linux system I get "pente-i586-Linux". This is done so that you can build pente for different computers on a single file system. "pente" will always point to the last binary built. To install pente, you must first set the bindir and mandir as described above, then type "make install". Instructions on how to play pente are part of the X interface. The man page contains information on running pente. Please send bug reports, comments, etc. to William shubert, internet address "wms@hevanet.com", and don't forget to check out my web page at "http://www.hevanet.com/wms/"! Enjoy! LICENCE This source code and all associated documentation is covered by the Gnu General Public Licence version 2. You should have gotten a copy of this document with the source code in a file called "COPYING". If you didn't, it is available from the Free Software Foundation, Inc. of Cambridge, MA or by anonymous FTP from prep.ai.mit.edu. The X11 version also has the licence in one of the help pages. RELEASE HISTORY 2.1.7 Got a bunch of bugs out. Ready for another post to rec.games.abstract. 2.1.0 Got network play working again! Much nicer than before. Beta release to find bugs. 2.0.5 Added French text thanks to Eric Dupas, fixed several minor bugs and several major portability bugs. 2.0.0 Major rewrite on the interface code. Also added the "redo" button, the setup window, and greatly improved the help window. 1.1.1 Fixed bug in "pente -perf" that made comparing numbers useless. Announced in rec.games.go and hand-mailed to people who ask for it. 1.1.0 Bug fixes, user interface enhancements, and portability changes. Fixed innumerable bugs in the user interface and the computer strategy system. No changes were made to computer strategy except where it didn't do what I intended when I first wrote it. Added the help window and generally tweaks up every part of the user interface to look and feel as nice as possible. Added use of Gnu Autonfig utility and tried system on several different machines. 1.0.0 First release. Put into alt.games.abstact FTP site. REQUEST FOR HELP If this program doesn't just configure and build on your system, drop me a note about what went wrong and I'll try to fix it in a patch release. Also, I want it to support different languages. Currently it can run in English, French or Italian. If you want to translate my strings into another language, great! Get in touch with me! I'd like to make the sound interface more portable; right now I only know how to do sound on a Sparc or a Linux machine. If you can port it to other machines, by all means let me know. PROBLEM BUILDS If you simply cannot get configure to run, don't give up hope! You can still do it! The "Makefile-std" is a fairly typical Makefile (it's for Linux). Copy it to "Makefile" and edit it. The directories that you need to create are described in the Makefile. Once you do that, you will have to make a configure.h from configure.h.in. To do this, copy configure.h to your top level obj directory (which you should have created as the Makefile says), rename it "configure.h", then edit it. Finally, just type "make"! ACKNOWLEDGEMENTS Thanks to Eric Dupas for translating the X11 strings into French and to Andrea Borgia for translating them into Italian. Thanks to Yary Hluchan for helping to rewrite the man page. And thanks for all the people who submitted bug reports or ideas for the program, who tried to compile on their machines, or who were willing to beta test the program!
