README
1NAME
2
3 Tcl extension module for Perl5
4
5DESCRIPTION
6
7 The Tcl extension provides a small but complete interface into libtcl and
8any other Tcl-based library. It lets you create Tcl interpreters as perl5
9objects, execute Tcl code in those interpreters and so on. There is a Tcl::Tk
10extension (not to be confused with "native" perl5 Perl/Tk extension)
11distributed separately which provides a raw but complete interface to the
12whole of libtk via this Tcl extension.
13
14Using "tcl stubs", module could be built even without tcl-dev package
15installed on system. Still, tcl (or tcl/tk) must be installed during module
16build. --nousestubs also supported. Tcl versions 8.4, 8.5, 8.6 and above are
17supported.
18
19Build in the usual way for a perl extension:
20
21 perl Makefile.PL
22 make
23 make test
24 make install
25
26This will take reasonable defaults on your system and should be ok for most
27uses. In some rare cases you need to specify parameters to Makefile.PL, such
28as pointing non-standard locations of tcl/tk, etc. Use --help option to find
29out supported parameters to Makefile.PL:
30
31 perl Makefile.PL --help
32
33See License, Authors sections in Tcl.pm, or with 'perldoc Tcl' - once it
34is installed - to have acknowledged on this type of information.
35
36