README
1
2Klondike --- X-Window solitaire
3-------------------------------
4by John Heidemann <johnh@isi.edu>
5
6
7Executive Summary
8-----------------
9
10Klondike is a solitaire game for X11. It's strongly influenced
11by the user interface of Klondike for the Macintosh.
12
13Features of klondike include:
14 - time-based and Casino-style scoring
15 - persistent high score list
16 - on-line help
17
18See the "Release Notes" menu item for details about what's new in
19Klondike.
20
21
22Installation
23------------
24
25The quick answer to installation is to type:
26 ./configure
27 make install
28And then run /usr/local/games/klondike.
29
300. Install either wishx or the wish from Tk-4.1 (or later).
31 Standard Tcl/Tk is missing some features I need for Klondike,
32 so I originally wrote it using the extended features of TclX
33 (using wishx).
34
35 Wishx was great, but not nearly as widely available as
36 standard Tcl/Tk. After some detours (including a perl-5-based
37 tclx emulator) tcl picked up some of the missing functions
38 and I put together the rest.
39
401. Run "./configure". GNU configure will find wishx and build the
41 Makefile. By default klondike will install over the existing
42 version, or in /usr/local/games.
43
44 Klondike has two parts: the executable program,
45 some data files, and some man pages.
46 Unfortunately there are many reasonable ways to install
47 these for games. We try the best from these choices:
48
49 EXECUTABLE DATA MAN SYSTEM
50 P/games P/lib/games P/man Linux/RedHat
51 P/games P/share/games P/man FreeBSD
52 P/games P/games/lib P/man SunOS
53 P/bin P/lib P/man normal programs
54
55 (where P is first /usr/local and then /usr).
56
57 You can override installation in two ways, with --prefix=P
58 (which sets P), or with --bindir=BD, --datadir=DD, and --mandir=MD.
59
602. Run "make install" to do the installation.
61 You may need to run this as root if you're writing
62 to directories you don't own.
63
64
65Installation if you have TclPro
66-------------------------------
67
68Here's the text about how to build klondike using the TclPro tools
69(copied from their README and slightly reformatted):
70
71 UNIX Builds
72 -----------
73
74 In addition to the behavior from the original makefile, the new
75 makefile contains the following targets:
76
77 binary
78 Build the wrapped application by running TclPro
79 Compiler on the sources to generate .tbc
80 files, then running TclPro Wrapper to wrap the
81 application in a single binary, and then
82 placing it in a subdirectory called bin. The
83 executable result can be copied anywhere for
84 there.
85
86 binary-install
87 Build the wrapped application (using the
88 "binary" target) then install it using the
89 rules in the original makefile. The
90 difference here is that it does not need a
91 data directory (the CARDS subdirectory is
92 wrapped and SCORES is located in the same
93 directory as the wrapped executable). This
94 target also installs the UNIX man pages.
95
96 To build the UNIX makefile, see the README.klondike file.
97
98 Windows Builds
99 --------------
100
101 For Windows, the makefile.vc provides only one target. When
102 you build the application using "nmake -f makefile.vc", the
103 wrapped executable is called "klondike.exe" and can be copied
104 to any location on any Windows NT/95/98 machine and run from
105 its new location.
106
107(Thanks for the patches to make these tools work, Scriptics!)
108
109
110Updates
111-------
112
113The latest version of klondike can be found at
114<http://www.isi.edu/~johnh/SOFTWARE/JACOBY/index.html>.
115
116Various versions of this software have been tested by the author on
117SunOS 4.1, Solaris/x86 2.1, FreeBSD 2.0, and Linux/Slackware 2.x and
1183.0.
119
120
121Release Notes
122-------------
123
124This README file is $Id: README,v 1.14 1999/02/09 03:14:18 johnh Exp $.
125
126Klondike 1.1---The first network release.
127
128Klondike 1.4---Screen scaled for a 640x480 display, uses GNU configure.
129
130Klondike 1.5---Pwishx and Tk-4.0 support added.
131
132Klondike 1.6---Pwishx support removed; Tk-4.1 supported added.
133Accelerator support added to the menus.
134
135Klondike 1.7---Installation and copyright cleaned-up.
136
137Klondike 1.8 (April 1997)---Released as an RedHat Linux RPM and a
138FreeBSD package in addition to source. Works with Tcl-7.6, Tk-4.2,
139and mostly on PCs and Macs (although the installation may not). Menu
140accelerators supported.
141
142Klondike 1.9 (February 1999)---After nearly two years some new code.
143Scriptics was interested in using klondike as an example for how to
144wrap programs. Thanks to them for contributing some code and advice
145about the changes in this version:
146 - Klondike should now look better on non-Unix platforms, using
147native menubars and not using tk_bisque (ah...nostalgia).
148 - Makefile/configure support for TclPro wrapping tools.
149 - It now passes all of the TclPro debugger warnings.
150
151
152Ispell Words
153------------
154
155Ispell LocalWords: Klondike README Exp wishx Tcl Tk ftp berkeley tcl tk tclX
156Ispell LocalWords: POSIX klondike Ispell LocalWords Sager Casteel usr lib hier
157Ispell LocalWords: Los TclX perl FreeBSD Slackware isi Pwishx Pwish tclx html
158
159
160Credit
161------
162
163This program was written by John Heidemann, but it employs
164bitmaps from Gary Sager and text from Mike Casteel. Thanks
165to them for their contributions.
166
167Comments on klondike should be sent to:
168
169 -John Heidemann
170 <johnh@isi.edu>
171 Los Angeles, California
172
173 LocalWords: menubars TclPro RedHat bindir BD datadir DD mandir Macs Scriptics
174