INTRODUCTION
------------

This release contains html versions of the man pages for Tcl7.6 and 
Tk4.2.  Tcl source code for generating these html pages is included.

You will need a tables and forms enabled browser to view the cross-
reference files. Netscape is recommended.


FEATURES
--------

Formatting -- Complex man pages with deeply nested paragraphs and lists  
    are correctly formatted.  Tab formatted tables and listings are   
    correctly aligned.

Hyperlinks -- Most words and phrases that appear as bolded text in the man 
    pages are hyperlinked the appropriate html (man) page.  Links between 
    packages are supported.

Contents -- Table of contents files are formatted for easy selection.  The 
    contents listing appear as you would expect, i.e. in column order like  
    the 'ls' command under Unix. Entries that contain changes since the 
    release are marked with an asterick.

Change bars -- Text that is marked with vertical change bars in the right 
    margin of man pages appears as green text in the html pages.  (This 
    requires a brower, such as Netscape, that supports font coloring.)

Cross-reference -- An index built from the man page 'Keywords' section
    makes it easy to find html (man) pages by keyword. The cross-reference
    is forms based, making for fast loading and navigation.

Extensible -- Since the source script is included, a unified, fully 
    cross-linked set of man pages can be built that includes other
    Tcl related packages. This feature has not been tested, but it should 
    work if the packages follow the directory structure and man page 
    convensions of Tcl and Tk.


INSTALLING
----------

Use tar and gzip utilities to extract the files from Tcl-Tk_docs_v2.html.tar.gz.

On unix:
    gunzip Tcl-Tk_docs_v2.html.tar.gz
    tar -xvf Tcl-Tk_docs_v2.html.tar

On the Mac, the latest versions of Aladdin's StuffIt Expander 4.0.1 along
with their DropStuff with Expander Enhancer 4.0 will expand tar and gzip
files. Another option is to use the freeware programs MacGzip and tar. All
are available from Info-Mac, etc.:

    <ftp://mirrors.aol.com//pub/info-mac/cmp/stuffit-expander-401.hqx>
    <ftp://mirrors.aol.com//pub/info-mac/cmp/drop-stuff-with-ee-40.hqx>
    <ftp://mirrors.aol.com//pub/info-mac/cmp/mac-gzip-10.hqx>
    <ftp://mirrors.aol.com//pub/info-mac/cmp/tar-40b.hqx>


THE INSTALLATION
----------------

The top level directory (Tcl-Tk_docs) created from the archive contains 
six files:

    Contents.html -- root page of the Tcl/Tk html documentation. Point your 
	    browser at this file.

    README -- this file.

    xref -- directory containing the keyword cross-reference files.

    Tcl7.6 -- directory containing the Tcl html pages and the Tcl contents 
	    file.

    Tk4.2 -- directory containing the Tk html pages and the Tk contents file.

    src -- directory containing the Tcl source files for converting the man 
	    pages shipped with Tcl/Tk full releases.

Installed size is approximately 1.5 MB but will take more due to minimum 
files sizes. On my Mac's 250 MB drive, the installation is 2.1 MB.


TO DO
-----

Looking for ideas.


SUPPORT AND BUG REPORTS
-----------------------

The pages are believed to be correct, but I haven't checked every page. If 
you find formatting errors or bugs in the source files, please report them 
to me. I will do my best to correct the problem.


CREDITS
-------

Raymond Johnson at Sun provided an example tcl script and C program that 
converted man pages to Windows help file format.

Having Roger E. Critchlow Jr's html version of the man pages for an 
example was a big help.


Tom L. Davis
Texas Instruments, Inc.
tom-l-davis@ti.com
