WinTclTk

Tcl/Tk Distribution for Microsoft Windows

Latest release:

Branch	Version	Release date	Release notes
8.5 (stable)	8.5.6	31.03.2009	Release Notes

This is an open source Tcl/Tk distribution for 32-bit Microsoft Windows operating systems.
Target audience: Tcl/Tk and XOTcl development and training

For single-file executables from Tcl scripts, see TkWrap , a stand-alone Tcl/Tk wrapper and wish shell. Includes a single-file Tkcon console.

Main features:

• bundled dynamic object-oriented language XOTcl
• popular extensions tcllib, tklib and BWidget included
• XML processing support via tDOM package
• OpenSSL support via tls package
• SQL databases support for MySQL and PostgreSQL
• embeeded databases Metakit, SQLite and Tgdbm (GDBM)
• Tloona IDE Tcl editor with XOTcl and iTcl support
• Tkcon feature-rich Tk console
• XOTclIDE interactive development environment for XOTcl and Tcl (supports mysqltcl, pgtcl, Metakit and SQLite)

The distribution includes the following packages:

Package	Version	Notes
Tcl/Tk	8.5.6
BWidget	1.8.0	includes HTML documentation
Img	1.3	includes HTML documentation
incrTcl	3.4
memchan	2.2.1	includes HTML documentation
Metakit	2.4.9.7	includes HTML documentation
mkZiplib	1.0	includes HTML documentation
mysqltcl	3.03	includes HTML documentation
pgtcl	1.6.2	includes libpq.dll 8.3.7 with OpenSSL and POSIX threads, HTML docs
snack	2.2.10	includes HTML documentation
SQLite	3.6.11	includes HTML documentation
TclX	8.4
tcllib	1.11.1
Tcludp	1.0.8
TclVfs	1.3
tDOM	0.8.2	includes HTML documentation
Tgdbm	0.5
thread	2.6.5	includes HTML documentation
Tile	0.8.2	includes HTML documentation
Tkcon	2.5
Tkhtml	2.0	includes HTML documentation
tklib	0.5
Tktable	2.10	includes HTML documentation
Tktreectrl	2.2.8	includes HTML documentation
Tloona	1.3.2
tls	1.6	includes HTML documentation
Trf	2.1.3	includes HTML documentation
TWAPI	2.0.12	includes CHM documentation
Winico	0.6	includes HTML documentation
XOSql	0.61	includes HTML documentation
XOTcl	1.6.3	includes actiweb, HTML and PDF documentation
XOTclIDE	0.84	includes HTML documentation

The following support libraries are included:

Package	Version	Notes
Zlib	1.2.3	headers and libraries included
GDBM	1.8.3	headers and libraries included
OpenSSL	0.9.8k	headers and libraries included

Everything with exception of mysql and TWAPI (imported DLL’s) is compiled using the MinGW distribution with GCC 3.4.5 and stripped

Standalone wish shell and script wrapper: TkWrap

See the Project Homepage at SourceForge for source code and additional information. Martin Matuska
My Homepage

Tcl tk on windows

Download Tcl/Tk Sources

This page describes how to obtain a Tcl/Tk source release. See Binary distributions for obtaining pre-built binaries.

The main site for Tcl/Tk source distributions is SourceForge. The files are also available from ftp.tcl.tk or one of its mirrors.

The latest downloads for the Tcl 8.6 and 8.7 release sequences are shown in the table below. Older releases are also available from the above sites.

Tcl 8.6.11 Sources			Tk 8.6.11 Sources
tcl8.6.11-src.tar.gz	Gzip format	tk8.6.11.1-src.tar.gz	Gzip format
tcl8611-src.zip	Zip format	tk86111-src.zip	Zip format

Tcl 8.7a3 Sources			Tk 8.7a3 Sources
tcl8.7a3-src.tar.gz	Gzip format	tk8.7a3-src.tar.gz	Gzip format
tcl87a3-src.zip	Zip format	tk87a3-src.zip	Zip format

The source releases include make files for Windows, Unix and Xcode project files for Mac OS X.

Unix (including Mac OS X)

You’ll want both Tcl and Tk sources; choose the gzipped tar format. The files listed under the Windows sources contain the same information but are in ZIP format.

Gzip’ed Tar Files

Extract gzip’ed archives with this UNIX command line:

Windows

