"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