tkHTML-3.2, May 9, 1997
(c)1994-1995 Liem Bahneman

 * Permission to use, copy, modify, and distribute this software
 * and its documentation for any purpose and without fee is granted
 * provided that the above copyright notice appears in all copies.
 * It s provided "as is" without express or implied warranty.

 * This application uses the Tix widget set by Ioi Kim Lam
 * tkHTML homepage: http://www.ssc.com/~roland/tkHTML/tkHTML.html

tkHTML 3.1 varies from tkHTML 2.0 greatly. It no longer has an internal 
previewer, instead it 'remote controls' Mosaic or Netscape. Also, it is no
longer a set of tck/tk/tix scripts, but a single, compilable binary! Thank
you Ioi!

See the ChangeLog for new features and changes. 

REQUIREMENTS

	tkHTML 3.1 requires Tcl7.6, Tk4.2 and Tix4.1.
	
	Tix is available at www.xpi.com

INSTALLING

Take a look at the Makefile, be sure that all the paths look correct. 
Any other locations than this may require a little bit of editing of 
tkHTML.tcl (tkhtmllibdir) so it finds this lib directory correctly.

Now, just type 'make' and 'make install' and you're set.


RUNNING

tkHTML now has the ability to load a file from the command line, instead 
of always having to load a file after starting:

% tkHTML foobar.html

Absolute and relative paths are ok. 

If there are any problems with paths being incorrect, just edit tkHTML to match
your paths, specifically "tkhtmllibdir".

CONFIGURING

tkHTML 2.*/3.* are much more flexible than 1.*, allowing for user-definable 
fonts and point sizes in the edit and preview windows. To have these set 
automatically, each time you run tkHTML, you may create a ~/.tkHTML 
file, which has the same format as config.tcl. Here you can set which 
font/point size you want and other items such as configuring an 
international keyboard. A user's .tkHTML will override the default config.tcl.

A user's .tkHTML should be updated with each upgrade of tkHTML, and users
will be alerted to this fact if an older one is detected.

PREVIEWING

The internal previewing has been removed, and previewing is now handled by
remote controlling NCSA Mosaic or Netscape.  You may also use any browser
that can load a file from the command line. Netscape 1.1b1 actually allows
you to remote control the application from another application, provided
the window is already active: (add to config.tcl or ~/.tkHTML)

    set previewer "netscape"
or 
    set previewer "mosaic"

Mosaic 2.4+ also allows you to specify an external editor, using X-defaults:
(add to .Xdefaults)
    
    Mosaic*EditCommand:          tkHTML
    Mosaic*EditCommandUseXterm:  false

Included is a perl script called "mosaic_url" which allows you to 
remote control Mosaic 2.5 as you can Netscape 1.1. This was given to me
by Tim McConnell and I have not tested it.

Please note that unless you are using Netscape 1.1b1's "remote" feature, a 
new window will be created each time you click on "Preview" in netscape.

============================
If you have any problems, questions or comments about tkHTML 3.1, which I'm 
sure you will, please send them to roland@cac.washington.edu. 

Special thanks to Heiko Jacobs <jacobs@ipf.bau-verm.uni-karlsruhe.de> 
for the Entities procedures, Brent McLeod <darkelf@netcom.com> for the
added Forms menum add Tom McConnell <tmcconne@sedona.intel.com> for the 
external browsing tips and perl script.



