"Fossies" - the Fresh Open Source Software Archive 
Member "Tk-804.036/README.cygwin" (18 Nov 2013, 5517 Bytes) of package /linux/misc/Tk-804.036.tar.gz:
As a special service "Fossies" has tried to format the requested text file into HTML format (style:
standard) with prefixed line numbers.
Alternatively you can here
view or
download the uninterpreted source code file.
1 Currently building Perl/Tk under cygwin is broken using the native
2 Win32 GUI libraries. Therefore the default is to build using X11
3 libraries (but note that this may change, so it's best to specify the
4 window architecture, see below).
5
6 Using the X11 libraries, "make test" will very probably fail due to
7 "rebase" problems, but Perl/Tk should be mostly usable after an
8 installation and maybe a manual "rebaseall" after.
9
10 ----------------------------------------------------------------------
11
12 This is a brief description of how to get the Tk module working with
13 Perl and Cygwin.
14
15 CONFIGURE/BUILD
16
17 Use native Win32 GUI calls:
18
19 perl Makefile.PL MSWin32
20
21 Use X11 client libraries (and requires a X server):
22
23 Precompiled X11 client libraries can be downloaded from
24 ftp://sourceware.cygnus.com/pub/cygwin/xfree/xc-4-binaries/
25 xfree86-4.0-DLLs.tar.bz2
26 xfree86-4.0-devel.tar.bz2
27
28 NOTE: Your DISPLAY must be 127.0.0.1:0.0
29 Your PATH must include the DLL directory, /usr/X11R6/bin
30
31 perl Makefile.PL x
32
33 or
34
35 perl Makefile.PL
36
37 make
38
39 TEST
40
41 make test
42 perl -Mblib demos/widget
43
44 INSTALL
45
46 make install
47
48 SIDE-BY-SIDE PORT COMPARISONS (demos/widget)
49
50 X11 (Hummingbird/Exceed X Server, V6.1)
51
52 + Motif look and feel
53 + Scroll wheel does not work with X11 (config?)
54 + Global grabs only affect X11 windows (config?)
55 + Menus, normal style
56 - Alt+x does not post menus (config?)
57 + $Tk::platform => unix
58
59 Win32
60
61 + Windows look and feel
62 + Uses Win32 clipboard
63 + Help on menu bar not all the way to the right
64 + Tear-off menus placed at upper-left instead of near pointer
65 + Tile and Transparent, no tiled camels, third window not
66 transparent
67 + Menus, normal style
68 - File - "Error: unknown option "-label" at Tk.pm line 217
69 + Menus, Perl/Tk style
70 - Menus do not drop as traverse with button press
71 - Alt+x does not post menus
72 + Native Win32 FileSelect dialog, FileSelect/FBox the same
73 + Native Win32 ChooseColor dialog
74 + Balls bouncing, when start restacked below widget demo window
75 (if bounce window not moved)
76 + Global grabs only affect current application
77 + IntelliMouse with IntelliEye (but ok with a trackball, setting?)
78 - Button-2 dragging/scanning does not work well
79 - Button-2 for copy/paste does not work well
80 (seems to flip into a scroll mode)
81 + $Tk::TkwinVtab, $Tk::TkwinintVtab variables
82 + $Tk::platform => MSWin32
83
84 Both
85 + Tear-off menus restack parent below widget demo window
86 + Meta-backspace, Meta-d not working (Meta config?)
87 + Menus, normal and Perl/Tk style
88 - Meta+x accelerators (Control+x okay) not working (config?)
89
90 X11 (Cygwin) v X11 (Solaris)
91
92 No differences that I could find!
93
94 Win32 (Cygwin) v Win32 (MSWin32/ActiveState)
95
96 + Menus, normal style
97 - Accelerators Win32 bound to Control, Cygwin bound to Meta
98 (see demos/demos/widget_lib/menus.pl, $^O eq 'MSWin32')
99 - Win32 ^A does not work (Meta+A with X11), ^H does
100
101 PORTING NOTES
102
103 + $Tk::platform is really the win_arch, where unix is x
104 (sometimes $^O eq 'MSWin32' is used instead of $Tk::platform
105 eq 'MSWin32' assuming they are equivalent and vice versa)
106 + #define distinctions
107 _WIN32 defined by gcc, if X11 need to undef
108 __WIN32__ win_arch MSWin32, also defined in pTk/Lang.h
109 WIN32 from #include <windows.h>
110 when precedes #include "perl.h" then need
111 a #undef WIN32 (otherwise tries to include
112 Win32 Perl things like win32.h, defined
113 by native Win32 port)
114 + With native Win32 GUI use Cygwin select() with /dev/windows
115 pseudo-device rather than using Win32 GetMessage() directly
116 + pTk/mTk/win/tkWinX.c, pTk/mTk/generic/tkPort.h part of core Tk,
117 which is ordinarily not touched by Tk Perl module? pTk/Tcl-pTk?
118
119 FILES (with Cygwin references)
120
121 README.cygwin MANIFEST
122 * documentation
123
124 Makefile.PL Tk/MMutil.pm pTk/Makefile.PL
125 * make stuff
126
127 pTk/mTk/win/tkWinX.c
128 * GetMessage() via select() on /dev/windows and callback
129
130 Scrollbar/Scrollbar.xs tkWin32Dll.c
131 * defined(__WIN32__) && defined(__CYGWIN__)
132
133 tkGlue.c
134 * refdef XS because __declspec(dllexport) incompatible with static
135 * defined(__WIN32__) && defined(__CYGWIN__) and pTk/tkWin.h
136 includes <windows.h> which defines WIN32
137
138 Tk.pm
139 * set $Tk::platform with help from $Tk::Config::win_arch
140
141 DragDrop/site_test Tk/X11Font.pm t/create.t t/mwm.t
142 * $^O eq 'cygwin' and $Tk::platform eq 'MSWin32'
143
144 DragDrop/Win32Site/Win32Site.xs
145 * #undef WIN32 from <windows.h>
146
147 pTk/mTk/generic/tkPort.h
148 * resolve strcasecmp/stricmp #define mess
149
150 pTk/Lang.h
151 * some defs ordinarily from tkUnixPort.h
152
153 chnGlue.c
154 * Cygwin has O_BINARY
155
156 IO/IO.xs
157 * Cygwin has O_NONBLOCK
158
159 TODO
160
161 + Any way to have X11 and native Win32 versions available
162 at the same time? Build with Xlib/Win32 emulator (see rxvt)?
163 + Fix gcc warnings, mostly in pTk win32 flavor?
164 + Test with cygwin-xfree X Server?
165
166 Thu Aug 31 12:54:09 BST 2000
167 Eric Fifer
168 efifer@dircon.co.uk