1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/persistentdata/persistentstorage/sqlite3api/TEST/TCL/tcldistribution/win/README	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,93 @@
     1.4 +Tcl 8.4 for Windows
     1.5 +
     1.6 +RCS: @(#) $Id: README,v 1.30.2.1 2005/07/29 03:50:51 mdejong Exp $
     1.7 +
     1.8 +1. Introduction
     1.9 +---------------
    1.10 +
    1.11 +This is the directory where you configure and compile the Windows
    1.12 +version of Tcl.  This directory also contains source files for Tcl
    1.13 +that are specific to Microsoft Windows.
    1.14 +
    1.15 +The information in this file is maintained on the web at:
    1.16 +	http://www.tcl.tk/doc/howto/compile.html#win
    1.17 +
    1.18 +The above URL includes a lengthy discussion of compiler macros necessary
    1.19 +when compiling Tcl extensions that will be dynamically loaded.
    1.20 +
    1.21 +2. Compiling Tcl
    1.22 +----------------
    1.23 +
    1.24 +In order to compile Tcl for Windows, you need the following:
    1.25 +
    1.26 +	Tcl 8.4 Source Distribution (plus any patches)
    1.27 +
    1.28 +	and
    1.29 +
    1.30 +	Visual C++ 5 or newer
    1.31 +
    1.32 +	or
    1.33 +
    1.34 +	Msys + Mingw
    1.35 +
    1.36 +	http://prdownloads.sourceforge.net/tcl/msys_mingw8.zip
    1.37 +
    1.38 +	This Msys + Mingw download is the minimal environment
    1.39 +	needed to build Tcl/Tk under Windows. It includes a
    1.40 +	shell environment and gcc. The release is designed to
    1.41 +	make it as easy a possible to build Tcl/Tk. To install,
    1.42 +	you just download the zip file and extract the files
    1.43 +	into a directory. The README.TXT file describes how
    1.44 +	to launch the msys shell, you then run the configure
    1.45 +	script in the tcl/win directory.
    1.46 +
    1.47 +In practice, this release is built with Visual C++ 6.0 and the TEA
    1.48 +Makefile.
    1.49 +
    1.50 +If you are building with Visual C++, in the "win" subdirectory of the
    1.51 +source release, you will find "makefile.vc".  This is the makefile for
    1.52 +the Visual C++ compiler and uses the stock NMAKE tool.  Detailed
    1.53 +directions for using it, are in the comments of "makefile.vc".  A quick
    1.54 +example would be:
    1.55 +	C:\tcl_source\win\>nmake -f makefile.vc
    1.56 +
    1.57 +There is also a Developer Studio workspace and project file, too, if you
    1.58 +would like to use them.
    1.59 +
    1.60 +If you are building with Msys or Cygwin, you can use the configure script
    1.61 +that lives in the win subdirectory. The Msys or Cygwin based configure/build
    1.62 +process works just like the UNIX one, so you will want to refer to
    1.63 +../unix/README for available configure options. An error will be
    1.64 +generated by the configure script if you try to compile Tcl with
    1.65 +the Cygwin version of gcc instead of the Mingw version. Check your
    1.66 +PATH if you get this error. Be aware that gcc will generate
    1.67 +lots of compile time warnings when building Tcl. Warnings are
    1.68 +not errors, so please don't file a bug report about them.
    1.69 +
    1.70 +In order to use the binaries generated by these makefiles, you will
    1.71 +need to place the Tcl script library files someplace where Tcl can
    1.72 +find them.  Tcl looks in one of following places for the library files:
    1.73 +
    1.74 +	1) The path specified in the environment variable "TCL_LIBRARY".
    1.75 +
    1.76 +	2) Relative to the directory containing the current .exe.
    1.77 +	   Tcl will look for a directory "..\lib\tcl8.4" relative to the
    1.78 +	   directory containing the currently running .exe.
    1.79 +
    1.80 +Note that in order to run tclsh84.exe, you must ensure that tcl84.dll
    1.81 +and tclpip84.dll are on your path, in the system directory, or in the 
    1.82 +directory containing tclsh84.exe.
    1.83 +
    1.84 +Note: Tcl no longer provides support for Win32s.
    1.85 +
    1.86 +3. Test suite
    1.87 +-------------
    1.88 +
    1.89 +This distribution contains an extensive test suite for Tcl.  Some of
    1.90 +the tests are timing dependent and will fail from time to time.  If a
    1.91 +test is failing consistently, please send us a bug report with as much
    1.92 +detail as you can manage.  Please use the online database at
    1.93 +	http://tcl.sourceforge.net/
    1.94 +
    1.95 +In order to run the test suite, you build the "test" target using the
    1.96 +appropriate makefile for your compiler.