+-----------------------------------------------------------------------
| Running tcl-8.6 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/tclsh8.6, /usr/local/bin/wish8.6

Library files
-------------
scripts, encoding files, etc.
normally in
/usr/local/lib/tcl8.6, /usr/local/lib/tk8.6
now in
/usr/local/lib/tcl/tcl8.6, /usr/local/lib/tcl/tk8.6

Configuration Files
-------------------
tclConfig.sh, tkConfig.sh
normally in
/usr/local/lib
now in
/usr/local/lib/tcl/tcl8.6, /usr/local/lib/tcl/tk8.6

Header Files
------------
*.h
normally in
/usr/local/include
now in
/usr/local/include/tcl8.6, /usr/local/include/tk8.6

Manual Pages
------------
*.1, *.3, *.n
normally in
/usr/local/man
now in
/usr/local/lib/tcl/tcl8.6/man, /usr/local/lib/tcl/tk8.6/man

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

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

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

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

manpath /usr/local/lib/tcl/tcl8.6/man
manpath /usr/local/lib/tcl/tk8.6/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
Book:      Practical Programming in Tcl and Tk, 4th Edition
           ISBN: 0-13-038560-3