If you have downloaded the Unix version of these files, there is no need to also download these versions since these files are identical but in ZIP format instead of compressed tar.

Tcl tk on windows

There are several options available for obtaining Tcl/Tk. These are listed below.

Operating System Packages

Most Unix / Linux operating system distributions, as well as Mac OS X, include Tcl/Tk. If not already installed, you can use your system’s package manager to install the appropriate packages. For example, on a Debian system, you can type

to install Tcl. Note than some components, even including Tk, man pages and C libraries may be separate packages and installed in a similar manner.

To check the version installed, start Tcl/Tk (usually via running «tclsh» or «wish» from a command line), and typing

This will tell you what version you’re running.

If you do not have privileges to install software or if you need a newer version than the one provided by the system, you may use one of the alternative means of obtaining Tcl as described below.

Binary Distributions

Pre-built Tcl distributions for many common platforms are available for download. These include both traditional installers as well as single file «download and run» executables. See Binary distributions.

Source Distributions

Finally, you always have the option of downloading the Tcl/Tk source distributions and building it yourself. See Source distributions for instructions on downloading and compiling.

Related Software

A very large number of libraries and extensions are available for Tcl/Tk. The most popular and commonly used ones are catalogued in the Great Unified Tcl/Tk Extension Repository. (In other words, get them from the GUTTER.) The Tcler’s Wiki is an alternate, but uncategorized, resource for the same.

License Information

Tcl/Tk is open source (based on a BSD-style license), so you can use it and modify it virtually any way you want, including for commercial uses. Here is the Tcl source distribution license, but be sure to check the license for any particular distribution you use.

Tcl on Windows FAQ (2015-05-09)

Table of Contents

1 About this FAQ

This FAQ is targeted towards using Tcl on Windows. Specifically, it addresses the two most recent releases of Tcl (8.5, 8.6) on Windows 2000 or later. Some examples will not work with older versions of Tcl.

The FAQ does not address general Tcl platform-independent features. Nor does it address questions related to the graphical toolkit Tk.

2 About Tcl

2.1 What is Tcl and why should I learn it?

Tcl is a high-level dynamic language that runs on a wide variety of platforms, from mainstream operating systems like Unix/Linux, Windows and MacOS to embedded systesm like Cisco routers. Code written on one platform will run practically unchanged on another. Tcl’s simple but powerful and expressive nature make it suitable for applications ranging from customized systems administration utilities to standalone desktop applications to scalable, distributed servers.

2.2 What is Tk ?

Tk is a toolkit for building cross-platform graphical user interfaces. Although bindings exist for other languages such as Perl and Python, it was originally built as a complement to Tcl and has the tightest binding to that language. Hence, the two are most commonly refered together as Tcl/Tk. This FAQ focuses only on Tcl and does NOT address Tk-related questions.

2.3 What Windows platforms does Tcl support ?

The current release of Tcl, Version 8.6, requires Windows XP or later. The previous release, version 8.5, also supports Windows Windows 2000. Earlier versions of Windows, Windows NT 4.0 and the Windows 98 series, require Tcl 8.4 and are not covered by this FAQ.

2.4 Why should I use Tcl instead of VBScript or PowerShell?

There are several reasons why you might want to use Tcl instead of PowerShell or VBScript for scripting tasks on Windows. First, Tcl deployment is simple, with the option of a single executable distribution that includes your scripts and with no external dependencies. This allows deployment even to systems such as Windows 2008 Server Core which did not support PowerShell due to its dependence on the .NET framework. Second, because of its use of native Windows interfaces, Tcl is lightweight and efficient in use of system resources including CPU, memory and disk. Third, generic scripts such as for XML processing, will run on non-Windows platforms without any modifications.

2.5 Why should I use Tcl instead of C#/C++/VB.Net

Simply put, it’s all about minding your P’s and Q’s:

• Productivity — Tcl’s dynamic nature, expressiveness and high level constructs greatly increase programming productivity with shorter development cycles and greater robustness.
• Portability — large portions of your code base, and even entire applications are portable to other platforms with minimal effort.
• Quality — By freeing programmers from low level details Tcl allows them to focus on application logic and architecture. It facilitates incremental development where test case generation fits naturally with writing code.

2.6 When should I not use Tcl on Windows?

