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