util/src/TclTk/tcl8.6.12/win/README

   1 Tcl 8.6 for Windows
   2
   3 1. Introduction
   4 ---------------
   5
   6 This is the directory where you configure and compile the Windows
   7 version of Tcl.  This directory also contains source files for Tcl
   8 that are specific to Microsoft Windows.
   9
  10 The information in this file is maintained on the web at:
  11
  12         https://www.tcl-lang.org/doc/howto/compile.html#win
  13
  14 2. Compiling Tcl
  15 ----------------
  16
  17 In order to compile Tcl for Windows, you need the following:
  18
  19         Tcl 8.6 Source Distribution (plus any patches)
  20
  21         and
  22
  23         Visual C++ 6 or newer
  24
  25         or
  26
  27         Linux + MinGW-w64 [http://mingw-w64.sourceforge.net/]
  28             (win32 or win64)
  29
  30         or
  31
  32         Cygwin + MinGW-w64 [https://cygwin.com/install.html]
  33             (win32 or win64)
  34
  35         or
  36
  37         Darwin + MinGW-w64 [http://mingw-w64.sourceforge.net/]
  38             (win32 or win64)
  39
  40         or
  41
  42         Msys + MinGW-w64 [http://mingw-w64.sourceforge.net/]
  43             (win32 or win64)
  44
  45
  46 In practice, this release is built with Visual C++ 6.0 and the TEA
  47 Makefile.
  48
  49 If you are building with Visual C++, in the "win" subdirectory of the
  50 source release, you will find "makefile.vc".  This is the makefile for the
  51 Visual C++ compiler and uses the stock NMAKE tool.  Detailed directions for
  52 using it, are in the comments of "makefile.vc".  A quick example would be:
  53
  54         C:\tcl_source\win\>nmake -f makefile.vc
  55
  56 There is also a Developer Studio workspace and project file, too, if you
  57 would like to use them.
  58
  59 If you are building with Linux, Cygwin or Msys, you can use the configure
  60 script that lives in the win subdirectory. The Linux/Cygwin/Msys based
  61 configure/build process works just like the UNIX one, so you will want
  62 to refer to ../unix/README for available configure options.
  63
  64 If you want 64-bit executables (x86_64), you need to configure using
  65 the --enable-64bit option. Make sure that the x86_64-w64-mingw32
  66 compiler is present. For Cygwin this compiler can be found in the
  67 "mingw64-x86_64-gcc-core" package, which can be installed through
  68 the normal Cygwin install process. If you only want 32-bit executables,
  69 the "mingw64-i686-gcc-core" package is what you need. For Linux, Darwin
  70 and Msys, you can download a suitable win32 or win64 compiler from
  71 [https://sourceforge.net/projects/mingw-w64/files/]
  72
  73 Use the Makefile "install" target to install Tcl.  It will install it
  74 according to the prefix options you provided in the correct directory
  75 structure.
  76
  77 Note that in order to run tclsh86.exe, you must ensure that tcl86.dll is
  78 on your path, in the system directory, or in the directory containing
  79 tclsh86.exe.
  80
  81 Note: Tcl no longer provides support for Win32s.
  82
  83 3. Test suite
  84 -------------
  85
  86 This distribution contains an extensive test suite for Tcl.  Some of the
  87 tests are timing dependent and will fail from time to time.  If a test is
  88 failing consistently, please send us a bug report with as much detail as
  89 you can manage to our tracker:
  90
  91         https://core.tcl-lang.org/tcl/reportlist
  92
  93 In order to run the test suite, you build the "test" target using the
  94 appropriate makefile for your compiler.