There are a few types of applications for which Tcl is not an ideal fit. In particular, applications with sophisticated graphics or printing needs are not good candidates for Tcl. Nevertheless, note Tcl can still be used productively in such applications as the «glue» language that drives and automates the core application engine. For example, Tcl is the de facto standard for scripting in the commercial CAD world even though the core applications are in C++.

2.7 How is Tcl licensed? Can I use it in commercial applications?

Tcl is covered under the very liberal open source BSD license. This means Tcl and its associated libraries can be used in all applications, including commercial ones.

2.8 Where can I find documentation for Tcl?

The reference documentation for all Tcl versions can be downloaded or browsed on-line at http://www.tcl.tk/man. The ActiveState distribution also contains a Windows Help CHM file that includes not only the core documentation but also documentation for various extensions and libraries. A standalone CHM help file, with similar content, is available from the TWAPI download area.

2.9 Is there a Tcl tutorial?

See the online Tcl tutorial. In addition, the Tcler’s Wiki provides tutorials, explanations and sample code in all areas. It is also an excellent jump point to the various Tcl resources on the net.

2.10 Where can I get help on Tcl?

You can get questions answered on the comp.lang.tcl newsgroup or the #tcl channel on irc.freenode.net. Commercial support is available from ActiveState.

3 Installing Tcl

3.1 What Tcl distributions are available for Windows?

There are several freely downloadable binary distributions of Tcl available:

• The most commonly used distribution for Tcl is from ActiveState which provides both free and commercially supported editions of their Tcl package for multiple platforms. These distributions include libraries and extensions in addition to the Tcl core.
• The Tcl SourceForge download area contains Tcl distributions for multiple platforms but does not include extensions and libraries.
• The KitCreator site provides customisable Tcl distributions for download which can optionally include other libraries and extensions. The site also provides pre-built executables.
• Builds of daily snapshots are available from Pat Thoyt’s site. These are single file executables.

3.2 Are there any single-executable distributions of Tcl?

There are several distributions of Tcl that consist of a single executable file. These distributions also support binding your applications scripts within the executable so that your entire application itself can be distributed as a single executable. The most commonly used ones are tclkit and freewrap . You can also create your own versions from the KitCreator site.

Pre-built executables are available from rkeene.org or the TWAPI download area.

4 General Usage

4.1 What are tclsh and wish ?

Windows distinguishes between console mode and graphical interface programs. Tcl distributions correspondingly come with two different programs, tclsh.exe and wish.exe . The former is used for scripts that run in console mode and the latter for applications with a graphical user interface, generally based on Tk.

Depending on the actual Tcl distribution being used, the executables may be named differently, for example tclsh86t.exe and wish86t.exe .

4.2 How do I run Tcl in interactive mode?

To run the Tcl interpreter, so that you can interactively invoke Tcl commands, simply type in the name of the appropriate executable. This will display a Tcl shell prompt where you can type in commands.

4.3 How do I run a Tcl script from the command line?

To run a console script, invoke the tclsh.exe program, passing it the path to the script file. Any additional arguments on the command line are passed as a list to the script in the argv global variable.

We can invoke this script from the command line:

4.4 How can I associate a Tcl script with the Tcl interpreter application?

Windows can associate a file with an application so that typing the name of the file will result in the application being invoked. During its install, the ActiveState distribution gives the user the option to associate files ending in .tcl with the wish graphical Tcl shell. If you are not using this distribution, or you want to associate the .tcl extension with tclsh instead, you can change the association from the File Types tab in the Folder Options dialog in Explorer.

In addition, if you want to run the script from the command line simply by typing its name, add the extension to the PATHEXT environment variable.

You may wish to associate separate extensions, for example .tcl and .tk , depending on whether you want the script invoked with tclsh or wish .

4.5 How can I invoke a Tcl script from Explorer?

In order to run a Tcl script by double-clicking the script file, the file type must be associated with the Tcl shell. See the previous entry in this FAQ.

4.6 How can I embed a Tcl script in a batch file?

As an alternative to making .tcl files directly executable, you may prefer to make scripts executable by embedding them in batch files. For example, assume printargs.bat is somewhere in your PATH and contains the following:

Invoking the file:

See an explanation of the above and more sophisticated versions in the Tcl wiki.

4.7 How can I have Tcl always execute a certain set of commands on starting?

On startup, tclsh.exe reads and executes commands in the file tclshrc.tl in the user’s home directory. The user’s home directory is given by the environment variable USERPROFILE or can be displayed with the Tcl command

