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.: 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