+-----------------------------------------------------------------------
| Running tcl-9 on OpenBSD
+-----------------------------------------------------------------------

The OpenBSD port of the Tcl dynamic language was designed to balance
deriving the maximum value from the original software while keeping
any modifications to a minimum.

Install locations and file names differ from the default to enable
installing multiple versions of Tcl and Tk on OpenBSD without conflict.


Files and Directories
=====================

Tclsh and Wish
--------------
normally
/usr/local/lib/tclsh, /usr/local/lib/wish
now
/usr/local/bin/tclsh9, /usr/local/bin/wish9

Library files
-------------
scripts, encoding files, etc.
normally in
/usr/local/lib/tcl9.0, /usr/local/lib/tk9.0
now in
/usr/local/lib/tcl/tcl9, /usr/local/lib/tcl/tk9

Configuration Files
-------------------
tclConfig.sh, tkConfig.sh
normally in
/usr/local/lib
now in
/usr/local/lib/tcl/tcl9, /usr/local/lib/tcl/tk9

Pkg-config Names
----------------
normally
tcl, tk
now
tcl9, tk9

Header Files
------------
*.h
normally in
/usr/local/include
now in
/usr/local/include/tcl9, /usr/local/include/tk9

Manual Pages
------------
*.1, *.3, *.n
normally in
/usr/local/man
now in
/usr/local/lib/tcl/tcl9/man, /usr/local/lib/tcl/tk9/man

Demos
-----
*.tcl, *
normally in
/usr/local/lib/tk9.0/demos
now in
/usr/local/share/examples/tk9

Bundled Tcl Modules
-------------------
*.tm
normally in
/usr/local/lib/tcl9.0/...
now in
/usr/local/lib/tcl/tcl9/modules

Tcl Module Paths
----------------
normally
/usr/local/lib/tcl9.0/...
now
/usr/local/lib/tcl/modules/{85,86,9}

Manual Page Configuration
=========================
Adding the following lines to /etc/man.conf will enable man(1)
and related commands can find the Tcl and Tk manual pages.

manpath /usr/local/lib/tcl/tcl9/man
manpath /usr/local/lib/tcl/tk9/man

Tcl/Tk Resources
================
Newsgroup: nntp://comp.lang.tcl
Wiki:      http://wiki.tcl-lang.org
Tutorial:  http://www.tcl-lang.org/man/tcl8.5/tutorial/tcltutorial.html
Wikibook:  http://en.wikibooks.org/wiki/Programming:Tcl
Books:     The Tcl Programming Language: A Comprehensive Guide
             ISBN-13: 9798316640539
           Practical Programming in Tcl and Tk, 4th Edition
             ISBN: 0-13-038560-3
