I Ching 0.3: an oracle for Tcl/Tk Copyright (C) 1997, 1998 T. Douglas Mast (mast@sabine.acs.psu.edu) Web Site: http://www.personal.psu.edu/tdm104/iching.html OVERVIEW ======== This program implements the I Ching oracle in the user's choice of a text-only Tcl interface or a graphical Tk interface. Features include hexagram calculation by a simulated coin method, determination of moving lines and the consequent secondary hexagram, and display of the primary and secondary hexagrams with texts for King Wan's interpretation (the judgement) and the Duke of Kau's commentary (the lines). The hexagram texts are from a new adaptation of James Legge's English translation of the I Ching. Distribution terms for the program and texts are given by the Gnu General Public License. If you find this program useful, if you wish to report any bugs, or (especially) if you can improve its implementation in any way, please write to me at the address above. INSTALLATION ============ Installation and usage of the Tcl/Tk I Ching should be simple. It has been written mainly on a Linux box with Unix-like systems in mind, but will also work (with some tweaking of path names etc.) on Windows and MacOS systems. 0. Preliminaries Unpackage the distribution. Just move the file iching01.tgz to the directory /usr/local/lib (or wherever you would prefer to install the iching-0.3 subdirectory), "gunzip iching03.tgz", and "tar xvf iching03.tar". 1. Unix platforms Edit the file "iching.tk" to add the correct paths for your Tcl/Tk interpreter (default is /usr/bin/wish) and the I Ching distribution ("ichingpath", default is /usr/local/lib/iching-0.3). You then can execute "iching.tk", or type "source iching.tk" from the wish prompt. A toplevel window, containing an appropriate non-random hexagram, comes up. Press the "throw" button to get a reading, and the primary and secondary (if any) hexagrams should come up in separate windows. The text windows can be navigated by cursor or scrollbar, and text can be selected as desired. For the text-only version of the oracle, go to the directory 'text-only' below the main iching-0.3 directory, and edit the file "iching.tcl" to add the correct paths for the Tcl interpreter (default /usr/local/bin/tclsh) and the text-only directory (default /usr/local/lib/iching-0.3/text-only). Then you can execute iching.tcl, or source it from a Tcl interpreter. Use of Tcl/Tk 8.0 or higher is strongly recommended. If you are using an earlier version, you may need to change the font declaration in iching.tk to "fixed" or another known font. For versions earlier than about 7.6/4.2, you may also need to call randomInit[pid] instead of randomInit[clock clicks]. See the comments in iching.tk and iching.tcl. 2. Non-unix platforms Installation procedures for Mac or Windows should be very similar, except that the files "iching.tk" and "iching.tcl" will probably not work as self-standing executables without some tweaking. The easiest way to run from one of these platforms may be to start wish (or tclsh, or sioux), cd to the directory where the primary iching files are located, and source the appropriate file (iching.tk or iching.tcl). Just be sure that the variable "ichingpath" is set correctly. For further details on how to use the I Ching, see the file "USAGE". ACKNOWLEDGMENTS ================ This program is a direct descendant of a partially-completed I Ching application written for Windows 3.x by Paul Kovitz. The file randutil.tcl contains routines taken from "Practical Programming in Tcl and Tk" by Brent B. Welch. I'm also indebted to many folks who have translated, interpreted, and programmed the I Ching. COPYING ======= 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, as the file COPYING. If not, you may obtain one from http://www.fsf.org or by writing to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. The hexagram texts, paraphrased from the I Ching translation by James Legge, are copyright (C) 1997, 1998 by T. Douglas Mast, and may be redistributed, modified or unmodified, only under the terms of the GNU General Public License. That is: use of those texts in another computer program is only permitted if that program is also distributed under the Gnu General Public License. The routines in the file "randutil.tcl" are distributed under terms described in the file Welch.Copyright.