GRAIL 0.3
===========

This is the final release of Grail version 0.3.  It should run on most
Unix systems, provided you have Python 1.4 with Tcl/Tk 7.6/4.2 (or
better).  It is only distributed in source form.

In this file:

	- Licensing issues
	- Installation
	- Using Grail
	- Web resources
	- Feedback
	- Epilogue


Licensing issues
----------------

The license of Grail 0.3 allows essentially unrestricted use and
redistribution.  The full text of the license can be found in the file
LICENSE in this directory.


Installation
------------

There are three steps to take before you can use Grail:

- Install Tcl 7.6 and Tk 4.2.  (You *may* be able to get away with
older versions up to 7.4/4.0; newer versions could be okay, too.)  You
can get it at http://www.sunlabs.com/research/tcl/; or try ftp to
ftp.sunlabs.com in directory /pub/tcl/.  See also the new commercial
Tcl/Tk site, http://sunscript.sun.com/.

- Install Python 1.4, configured for use with Tk.  The URL to get
Python is http://www.python.org; or try ftp to ftp.python.org in
directory /pub/python/src/.  You must enable Tk support by editing the
file Modules/Setup; see the comments in that file (search for
"tkinter").

- Install the Grail sources in a convenient place.  Grail is executed
directly from its source directory.  If you are using the /usr/local
hierarchy, the Grail sources could be installed in
/usr/local/lib/grail/.

You can also choose to leave grail.py unchanged and have a shell
script named "grail" which execs the Python interpreter, e.g.:

    exec python /usr/local/lib/grail/grail.py ${1+"$@"}


Using Grail
-----------

If the first line of the grail.py script points to a working Python
1.4 interpreter with Tk support, you should be able to start Grail by
executing "./grail.py" in the Grail source directory.  Grail figures
out where the source directory is by inspecting sys.argv[0], so in
fact typing the pathname to the script from anywhere should work.

Command line options:

The "-g <geometry>" option lets you specify an initial geometry for
the first browser window in the standard X11 geometry form:
[<width>x<height>][+<x>+<y>], where all dimensions are measured in
pixels.  It is also possible to set the width and height (in character
units) through the General preference panel.

The "-i" option inhibits loading of images for this session.
This option can also be set via the General preference panel.

The "-d <display>" option lets you override the $DISPLAY environment
variable.

Command line arguments:

The only positional command line argument is an optional URL of a page
to display initially.  This does not become your "home page"; use the
General preference panel to change the page loaded by the Home command
in the Go menu, and to choose whether this page should be loaded
initially if no URL is given on the command line.


Web resources
-------------

More information on using Grail 0.3 can be found through the Grail 0.3
home page, at this URL:

    http://grail.cnri.reston.va.us/grail/

This page is also accessible through the "Grail Home Page" item of the
Help menu.


Feedback
--------

Send all your feedback to the following email address:

    grail-feedback@python.org

Before reporting a bug, be sure to check the known bugs page first, at
this URL:

    http://grail.cnri.reston.va.us/grail-0.3/info/bugs.html

You are encouraged to subscribe to the Grail mailing list.  See this
URL:

    http://grail.cnri.reston.va.us/grail-0.3/info/mailinglist.html

(or send Majordomo commands to grail-request@python.org).


Epilogue
--------

"Everything should be made as simple as possible, but no simpler."
	--Albert Einstein

"Nothing is as simple as we hope it will be."
	--Jim Horning

"Simple is as simple does."
	--Forrest Gump