4.8 When should I use a Tcl extension versus an external program?

Some tasks can be accomplished from Tcl by invoking external programs or through the use of a Tcl extension (example). If you are writing a one-off script with limited use or the command is rarely invoked, using an external program might be sufficient. In other cases, use of an extension is likely to be beneficial. It is generally much faster and also protects against the external program not being available or installed on the target system (this is true even for Windows components) and differences arising from localization.

5 General Windows programming

5.1 How can I access the Windows registry?

Tcl provides the registry command for doing various operations on the Windows registry. You will need to load the registry package first:

5.2 How can I get system information?

The Tcl global array tcl_platform provides basic information about the system such as the operating system, version number etc. Additional information is provided in the Windows environment variables which can be accessed via the global env array. For more extensive details, use the osinfo module in the TWAPI extension.

5.3 How can I print from a script?

The TkPrint or Printer extensions may be used for printing under Windows.

6 Processes

6.1 How can I start a new process?

Tcl provides the exec command for starting new processes. The command supports pipes with multiple subprocesses, I/O redirection and background processes. The following commands all start a copy of notepad:

Line 1 assumes notepad.exe is in a directory in your PATH environment variable. Line 2 explicitly specifies the path to the program. Line 3 makes use of the auto_execok command which returns the full command line required for invocation filling in the path, extension if missing as well as checking for cmd.exe built-in commands.

Line 1 returns the path to notepad.exe . Line 3 returns the command line to invoke an internal cmd.exe command.

For additional control over the child process, such as its display properties, security attributes, priority etc., use the create_process command from the TWAPI extension.

6.2 How can I read from and write to a child process?

Use the Tcl open command to open a pipe by prefixing the child process command line with a | character. Then read and write using the standard Tcl I/O commands puts . gets , read etc.

6.3 How can I launch a document or URL?

To start up an application associated with a file or URL, invoke the Windows cmd.exe internal start command. For example,

Alternatively, see the next entry.

6.4 How can I invoke an action, like print, on a document?

The Windows Explorer Shell associates certain actions that can be carried out on a document based on its file type. These actions, such as Open , Edit , Print can be invoked from the right-click menu in Explorer. To invoke the action using Tcl, use the shell_execute command from the TWAPI extension.

The following will use the default action Open to start editing the file with Microsoft Word.

To print the file:

To compose an email message:

6.5 How can I start a privileged process under UAC?

Windows Vista and later versions implement User Account Control (UAC) under which even processes belonging to privileged accounts run with reduced privileges unless explicitly elevated by the user. To start a process in elevated mode, use the shell_execute command from the TWAPI extension with the runas action.

6.6 How can I terminate a process?

The TWAPI extension provides the end_process command for this purpose.

As an alternative, you can invoke the Windows command line program taskkill.exe using Tcl’s exec command to terminate a process by its PID or name.

6.7 How can I write a Windows service using Tcl?

There are several options for running a Tcl script as a Windows service:

• The TWAPI extension’s run_as_service command. The online book chapter Windows Services provides a detailed guide to writing and managing services using TWAPI .
• ActiveState’s Tcl Development Kit provides a tool to wrap a Tcl script as a Windows service
• Generic programs such as Firedaemon and winserv can also be used to run a Tcl script as a Windows service by spawning tclsh.exe as a child process.

7 Files and Disks

7.1 What file path separator should I in Tcl?

Like the Windows kernel (as opposed to the Windows DOS command prompt), Tcl will accept either / or \ as a directory separator in a file path. However, like in other languages such as C, \ is also used in Tcl syntax to indicate an escape sequence. Hence when used in a literal it needs to be doubled:

In some cases, such as executing an external program that expects \ as the directory separator, you can use the file nativename command to convert a path:

7.2 How can I get a list of drives in the system?

Use Tcl’s file volumes command.

7.3 How can I access files on remote shares?

Tcl understands UNC names of the form \\SERVER\SHARE\some\file so the standard Tcl I/O commands can be used to open and access files on remote shares.

7.4 How can I monitor changes to the file system?

You can either use the Tcl glob command to read a directory and poll for changes or use the TWAPI extension as shown in the session below. Both methods have their advantages and disadvantages. Polling can be expensive as the entire directory tree has to be read and compared. The TWAPI method uses Windows notification as and when changes occur and has filtering options. On the other hand, notifications are not guaranteed to be delivered under load. Reliability is particularly an issue with remote file systems. You may wish to use a combination of the two methods depending on the application.

