------------------------------------------------------------------ Role PlayingDB V2.0 by Deepwoods Software ------------------------------------------------------------------ README - Read this file first! Created by Robert Heller on Tue Jul 13 18:39:59 1999 ------------------------------------------------------------------ Modification History: $Log: README,v $ Revision 1.1 1999/07/13 19:13:24 heller Initial revision ------------------------------------------------------------------ Contents: ------------------------------------------------------------------ Role Playing DB -- A database package that creates and maintains a database of RPG characters, monsters, treasures, spells, and playing environments. Copyright (C) 1995,1998,1999 Robert Heller D/B/A Deepwoods Software 51 Locke Hill Road Wendell, MA 01379-9728 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. $Id: README,v 1.1 1999/07/13 19:13:24 heller Rel1 $ The Role Playing Database package consists of a collection of C++ classes that implement a series of structures that contain the various data entities that represent the various aspects and features used in a Role Playing Game, including the characters, monsters, spells, treasures, tricks, traps, etc. 1. Installing. If this archive contains a set of compatable shared libraries for your system (in the Lib sub-directory), you can install things using the INSTALL script. Just run this (with the proper priviledges) script. The default installation directory is under /usr/local, but the package can be installed anywhere. The INSTALL script prompts for three things: the directory prefix where the machine dependent files (the shared libraries and the startup scritpt, which contains this directory) are to go, the directory prefix where the machine independent files (the Tcl scripts, header file, documentation, and help files) are to go, and the path to the wish executable. It is possible to install this package such that the machine independent files are on a common (NFS) directory and several *different* sets of machine dependent files are installed in various machine dependent directories. If this archive does not contain a set of compatable shared libraries for you system, you will need to build these libraries. You will need a suitable C++ compiler (I used egcs-2.90.29 980515 (egcs-1.0.3 release) on my RedHat 5.2 system). First you need to run the configure script: ./configure The configure script *should* be able figure out everything it needs. It will look for some additional packages that you don't actually need: swig, doc++, latex/bibtex/makeindex/dvips, and dvidvi. You should not need things unless you modify things. It does need to find your tclsh binary and your tclConfig.sh file. Let me know if you have trouble with configure (see #4: In case of problems below). Then you need to make things: make You should be able to test things like this: (csh/tcsh) setenv LD_LIBRARY_PATH `pwd`/Lib setenv TCLLIBPATH "`pwd`/Lib `pwd`/Scripts" /usr/bin/wish Scripts/Main.tcl OR (sh/bash/ksh) export LD_LIBRARY_PATH=`pwd`/Lib export TCLLIBPATH="`pwd`/Lib `pwd`/Scripts" /usr/bin/wish Scripts/Main.tcl If the GUI comes up with no problems, you should me read to install. By default things are installed under /usr/local. This can be overriden with options passed to configure or on the make install command line: make prefix=/independent exec_prefix=/dependent install 2. Running. The GUI is started up by executable the start script, named 'RPG', in the machine dependent ../bin directory. There is on-line help available, as well as a user manual (in both PostScript and PDF format) in the ../doc directory. 3. Programming. The GUI is implemented with a series of Tcl/Tk scripts -- these scripts can be modified as needed, but be sure to keep a 'virgin' backup copy, in case there are problems. The low-level C++ code can also be linked into a C++ program of your own devising. There are three internals documents -- one for the class libraries, one for the Tcl <=> C++ interface module, and one for the Tcl/Tk scripts themselves. 4. In case of problems. If you have problems installing, building, running, or programming with this package, feel free to drop me an E-Mail at Robert Heller or visiting the RPGDB web site at http://www.deepsoft.com/RolePlayingDB/. There is an on-line bboard there -- your questions might in fact be already answered and on-line. 5. Full Contact information. Robert Heller D/B/A Deepwoods Software 51 Locke Hill Road Wendell, MA 01379 +1-978-544-6933 heller@deepsoft.com http://www.deepsoft.com/