NAME

INSTALL file for Perl/Tk


SYNOPSIS

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.

DYNAMIC LINK VERSION

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

STATIC LINK VERSION

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.

SPECIFYING X11 LIBRARIES

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


CPAN

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.


AUTHOR

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.

INSTALL-Tk.pod