The sample below illustrates use of TWAPI ‘s begin_filesystem_monitor command:

This command will print a line whenever an executable ( .exe or .dll ) is written to anywhere under the Windows directory. The vwait command is required in this small example as notifications require the Tcl event loop to be running.

7.5 How can I get device notifications such as CD or pen drive insertion?

Use the TWAPI extension as shown in the session below. (IMPORTANT: The example assumes the Tcl event loop is running which is required for receiving notifications.)

The twapi::start_device_notifier command on Line 2 is used to receive notifications of new volumes including USB pen drives, CD insertion and network shares. It invokes the supplied callback whenever a device volume change event occurs. The callback can filter for the events of interest based on the parameter supplied to it. For example, the above console session shows the insertion and removal of a USB pen drive (Lines 6 and 8) followed by the removal and insertion of a new CD (Lines 10 and 11). The mediachange attribute indicates that the event is only a change of CD media as opposed to a new CD-ROM device.

7.6 How can I access Microsoft structured storage?

The tclstorage extension provides access to Microsoft’s structured storage format.

8 Windows Shell and Desktop

8.1 How can I create desktop shortcuts?

Use the write_shortcut command of the TWAPI extension to create shortcuts. The code below will create a shortcut on the desktop to notepad.exe .

For URL shortcuts, use the write_url_shortcut command from TWAPI .

8.2 How can I register a hotkey to invoke a script?

Windows hotkeys are a means to invoke actions in an application irrespective of which application has the keyboard focus. Run the example below in a DOS window. Ctrl-Alt-F11 will start a copy of notepad no matter which application has the foreground. Ctrl-Alt-F12 will stop the script.

8.3 How can I play audio files?

The Snack extension is a complete and powerful cross-platform package for audio generation, playback, recording and analysis. See the Snack tutorial for examples.

For very basic needs, TWAPI has a module that can play WAV files and system sounds.

8.4 How can I copy and paste text to the clipboard?

If you are also using Tk, use the clipboard command to read and write the clipboard. If you are not using Tk, or you need a format that is not supported by the clipboard command, use the read_clipboard_text and write_clipboard_text commands from TWAPI as shown in the next entry.

8.5 How can I copy and paste formatted or binary data ?

If data you are copying and pasting is not plain text, use the read_clipboard and write_clipboard commands from TWAPI .

The example session below gets HTML format data from the clipboard.

Since HTML format is not a standard predefined clipboard format, Line 2 of the example first gets the format identifier associated with it. Note also the difference in results with the read_clipboard command on Line 4 and the read_clipboard_text command on Line 13.

9 Interoperating with other applications

9.1 How can Tcl communicate with other applications using DDE?

Tcl’s built-in dde package allows Tcl scripts to act as a DDE client or server. However, DDE is a legacy technology and you should use COM interfaces instead wherever possible.

9.2 How can Tcl act as a COM client?

Several extensions support COM client access from Tcl.

• The TCOM extension (32-bit only)
• The Optcl extension (32-bit only)
• The COM module of the TWAPI extension (32- and 64-bit)

The online book chapter The Component Object Model provides a detailed guide to using the COM module from TWAPI .

9.3 How can Tcl act as a COM server?

All of the above packages can be used to implement COM components.

9.4 How can I automate Internet Explorer with Tcl?

Automation of IE using COM is done by creating an instance using the PROGID InternetExplorer.Application and calling methods on it. You can find documentation on MSDN. Here is an example using TWAPI .

For a TCOM example, see the Wiki article at http://wiki.tcl.tk/29255.

9.5 How can I integrate with Microsoft Office?

Automation or integration with Office can be accomplished using any of the COM extensions mentioned above. For documentation on the objects and methods exposed by Office, follow the links on the Office developer page.

The CAWT package provides a high level Tcl API over COM to interact with Microsoft Office.

9.6 How can SQL Server and other databases be accessed from Tcl?

The tdbc package shipped as part of the core Tcl 8.6 distribution includes drivers for various database implementations as well as an ODBC connector. In addition to the reference pages in the Tcl documentation, an online introduction is available.

10 System Administration

10.1 How can I manage user accounts?

