Documentation is "in the works": there are several books dealing with perl/Tk in progress, and a growing FAQ (the document you are presently reading).
In the meantime the available information resources can be split into Perl/Tk, Perl, and Tcl/Tk documentation categories:
pod2man from complaining too much during
make install.)
ftp at
ftp://ftp.ccd.bnl.gov/pub/ptk/archives/ (both in the USA). You may
search the contents of the mailing list archives thanks to a cgi-bin
script written by Achim Bohnet in Germany at:
http://www.rosat.mpe-garching.mpg.de/mailing-lists/ptk/
To subscribe to the mailing list you can send mail to
majordomo@lists.stanford.edu
(i.e.
<majordomo@lists.stanford.edu>)
with the following command in the body of your e-mail message:
subscribe ptk joe.user@somewhere (Joe D. User)
To send a message to all recipients of the mailing list send e-mail to <ptk@lists.stanford.edu>.
To remove yourself from the mailing list send mail to majordomo@lists.stanford.edu (i.e. <majordomo@lists.stanford.edu>) with the following command in the body of your e-mail message:
unsubscribe ptk joe.user@somewhere (Joe D. User)
perl -e 'print join("\n",@INC),"\n";'
If that command does not turn up a perl5/ directory then
make sure that you are running perl 5 with the following: perl -v
(again this can be entered at the shell prompt).
perl -e 'use Config; print $Config{'man1dir'},"\n",$Config{'man3dir'},"\n"'
And if you still cannot find the manual pages check with your system
administrator for the proper MANPATH and/or Tk-# installation version.
In your perl5/Tk/ directory there should be
a number of .pod files including (but not limited to)
UserGuide.pod. The files are examples of the perl "plain old
documentation" format and are just about human readable as they
are (e.g. you may more, cat, or
less them; or send them to a printer). They are intended to be
run through a re-formatting program however. Such programs include
pod2man, pod2html, and pod2latex
(which get installed when you install perl) or
pod2text which was written by Tom
Christiansen.
A command line like the following (but subject to local variations)
should work for you:
pod2man perl5/Tk/UserGuide.pod | nroff -man | more
There should even be a perl script to run the above command for you. It is
executed as:
perldoc perl5/Tk/UserGuide
Note that if there is pod like documentation in a perl module you
may also execute perldoc on it as in:
perldoc ColorEditor.pm
(please note that not all .pm mod files have pod embedded.)
If you want that GUI look and feel (like xman) make the
appropriate changes to the following script:
#!/usr/bin/perl
use Tk;
use Tk::Pod;
my $m = new MainWindow;
$m -> Pod(-file => 'Tk/ColorEditor.pm');
MainLoop;
Or better still use the tkpod program that gets installed when you
'make install' Tk. It can be used like this:
tkpod /usr/local/lib/perl5/pod/perl
The pod conversion to latex proceeds as you might guess, namely:
pod2latex UserGuide.pod
(according to the 1.1 version of pod2latex this will automatically
generate a UserGuide.tex file hence you must have
write access to the directory in which the above command is carried out.)
You may also convert the pod pages to HTML (the HyperText Markup Language of World Wide Web documents). For example, command lines like the following (but subject to local variations - is your web_browser configured to allow local access to a file? - if not do this on a web-serving machine) should work for you:
pod2html perl5/Tk/UserGuide.pod > UserGuide.html
web_browser_invocation UserGuide.html
In addition there is, on an experimental basis, a place to view the
Tk-b9.01 .pod->.html files from the perl5/Tk directory
at:
http://w4.lns.cornell.edu/~pvhp/ptk/pod/
(Please note that the
perl pod specification does not allow for markup within a verbatim
paragraph - yet font changes often seem to be in either the
<XMP></XMP> or the <PRE></PRE> HTML environments
generated by running many of these .pod files through the latest
version of
pod2html. Alert browsers are welcome to
notify me of any
errors in the hand-altered html files.)
Translators pod2texinfo, pod2fm, etc., also exist. Check a CPAN site for these scripts if you do not already have them.
Newer versions: In your Tk-b10++/doc directory there should be a number of .htm files. These were originally Tcl/Tk man pages, but have been converted to Perl syntax in html format.
http://w4.lns.cornell.edu/~pvhp/ptk/doc/
Older versions: In your Tk-b#/doc directory there should be a number of .ht files. These are conversions of Tcl/Tk man pages to html. (If you wish to browse them at your own site you may wish to look at Mark Elston's cvtht script, or configure your web-server/browser to recognize the .ht extension as a text/html mime.type.) The .ht are helpful to the perl/Tk programmer trying to remember the name of an optional argument to pass to a given widget primitive. Note that insofar as these pages do specify syntax it pertains to Tcl/Tk not perl/Tk, hence they must be translated. The pages are on the web at:
http://pubweb.bnl.gov/~ptk/doc/index.html
http://w4.lns.cornell.edu/~pvhp/ptk/b9.01-docnpod/doc/
A miscellany of internet perl/Tk resources includes:
World Wide Web - perl/Tk man pages
http://pubweb.bnl.gov/~ptk/doc/index.html
http://w4.lns.cornell.edu/~pvhp/ptk/doc/
http://w4.lns.cornell.edu/~pvhp/ptk/pod/
Newsgroups
comp.lang.perl.tk
comp.lang.perl.misc
comp.lang.perl.anounce
comp.lang.tcl
comp.lang.tcl.announce
comp.answers
news.answers
Perl/Tk FAQ-Archives (ftp sites) [Note: FAQ may be many separate files]
(see also CPAN sites)
ftp://rtfm.mit.edu/pub/usenet/comp.lang.perl.tk
ftp://rtfm.mit.edu/pub/usenet-by-hierarchy/comp/lang/perl/tk
ftp://ftp.uu.net/usenet/news.answers/perl-faq/ptk-faq
ftp://ftp.ccd.bnl.gov/pub/ptk/ 130.199.54.188
ftp://ftp.ccd.bnl.gov/pub/ptk/ptkFAQ.txt 130.199.54.188
ftp://ftp.wpi.edu/perl5/pTk-FAQ 130.215.24.209
ftp://perl.com/pub/perl/doc/ptkFAQ.gz 199.45.129.30
ftp://perl.com/pub/perl/doc/ptkFAQ.ps.gz 199.45.129.30
WWW-FAQ for perl/Tk
http://w4.lns.cornell.edu/~pvhp/ptk/ptkTOC.html
http://w4.lns.cornell.edu/~pvhp/ptk/ptkFAQ.html
World Wide Web - perl/Tk info sites
http://pubweb.bnl.gov/~ptk/
http://fxfx.com/kgr/compound/ (Perl Tk Compound Widget Page)
http://w4.lns.cornell.edu/~pvhp/ptk/ptkIMG.html (FAQ image supplement)
http://w4.lns.cornell.edu/~pvhp/ptk/etc/
http://w4.lns.cornell.edu/~pvhp/ptk/misc/
http://w4.lns.cornell.edu/~pvhp/ptk/PNMTYAK/
http://www.mirai.com/wks/
The Mailing list
majordomo@lists.stanford.edu
ptk@lists.stanford.edu
http://www.perl.com/perl/faq/Q2.2.html
The two early Perl books by Schwartz and Wall are very helpful (even if they do
pertain to perl 4 and not 5. Beware that perl/Tk makes extensive use of
perl 5 features.):
Learning Perl (The Llama)
Randal L. Schwartz
Copyright (c) 1993 O'Reilly & Associates Inc.
ISBN 1-56592-042-2 (English)
ISBN 2-84177-005-2 (French)
ISBN 3-930673-08-8 (German)
ISBN 4-89502-678-1 (Japanese)
Programming Perl (The Camel)For Perl 5 there will be an update to the Camel ("Learning More Perl"? the Alpaca?) in preparation by Randal L. Schwartz, Tom Christiansen, Larry Wall, and Stephen Potter, with a draft due at O'Reilly by the end of April 1996. There is some Perl5 (book material) information at:
Larry Wall and Randal L. Schwartz
Copyright (c) 1991 O'Reilly & Associates Inc.
ISBN 0-937175-64-1 (English)
ISBN 3-446-17257-2 (German) (Programmieren in Perl, translator: Hanser Verlag)
ISBN 4-89052-384-7 (Japanese)
http://www.metronet.com/1h/perlinfo/perl5/
Jon Orwant (the organizer of the
comp.lang.perl.tk newgroup)
will have a book on Perl 5 out in January 1996. (Please note that it is mostly
about Perl 5, there is a some discussion of four simple Perl/Tk programs, but
it is not a book wholly devoted to Perl/Tk.) The relevant info:
Perl 5 InteractiveThe perl 5 Quick Reference Guide (may require LaTeX for installation) can be obtained from any CPAN ftp site. Detailed location information is also available at the author's website:
Jon Orwant
The Waite Group Press
ISBN: 1-57169-064-6
http://www.xs4all.nl/~jvromans/perlref.html
The quick reference guide has been turned into a small Nutshell handbook:
Perl 5 Desktop Reference
Johan Vromans
Copyright (c) February 1996 O'Reilly & Associates Inc.
ISBN: 1-56592-187-9; Order number: 1879
Additional book information may be found at Tom Christiansen's perl & cgi books page. The multi-part perl 5 man pages are available (assuming they have been installed in your MANPATH, type man perl, man perlmod etc.).
The perl man pages are also available on the web at a number of locations including:
World Wide Web - perl 5.001m man pages
(the 5.002 pages [listed below] are more useful though)
Australia
http://www.cs.mu.oz.au/~slf/perl5/perl.html
http://bwyan.anu.edu.au/perl.html
Austria
http://www.cosy.sbg.ac.at/comp/lang/perl/perl5man/perl.html
Brazil
http://www.lsi.usp.br/perl5/
Canada
http://csclub.uwaterloo.ca/perldoc/perl.html
http://stoner.eps.mcgill.ca/perl/perl.html
Germany
http://www.t-informatik.ba-stuttgart.de/Perl5/perl.html
http://www.dfv.rwth-aachen.de/doc/perl/perl.html
Norway
http://www.pvv.unit.no/sw/perl5/index.html
Slovak Republic
http://www.savba.sk/autori/perl/perl.html
Slovenia
http://www.ijs.si/perl/
Taiwan
http://www.ccu.edu.tw/perl5/index.html
UK
http://www.cs.man.ac.uk/~richardd/perl5/perl.html
http://ppewww.ph.gla.ac.uk/perl/perl.html
USA
http://rhine.ece.utexas.edu/~kschu/perlman.html
http://duggy.extern.ucsd.edu/perl/perl.html
http://tbone.biol.scarolina.edu/~dean/perl/perl.html
http://www.mit.edu:8001/perl/perl.html
http://icg.stwing.upenn.edu/perl5/perl.html
http://w4.lns.cornell.edu/public/compdoc/info/perl/perl.html
World Wide Web - perl 5.002 man pages
(also very useful for previous versions of perl 5)
Canada
http://dymaxion.ns.ca/www/dv/perl_manual/index.html
http://wepil.uwaterloo.ca/~mathers/perl/perl.html
Czech Republic
http://infog.eunet.cz/~muaddib/perl5/index.html
Finland
http://www.hut.fi/~jhi/perl5/index.html
Germany
http://nat-www.uia.ac.be/perl/perl.html
Netherlands
http://www.cs.ruu.nl/pub/mirrors/CPAN/doc/manual/html/frame_index_long.html
USA
http://www.metronet.com/0/perlinfo/perl5/manual/perl.html
http://www.lafayette.edu/doughera/doughera/perl/manual/perl.html
http://www.va.pubnix.com/staff/stripes/perlinfo/
http://www.perl.com/perl/manual/
http://128.84.219.39/public/perl/manual/
http://www.ilap.com/perl/
http://saturn.lbcc.cc.or.us/www_root/docs/perl5/PERL.HTML
In addition to the CPAN ftp source sites, a miscellany of internet perl resources includes:
Newsgroups
comp.lang.perl.misc
comp.lang.perl.announce
comp.lang.perl.modules
comp.infosystems.www.authoring.cgi
comp.answers
news.answers
Perl FAQ-Archives (ftp sites) [Note: FAQ may be many separate files]
(see also the CPAN sites)
North America
ftp://rtfm.mit.edu/pub/usenet/news.answers/perl-faq/
ftp://ftp.uu.net/usenet/news.answers/perl-faq 192.48.96.9
ftp://ftp.khoros.unm.edu/pub/perl/faq.gz 198.59.155.28
Europe
ftp://ftp.cs.ruu.nl/pub/NEWS.ANSWERS/perl-faq/ 131.211.80.17
ftp://src.doc.ic.ac.uk/packages/perl/FAQ 146.169.2.10
Gopher Perl FAQ
gopher://gopher.metronet.com/11/perlinfo/faq
WWW-FAQ for Perl
http://www.perl.com/perl/faq/
http://www.smartpages.com/bngfaqs/comp/lang/perl/top.html
http://www.smartpages.com/bngfaqs/comp/lang/perl/misc/top.html
http://www.smartpages.com/bngfaqs/comp/lang/perl/announce/top.html
http://www.cis.ohio-state.edu/hypertext/faq/usenet/perl-faq/top.html
Perl for Win32 FAQ (discusses Win95)
http://www.perl.hip.com/PerlFaq.htm
Perl info sites
Gopher (gopher:70)
USA
gopher://gopher.metronet.com/11h/perlinfo
World Wide Web (http:80)
USA
http://www.yahoo.com/Computers_and_Internet/Languages/Perl/index.html
http://www.perl.com/
http://www.khoros.unm.edu/staff/neilb/perl/home.html
http://www.khoros.unm.edu:80/staff/neilb/perl/metaFAQ/
http://www.metronet.com/perlinfo/
http://www.metronet.com/perlinfo/perl5.html (Perl 5)
http://www.eecs.nwu.edu/perl/perl.html
http://128.84.219.39/public/perl/
http://www.virtualschool.edu/mon/Perl.html
http://www.hermetica.com/technologia/unexec/
http://www.oac.uci.edu/indiv/ehood/perlWWW/
http://web.sau.edu/~mkruse/www/scripts/
http://orwant.www.media.mit.edu/the_perl_journal/
http://www.perl.com/Architext/AT-allperl.html
http://www.mispress.com/introcgi/
http://www.walrus.com/~smithj/webcan/
http://web.syr.edu/~chsiao05/cps600_project.html
http://www.iftech.com/classes/webdev/webdev_perl.htm
http://www.cc.iastate.edu/perlmenu/
UK
http://pubweb.nexor.co.uk/public/perl/perl.html
http://www.bio.cam.ac.uk/web/form.html
Web references to Perl mailing lists
http://www.perl.com/perl/info/mailing-lists.html
http://www.nicoh.com/cgi-bin/lwgate/PERL5-PORTERS/
http://www.hut.fi/~jhi/perl5-porters.html
http://www.rosat.mpe-garching.mpg.de/mailing-lists/
Tcl and the Tk Toolkit
John K. Ousterhout
Copyright (c) 1994 Addison-Wesley Publishing Company
ISBN 0-201-63337-X (alk. paper)
LOC QA76.73.T44097 1994; 005.13'3--dc20
Practical Programming in Tcl and Tk
Brent Welch
Copyright (c) 1995 Prentice Hall
ISBN 0-13-182007-9
Within the tclsh or wish shells your manpath
includes the tcl/tk man pages (which may not be in your login
manpath). Thus from the % prompt within either shell type commands
like:
% man -k Tk
The Tcl/Tk Reference Guide is also a source of useful information. Although it's Tcl specific most perl/Tk commands can be, more or less, easily derived from it. [As of Tk-b9.01 the names of some functions and some configuration options have changed slightly from their Tcl/Tk counterparts. With Tk-b9.01 (and higher) a great many functions start with an upper case letter and continue with all lower case letters (e.g. there is a perl/Tk Entry widget but no entry widget), and many configuration options are all lower case (e.g. there is a perl/Tk highlightthickness option but no highlightThickness option).] You may fetch the Tcl/Tk Reference Guide (may require LaTeX for installation) from:
ftp://ftp.slac.stanford.edu/software/TkMail/tkref-4.0.1.tar.gz 134.79.18.30
ftp://ftp.aud.alcatel.com/tcl/docs/tkref-4.0.1.tar.gz 198.64.191.10
There are a number of other Tcl/Tk resources on the internet including:
Newsgroups
comp.lang.tcl
comp.lang.tcl.announce
comp.infosystems.www.authoring.cgi
comp.answers
news.answers
FAQ-Archive (ftp) [Note: Tcl FAQ may be many files, Tk FAQ is one file]
ftp://ftp.aud.alcatel.com/tcl/docs/ 198.64.191.10
ftp://rtfm.mit.edu/pub/usenet/news.answers/tcl-faq
ftp://rtfm.mit.edu/pub/usenet/news.answers/tcl-faq/tk
WWW-FAQ for Tcl/Tk
http://www.smartpages.com/faqs/tcl-faq/top.html
http://www.smartpages.com/bngfaqs/comp/lang/tcl/top.html
http://www.cis.ohio-state.edu/hypertext/faq/usenet/tcl-faq/top.html
http://www.cis.ohio-state.edu/hypertext/faq/bngusenet/comp/lang/tcl/top.html
http://www.sco.com/Technology/tcl/Tcl.html
World Wide Web - Tcl/Tk info sites
Canada
http://web.cs.ualberta.ca/~wade/Auto/Tcl.html
UK
http://http2.brunel.ac.uk:8080/~csstddm/TCL2/TCL2.html
http://www.cis.rl.ac.uk/proj/TclTk/
USA
http://www.yahoo.com/Computers_and_Internet/Languages/Tcl_Tk/index.html
http://www.sunlabs.com/research/tcl/docs.html
http://www.sunlabs.com/research/tcl/4.0.html
http://www.sco.com/Technology/tcl/Tcl.html
http://www.neosoft.com/tcl/
http://www.elf.org/tcltk-man-html/contents.html
Tcl/Tk - miscellaneous extensions
ftp://ftp.cme.nist.gov/pub/expect/
http://www.cs.hut.fi/~kjk/porttk.html
http://www.cis.upenn.edu/~ioi/tix/tix.html
http://www.ece.cmu.edu/afs/ece/usr/svoboda/www/th/homepage.html
http://www.tcltk.com/ [incr Tcl]
http://www.neosoft.com/tcl/TclX.html
http://www.eolas.com/eolas/webrouse/tcl.htm [WebWish]
http://www.se.cuhk.hk/~hkng2/big5tk/big5tk.html
http://www.cs.uoregon.edu/~jhobbs/work/ [BLT etc.]
Previous | Return to table of contents | Next