INSTALL file for Perl/Tk

Unpack the tar file *outside* the perl source tree for preference.

To install this (Tk-b9.01) package you need perl5.002beta1 and unoffical patches to 'f'.

Best place to get perl5.002b1f is via 'CPAN' site nearest you - the CPAN sitelist at time of writing is appended.

  ftp any-CPAN-site - see below:
  cd CPAN/authors/id/ANDYD/
  binary
  get perl5.002b1d.tar.gz
  get perl5.002beta1.patch.2b1e.gz
  get perl5.002beta1.patch.2b1f.gz

When patch.2.b1g shows up it should be safe to apply as well, as Andy plans to make it a documentation patch.

Latest MakeMaker from CPAN may help too.

See README.osname for further hints/warnings

If you have perl5.002b1f installed in the normal way you proceed to build Tk.

It is much simpler to install perl than to try and use an uninstalled private copy. If you have a private copy you should 'Configure' it to 'install' somewhere you have write access to, and install it there, then use that perl to build Tk.

When you have an up-to-date perl5.002 installed:

cd to the directory distribution unpacks to.

Then if you have dynamic linking :

  perl Makefile.PL
  make 

Now built locally - if you have dynamic loading you can now say

  perl ./basic_demo 
  make install

You can now run the converted Tk4.0 demos:

  ./demos/widget

For static linking the following is how it is supposed to work (I think, but I don't use static linking normally, this scheme worked as far as this on one trial under SunOS4.)

  perl Makefile.PL
  make 
  make tkperl 

This builds a perl with Tk statically linked in the Tk directory thus:

  ./tkperl ./basic_demo 

should now work.

It is unclear to me whether 'make install' works and I don't want to try it on my system in case it breaks the dynamic version.

If Makefile.PL reports that it cannot find X, or chooses a version you don't like you can specify a version on the command line:

  perl Makefile.PL X11=/usr/local/X11R5  

If X's include and lib are not under a common parent they can be specified separately:

  perl Makefile.PL X11INC=/usr/local/share/X11R5/include X11LIB=/usr/local/arch/X11R5/lib  

Welcome to the CPAN, the Comprehensive Perl Archive Network.

This document describes the CPAN itself, the Network.

---

Network

The master CPAN site is at ftp://ftp.funet.fi/ (Finland, Europe).

The list of the registered CPAN sites follows. Please note that the sorting order is alphabetical on fields:

	continent - country/state - ftp-url

and thus the North American servers happen to be listed last (for the moment, anyway, no Oceanian or South American sites volunteered, yet).

Registered CPAN sites

  Africa

    South Africa    ftp://ftp.is.co.za/programming/perl/CPAN/

  Asia

    Japan           ftp://ftp.lab.kdd.co.jp/lang/perl/CPAN/
    Taiwan          ftp://dongpo.math.ncu.edu.tw/perl/CPAN/

  Australasia

    Australia       ftp://coombs.anu.edu.au/pub/perl/
                    ftp://ftp.mame.mu.oz.au/pub/perl/CPAN/
    New Zealand     ftp://ftp.tekotago.ac.nz/pub/perl/CPAN/

  Europe

    Finland         ftp://ftp.funet.fi/pub/languages/perl/CPAN/
    France          ftp://ftp.ibp.fr/pub/perl/CPAN/
                    ftp://ftp.pasteur.fr/pub/computing/unix/perl/CPAN/
    Germany         ftp://ftp.leo.org/pub/comp/programming/languages/perl/CPAN/
                    ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
    the Netherlands ftp://ftp.cs.ruu.nl/pub/PERL/CPAN/
    Portugal        ftp://ftp.ci.uminho.pt/pub/lang/perl/
    Slovenia        ftp://ftp.arnes.si/software/perl/CPAN/
    Sweden          ftp://ftp.sunet.se/pub/lang/perl/CPAN/
    Switzerland     ftp://ftp.switch.ch/mirror/CPAN/
    UK              ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/
                    ftp://unix.hensa.ac.uk/mirrors/perl-CPAN/

  North America

    Florida         ftp://ftp.cis.ufl.edu/pub/perl/CPAN/
    Illinois        ftp://uiarchive.cso.uiuc.edu/pub/lang/perl/CPAN/
    Massachusetts   ftp://ftp.delphi.com/pub/mirrors/packages/perl/CPAN/
    Oklahoma        ftp://ftp.uoknor.edu/mirrors/CPAN/
    Texas           ftp://ftp.sedl.org/pub/mirrors/CPAN/
                    ftp://ftp.sterling.com/programming/languages/perl/

We apologise for the diversity of the CPAN path names but having identical and hopefully as short as possible path names across several separate ftp sites is well nigh impossible.

Feedback

You can send email to the CPAN administrators, cpan-adm@ftp.funet.fi.

Copyright (c) 1995 Nick Ing-Simmons. All rights reserved. This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, with the exception of all the files in the pTk sub-directory which have separate terms derived from those of the orignal Tk4.0 sources. See pTk/license.terms for details of this license.