The TWAPI extension provides several commands related to user and group account management.

You can also use the Active Directory interfaces for this purpose.

10.2 How can I access Active Directory with Tcl?

You can work with Active Directory via the LDAP module in the tcllib package library, or via the Active Directory Service Interface (ADSI) through one of the Tcl COM extensions.

10.3 How can I use WMI for system management?

Like ADSI, Windows Management Instrumentation (WMI) also provides a scriptable interface via COM which is documented on the MSDN WMI Reference site.

The online book chapter Windows Management Instrumentation provides a detailed guide to accessing WMI from Tcl. Additional examples are on the TWAPI and WMI wiki page.

10.4 How can I check if an application or hotfix is installed?

The Windows Installer database can be accessed using either WMI or the Windows Installer COM object. Either method requires one of the Tcl COM extensions. The example below checks for a specific hotfix.

10.5 How can I read and write the event log?

Use the Windows event log module from the TWAPI extension. Here is an example to dump the Application event log to the console:

11 Interoperability with .Net

11.1 Is there a .NET version of Tcl?

Eagle is an implementation of the Tcl scripting language for the .Net Common Language Runtime (CLR). It is fully interoperable with other .Net languages and components.

11.2 How can I call .NET components from Tcl?

The Garuda extension provides support for calling .Net components from Tcl.

12 Networking and Communications

12.1 How can I communicate over the network?

The Tcl socket command creates a TCP/IP socket that can be used with the standard Tcl I/O commands such as read and puts .

12.2 How can I communicate over named pipes and why would I want to?

Use TWAPI ‘s namedpipe_server or namedpipe_client commands. These create a Tcl channel that can be used with the standard Tcl I/O commands. Named pipes are not advised over wide area network connections for performance reasons. In local environments, their primary benefit is that they provide an easy means for access control and authentication.

12.3 How can I communicate over serial ports?

Tcl’s open command can be used to open a serial port. For example,

For ports with number greater than 9, the UNC syntax must be used instead, for example \\.\COM10 .

Note the \ is doubled in the command as it is the escape character in Tcl syntax.

Once open, the standard Tcl I/O commands can be used to read and write to the port.

12.4 How can I download a file or a Web page?

Tcl comes with a standard package http

Packages for other protocols, like FTP, are available in tcllib.

The TclCurl extension provides an interface to the libcurl library for many more protocols and options.

12.5 How can I get better networking performance?

Tcl’s built in socket cross-platform implementation is sufficient for the majority of applications. In some cases where maximum performance and capacity is desired, the iocpsock extension provides an interface based on Windows I/O completion ports. Except for the socket creation command, the extension is fully compatible with Tcl’s I/O commands so it is even possible to choose between it and the Tcl socket command at run time.

12.6 How do I secure my connections with SSL/TLS?

You have the option of using the TLS extension or the tls_socket command from the TWAPI extension. The latter integrates with the Windows certificate store.

13 Security

13.1 How do I control access to a file or other resource?

The twapi_security module in the TWAPI extension implements a complete set of commands for manipulating access control lists for files and other resources. The Access Control section in the online book chapter Windows Security describes use of these commands.

Alternatively, you can also use the Tcl `exec` command to run the cacls.exe program that is included with Windows passing it appropriate parameters.

13.2 How do I manage certificates?

The pki module in tcllib provides portable commands for certificate creation and validation. The twapi_crypto module in the TWAPI extension also provides similar functionality as well integration with the Windows certificate store. The primary advantage of the integration is automatic updates of root certificates and revocation lists.

14 Building Tcl for Windows

14.1 Where can I get the Tcl source code?

The source code for the public releases of Tcl can be obtained from the SourceForge Tcl download area at http://sourceforge.net/projects/tcl/files/Tcl/. Extract the zip file to wherever you want to do the build. Depending on the tool chain you will use to build Tcl, it is advisable to not have spaces in the path.

To get the current development snapshot of Tcl, you can check out sources from the Tcl source repository at http://core.tcl.tk with a mirror at http://mirror1.tcl.tk. It is maintained using a distributed revision control system called fossil , binaries for which can be downloaded from http://www.fossil-scm.org/download.html. Detailed instructions for working with the Tcl repository are at http://wiki.tcl.tk/28126.

Note: Do not place the sources in a path that has spaces in it. Some of the compiler tools have problems with such paths. If necessary, you can use the DOS subst command to assign a drive letter to the path in order to hide the spaces.

