1                    Building TclX on Windows 95/NT
2
3This has not been updated for TclX 8.4.
4
5The Win32 port of TclX is a work in progress, and is not yet complete.
6Several features that should work under Windows are not yet ported.
7Many of the tests have not yet been converted to work under Windows,
8either.
9
10TclX on Windows is available in the ActiveTcl binary distribution:
11
12     http://www.activestate.com/Tcl
13
14To build the release:
15
16   o You need Visual C++ 4.0 or above.
17     
18   o Tcl 8.4 should be in a directory adjacent to the tclX8.4 directory or
19     the paths in common.vc need to be changed.
20
21
22MICROSOFT VISUAL C++ BUILD
23
24   o Edit tclX8.4/win/common.vc to set the macro TOOLS32 to the path to the
25     install directory for MS Visual C++ 4.o.  By default, this is c:\msdev.
26
27   o Edit tclX8.4/win/common.vc to set the macro PREFIX to the location
28     you want TclX installed.  This PREFIX's parent directory must exist, all
29     other directories, including PREFIX will be built if they don't exist.
30     The resulting directories that will be used for installation are:
31        $(PREFIX)/bin - Executables and DLLs.
32        $(PREFIX)/lib/tclX8.4 - Runtime Tcl code and help files for TclX.
33        $(PREFIX)/include - Include files.
34
35   o To compile, cd to tclX8.4/win and enter the command:
36
37        nmake -f makefile.vc
38
39   o To run the TclX tests:
40
41        nmake -f makefile.vc test
42
43   o To install:
44
45        nmake -f makefile.vc install
46   
47   o If you want to debug under MS Developer Studio, its easy to wrap a
48     workspace around the existing makefile.vc:
49        o Select File->Open
50        o In the Open dialog:
51            o Set the "Files of Type" field to be "All Files (*.*)"
52            o Set the "Open As" field to be "Makefile"
53            o Now select "tclX8.4/tcl/win/makefile.vc" using the
54              standard open dialog.
55        o A warning dialog will come up asking if you want to wrap a
56          workspace around the makefile.  Answer "Yes'.
57        o A Save As dialog will appear with the "File name" field
58          default to "makefile1.mak".  Change this to be "tclx.mak".
59        o Press "Save".
60        o You can now use File->Open Workspace to open "tclx.mdp".
61
62In this release, the following restrictions apply:
63
64    o Support is only provided for Borland C++ 5.01 and above.
65
66    o The following commands are not supported:
67       o fork
68
69    o The following commands are not yet implemented:
70       o chmod
71       o chown
72       o chgrp
73       o link
74       o nice
75       o alarm
76
77    o The following commands are there, but not tested, since the tests have
78      not been ported.
79        o signal
80        o flock
81
82    o The select command only works on sockets.
83      
84    o The id command is limited, only the host and process options are
85      implemented
86
87    o The dup command does not work on sockets.
88
89    o The profile command only reports elasped real time, CPU time is not
90      available.
91
92    o There are probably problems with using open sockets and pipes with
93      commands that operate on open files.
94    
95    o No 16 bit support.
96
97    o The fork command is not implemented, but the execl command creates a
98      process and returns its process id.
99