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

This release contains html versions of the man pages for Tcl8.0a1 and 
Tk8.0a1.  Tcl source code for generating these html pages is also included.

You will need a tables and forms enabled browser, such as Netscape, to 
view the cross-reference files.


FEATURES
--------

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

Hyperlinks -- Most words and phrases that appear as bolded text in the man 
    pages are hyperlinked to 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 change bars 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.


INSTALLING
----------

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

On unix:
    gunzip Tcl-Tk_docs_8.0a1.html.tar.gz
    tar -xvf Tcl-Tk_docs_8.0a1.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:

    README -- this file.

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

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

    Tcl8.0a1 -- directory containing the Tcl html pages and the Tcl contents 
        file.

    Tk8.0a1 -- 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.


CHANGES
-------

1. Widget options are now formatted with tables.

2. Fixed formatting problems associated with the clock.n page.

3. Improved formatting of the file.n page.



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
