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.