14.2 Which compiler should I use to build Tcl ?

There are several tool chain options for building Tcl for Windows.

• Building with Visual C++ 6.0, as opposed to a newer Visual Studio version, has the advantage that the associated runtime library msvcrt.dll is pre-installed on every Windows system and does not have to be shipped with your Tcl distribution. However, the compiler is not free.
• Building with the Microsoft SDK compilers requires that the compiler runtimes be redistributed. But the compilers themselves are free.
• Building with the open source MinGW tool chain based on gcc also does not require redistributing runtime libraries as it uses msvcrt.dll . Setup is a little more complicated.
• The compilers in newer versions of Visual Studio are identical to the free SDK compilers so not much is to be gained from using these commercial versions.

14.3 How do I build Tcl using Visual C++?

The file win\makefile.vc in the win directory is used to build Tcl using Microsoft’s compilers. The build process automatically figures out what version of the compiler is being used.

Note Visual C++ 6.0 can only build the 32 bit version of Tcl.

There are several options that can be passed to makefile.vc . See the top of the file for instructions. The sample below illustrates most common usage.

The last step is only necessary to install the binaries on the build system or to create a distribution.

Note this only builds Tcl, and not the Tk library. If you want to build the Tk library as well, you need the February 2003 version of the SDK since Visual C++ 6.0 does not contain the required libraries for theming support. Later versions of the SDK will not do as they are not compatible with Visual C++ 6.0. The environment has to be set up so that the SDK headers and libraries appear before the Visual C++ ones. The following assumes the Tcl and Tk distributions are side-by-side in directories called tcl and tk .

14.4 How do I build Tcl using the free Windows SDK compiler?

The procedure for building using the Windows SDK compilers is similar to that for Visual C++ 6.0. See that entry for an overview. The procedure below is specified for Windows SDK 7.0 but will be similar for other SDK versions.

First, start a DOS command window to set up the build environment. Note certain cmd.exe command extensions have to be enabled for the SDK setup command file. Therefore, either start the command shell from the Start->All Programs->Microsoft Windows SDK v7.0->CMD shell menu or at the DOS command prompt, start a new shell by typing

Then, at the command shell prompt, type the following to build 32-bit Tcl:

Alternatively, for 64-bit Tcl, set up for a 64-bit tool chain:

Then to build Tcl and Tk,

This will build 32 or 64-bit Tcl depending on how the environment was set up.

Note this procedure can be used for cross-building 64-bit Tcl from a 32-bit system and vice versa.

15 Tcl packages and extensions

15.1 Tcllib

Tcllib is a collection of cross-platform Tcl packages that cover a large number of areas from text processing, mathematical algorithms, data structures, parsing, data structures, HTML and XML, networking, automata and more. It is available from http://tcllib.sourceforge.net.

15.2 Tcl for Windows API (TWAPI)

The TWAPI extension includes modules that cover a broad cross-section of the Windows API. It is available at http://twapi.sourceforge.net.

15.3 Snack Sound Toolkit

The Snack extension is a complete and powerful cross-platform package for audio generation, playback, recording and analysis. It is available at http://www.speech.kth.se/snack/.

15.4 TCOM

The TCOM extension provides support for both COM client and server access from Tcl. It is available from http://www.vex.net/

cthuang/tcom/. Although stable, it is not under active development and there is no 64-bit version available.

15.5 Optcl

The Optcl extension supports COM client and server access and also support for hosting ActiveX controls. It is available at http://www.patthoyts.tk/programming/optcl3010.zip. Like TCOM, it is not under active development and no 64-bit version is available.

15.6 CAWT

The CAWT (COM Automation With Tcl) package (formerly TcomOffice) provides high level interfaces to Microsoft Office (Excel, Word, Powerpoint), Internet Explorer, Matlab and Google Earth. It is available at http://www.posoft.de/html/extCawt.html.

15.7 iocpsock

The iocpsock extension provides a higher performance socket interface using I/O completion ports. It is available from http://sourceforge.net/projects/iocpsock.

15.8 TkPrint

The TkPrint extension provides commands for printing. It is available at http://pages.videotron.com/cclients/files/tkprint1.1.html.

15.9 Gdi and Printer

The Gdi and Printer extensions contain commands to interface to the Win32 GDI and printing API’s.