diff options
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/buildtoc.PL | 7 | ||||
| -rw-r--r-- | pod/perl.pod | 4 | ||||
| -rw-r--r-- | pod/perlboot.pod | 10 | ||||
| -rw-r--r-- | pod/perlcall.pod | 16 | ||||
| -rw-r--r-- | pod/perldelta.pod | 18 | ||||
| -rw-r--r-- | pod/perlfaq2.pod | 166 | ||||
| -rw-r--r-- | pod/perlfaq3.pod | 6 | ||||
| -rw-r--r-- | pod/perlfaq9.pod | 2 | ||||
| -rw-r--r-- | pod/perlmodlib.PL | 357 | ||||
| -rw-r--r-- | pod/perlobj.pod | 10 | ||||
| -rw-r--r-- | pod/perlport.pod | 4 | ||||
| -rw-r--r-- | pod/perlre.pod | 36 | ||||
| -rw-r--r-- | pod/perltoc.pod | 396 | ||||
| -rw-r--r-- | pod/perltoot.pod | 14 | ||||
| -rw-r--r-- | pod/perltootc.pod | 14 |
15 files changed, 704 insertions, 356 deletions
diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL index f2dba95f61..1e55649ca8 100644 --- a/pod/buildtoc.PL +++ b/pod/buildtoc.PL @@ -140,6 +140,7 @@ if (-d "pod") { perldbmfilter perlapi perlintern + perliol perlapio perltodo perlhack @@ -152,6 +153,7 @@ if (-d "pod") { perlaix perlamiga + perlbs2000 perlcygwin perldos perlepoc @@ -160,8 +162,8 @@ if (-d "pod") { perlmpeix perlos2 perlos390 - perlposix-bc perlsolaris + perlvmesa perlvms perlvos perlwin32 @@ -170,6 +172,7 @@ if (-d "pod") { @ARCHPODS = qw( perlaix perlamiga + perlbs2000 perlcygwin perldos perlepoc @@ -178,8 +181,8 @@ if (-d "pod") { perlmpeix perlos2 perlos390 - perlposix-bc perlsolaris + perlvmesa perlvms perlvos perlwin32 diff --git a/pod/perl.pod b/pod/perl.pod index 4e08cc8ede..1621b2f83b 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -94,6 +94,7 @@ For ease of access, the Perl manual has been split up into several sections: perldbmfilter Perl DBM filters perlapi Perl API listing (autogenerated) perlintern Perl internal functions (autogenerated) + perliol C API for Perl's implementation of IO in Layers perlapio Perl internal IO abstraction interface perltodo Perl things to do perlhack Perl hackers guide @@ -106,6 +107,7 @@ For ease of access, the Perl manual has been split up into several sections: perlaix Perl notes for AIX perlamiga Perl notes for Amiga + perlbs2000 Perl notes for POSIX-BC BS2000 perlcygwin Perl notes for Cygwin perldos Perl notes for DOS perlepoc Perl notes for EPOC @@ -114,8 +116,8 @@ For ease of access, the Perl manual has been split up into several sections: perlmpeix Perl notes for MPE/iX perlos2 Perl notes for OS/2 perlos390 Perl notes for OS/390 - perlposix-bc Perl notes for POSIX-BC perlsolaris Perl notes for Solaris + perlvmesa Perl notes for VM/ESA perlvms Perl notes for VMS perlvos Perl notes for Stratus VOS perlwin32 Perl notes for Windows diff --git a/pod/perlboot.pod b/pod/perlboot.pod index b549f45e49..3c18246f0c 100644 --- a/pod/perlboot.pod +++ b/pod/perlboot.pod @@ -790,9 +790,13 @@ Hopefully, this gets you started, though. For more information, see L<perlobj> (for all the gritty details about Perl objects, now that you've seen the basics), L<perltoot> (the -tutorial for those who already know objects), L<perlbot> (for some -more tricks), and books such as Damian Conway's excellent I<Object -Oriented Perl>. +tutorial for those who already know objects), L<perltootc> (dealing +with class data), L<perlbot> (for some more tricks), and books such as +Damian Conway's excellent I<Object Oriented Perl>. + +Some modules which might prove interesting are Class::Accessor, +Class::Class, Class::Contract, Class::Data::Inheritable, +Class::MethodMaker and Tie::SecureHash =head1 COPYRIGHT diff --git a/pod/perlcall.pod b/pod/perlcall.pod index 94edd342f4..40f1d65a7b 100644 --- a/pod/perlcall.pod +++ b/pod/perlcall.pod @@ -589,12 +589,6 @@ local copy, I<not> the global copy. =item 4. -The only flag specified this time is G_DISCARD. Because we are passing 2 -parameters to the Perl subroutine this time, we have not specified -G_NOARGS. - -=item 5. - Next, we come to XPUSHs. This is where the parameters actually get pushed onto the stack. In this case we are pushing a string and an integer. @@ -602,7 +596,7 @@ integer. See L<perlguts/"XSUBs and the Argument Stack"> for details on how the XPUSH macros work. -=item 6. +=item 5. Because we created temporary values (by means of sv_2mortal() calls) we will have to tidy up the Perl stack and dispose of mortal SVs. @@ -632,10 +626,12 @@ to limit the scope of local variables. See the section I<Using Perl to dispose of temporaries> for details of an alternative to using these macros. -=item 7. +=item 6. -Finally, I<LeftString> can now be called via the I<call_pv> -function. +Finally, I<LeftString> can now be called via the I<call_pv> function. +The only flag specified this time is G_DISCARD. Because we are passing +2 parameters to the Perl subroutine this time, we have not specified +G_NOARGS. =back diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 3c26282d8b..fa4a67e939 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -101,6 +101,13 @@ The tr///C and tr///U features have been removed and will not return; the interface was a mistake. Sorry about that. For similar functionality, see pack('U0', ...) and pack('C0', ...). +=item * + +Although "you shouldn't do that", it was possible to write code that +depends on Perl's hashed key order (Data::Dumper does this). The new +algorithm "One-at-a-Time" produces a different hashed key order. +More details are in L<perldelta/Performance Enhancements>. + =back =head1 Core Enhancements @@ -324,6 +331,17 @@ as opposed to quicksort's Theta(N**2) worst-case run time behaviour), and that sort() is now stable (meaning that elements with identical keys will stay ordered as they were before the sort). +=item * + +Hashes now use Bob Jenkins "One-at-a-Time" hashing key algorithm +(http://burtleburtle.net/bob/hash/doobs.html). +This algorithm is reasonably fast while producing a much better spread +of values. Hash values output from the algorithm on a hash of all +3-char printable ASCII keys comes much closer to passing the DIEHARD +random number generation tests. According to perlbench, this change +has not affected the overall speed of Perl. + + =back =head1 Installation and Configuration Improvements diff --git a/pod/perlfaq2.pod b/pod/perlfaq2.pod index 9552ecfefc..aecc1fc4c3 100644 --- a/pod/perlfaq2.pod +++ b/pod/perlfaq2.pod @@ -12,17 +12,16 @@ related matters. The standard release of Perl (the one maintained by the perl development team) is distributed only in source code form. You -can find this at http://www.perl.com/CPAN/src/latest.tar.gz , which +can find this at http://www.cpan.org/src/latest.tar.gz , which is in a standard Internet format (a gzipped archive in POSIX tar format). Perl builds and runs on a bewildering number of platforms. Virtually all known and current Unix derivatives are supported (Perl's native platform), as are other systems like VMS, DOS, OS/2, Windows, -QNX, BeOS, and the Amiga. There are also the beginnings of support -for MPE/iX. +QNX, BeOS, OS X, MPE/iX and the Amiga. Binary distributions for some proprietary platforms, including -Apple systems, can be found http://www.perl.com/CPAN/ports/ directory. +Apple systems, can be found http://www.cpan.org/ports/ directory. Because these are not part of the standard distribution, they may and in fact do differ from the base Perl port in a variety of ways. You'll have to check their respective release notes to see just @@ -41,12 +40,11 @@ get free compilers for, not for Unix systems. Some URLs that might help you are: + http://www.cpan.org/ports/ http://language.perl.com/info/software.html - http://www.perl.com/pub/language/info/software.html#binary - http://www.perl.com/CPAN/ports/ Someone looking for a Perl for Win16 might look to Laszlo Molnar's djgpp -port in http://www.perl.com/CPAN/ports/msdos/ , which comes with clear +port in http://www.cpan.org/ports/#msdos , which comes with clear installation instructions. A simple installation guide for MS-DOS using Ilya Zakharevich's OS/2 port is available at http://www.cs.ruu.nl/%7Epiet/perl5dos.html @@ -80,7 +78,7 @@ part of the output of % perl -V -You might also want to check out +You might also want to check out L<perlfaq8/"How do I keep my own module/library directory?">. =head2 I grabbed the sources and tried to compile but gdbm/dynamic loading/malloc/linking/... failed. How do I make it work? @@ -92,16 +90,22 @@ architecture. =head2 What modules and extensions are available for Perl? What is CPAN? What does CPAN/src/... mean? -CPAN stands for Comprehensive Perl Archive Network, a huge archive -replicated on dozens of machines all over the world. CPAN contains +CPAN stands for Comprehensive Perl Archive Network, a ~700mb archive +replicated on nearly 200 machines all over the world. CPAN contains source code, non-native ports, documentation, scripts, and many third-party modules and extensions, designed for everything from commercial database interfaces to keyboard/screen control to web -walking and CGI scripts. The master machine for CPAN is -ftp://ftp.funet.fi/pub/languages/perl/CPAN/, but you can use the -address http://www.perl.com/CPAN/CPAN.html to fetch a copy from a -"site near you". See http://www.perl.com/CPAN (without a slash at the -end) for how this process works. +walking and CGI scripts. The master web site for CPAN is +http://www.cpan.org/ and there is the CPAN Multiplexer at +http://www.perl.com/CPAN/CPAN.html which will choose a mirror near you +via DNS. See http://www.perl.com/CPAN (without a slash at the +end) for how this process works. Also, http://mirror.cpan.org/ +has a nice interface to the http://www.cpan.org/MIRRORED.BY +mirror directory. + +See the CPAN FAQ at http://www.cpan.org/misc/cpan-faq.html for +answers to the most frequently asked questions about CPAN +including how to become a mirror. CPAN/path/... is a naming convention for files available on CPAN sites. CPAN indicates the base directory of a CPAN mirror, and the @@ -110,8 +114,8 @@ instance, if you're using ftp://ftp.funet.fi/pub/languages/perl/CPAN as your CPAN site, the file CPAN/misc/japh is downloadable as ftp://ftp.funet.fi/pub/languages/perl/CPAN/misc/japh . -Considering that there are hundreds of existing modules in the -archive, one probably exists to do nearly anything you can think of. +Considering that there are close to two thousand existing modules in +the archive, one probably exists to do nearly anything you can think of. Current categories under CPAN/modules/by-category/ include Perl core modules; development support; operating system interfaces; networking, devices, and interprocess communication; data type utilities; database @@ -122,6 +126,10 @@ compression; image manipulation; mail and news; control flow utilities; filehandle and I/O; Microsoft Windows modules; and miscellaneous modules. +See http://www.cpan.org/modules/00modlist.long.html or +http://search.cpan.org/ for a more complete list of modules by category. + + =head2 Is there an ISO or ANSI certified version of Perl? Certainly not. Larry expects that he'll be certified before Perl is. @@ -140,10 +148,9 @@ You might also try C<perldoc perl> in case your system doesn't have a proper man command, or it's been misinstalled. If that doesn't work, try looking in /usr/local/lib/perl5/pod for documentation. -If all else fails, consult the CPAN/doc directory, which contains the -complete documentation in various formats, including native pod, -troff, html, and plain text. There's also a web page at -http://www.perl.com/perl/info/documentation.html that might help. +If all else fails, consult http://perldoc.cpan.org/ or +http://www.perldoc.com/ both offer the complete documentation +in html format. Many good books have been written about Perl--see the section below for more details. @@ -157,8 +164,10 @@ and L<perlxstut> for linking C and Perl together. There may be more by the time you read this. The following URLs might also be of assistance: - http://language.perl.com/info/documentation.html + http://perldoc.cpan.org/ + http://www.perldoc.com/ http://reference.perl.com/query.cgi?tutorials + http://bookmarks.cpan.org/search.cgi?cat=Training%2FTutorials =head2 What are the Perl newsgroups on Usenet? Where do I post questions? @@ -185,10 +194,10 @@ to alt.sources, please make sure it follows their posting standards, including setting the Followup-To header line to NOT include alt.sources; see their FAQ (http://www.faqs.org/faqs/alt-sources-intro/) for details. -If you're just looking for software, first use AltaVista -(http://www.altavista.com), Deja (http://www.deja.com), and -search CPAN. This is faster and more productive than just posting -a request. +If you're just looking for software, first use Google +(http://www.google.com), Deja (http://www.deja.com), and +CPAN Search (http://search.cpan.org). This is faster and more +productive than just posting a request. =head2 Perl Books @@ -207,21 +216,19 @@ the creator of Perl, is now (July 2000) in its third edition: (English, translations to several languages are also available) The companion volume to the Camel containing thousands -of real-world examples, mini-tutorials, and complete programs -(first premiered at the 1998 Perl Conference), is: +of real-world examples, mini-tutorials, and complete programs is: The Perl Cookbook (the "Ram Book"): - by Tom Christiansen and Nathan Torkington, + by Tom Christiansen and Nathan Torkington, with Foreword by Larry Wall ISBN 1-56592-243-3 [1st Edition August 1998] http://perl.oreilly.com/cookbook/ If you're already a hard-core systems programmer, then the Camel Book -might suffice for you to learn Perl from. If you're not, check -out +might suffice for you to learn Perl from. If you're not, check out Learning Perl (the "Llama Book"): - by Randal Schwartz and Tom Christiansen + by Randal Schwartz and Tom Christiansen with Foreword by Larry Wall ISBN 1-56592-284-0 [2nd Edition July 1997] http://www.oreilly.com/catalog/lperl2/ @@ -237,10 +244,13 @@ we try to provide in the Llama or its defurred cousin the Gecko, please check out the delightful book, I<Perl: The Programmer's Companion>, written by Nigel Chapman. -You can order O'Reilly books directly from O'Reilly & Associates, -1-800-998-9938. Local/overseas is 1-707-829-0515. If you can -locate an O'Reilly order form, you can also fax to 1-707-829-0104. -See http://www.ora.com/ on the Web. +Addison-Wesley (http://www.awlonline.com/) and Manning +(http://www.manning.com/) are also publishers of some fine Perl books +such as Object Oriented Programming with Perl by Damian Conway and +Network Programming with Perl by Lincoln Stein. + +An excellent technical book discounter is Bookpool at +http://www.bookpool.com/ where a 30% discount or more is not unusual. What follows is a list of the books that the FAQ authors found personally useful. Your mileage may (but, we hope, probably won't) vary. @@ -301,7 +311,7 @@ Recommended books on (or mostly on) Perl follow. ISBN 1-881957-32-2 [1st edition May 1998] http://www.macperl.com/ptf_book/ -=item Task-Oriented +=item Task-Oriented The Perl Cookbook by Tom Christiansen and Nathan Torkington @@ -309,20 +319,12 @@ Recommended books on (or mostly on) Perl follow. ISBN 1-56592-243-3 [1st edition August 1998] http://www.oreilly.com/catalog/cookbook/ - Perl5 Interactive Course - by Jon Orwant - ISBN 1571690646 [1st edition June 1997] - - Advanced Perl Programming - by Sriram Srinivasan - ISBN 1-56592-220-4 [1st edition August 1997] - http://www.oreilly.com/catalog/advperl/ - - Effective Perl Programming + Effective Perl Programming by Joseph Hall ISBN 0-201-41975-0 [1st edition 1998] http://www.awl.com/ + =item Special Topics Mastering Regular Expressions @@ -330,10 +332,10 @@ Recommended books on (or mostly on) Perl follow. ISBN 1-56592-257-3 [1st edition January 1997] http://www.oreilly.com/catalog/regex/ - How to Set up and Maintain a World Wide Web Site + Network Programming with Perl by Lincoln Stein - ISBN 0-201-63389-2 [1st edition 1995] - http://www.awl.com/ + ISBN 0-201-61571-1 [1st edition 2001] + http://www.awlonline.com/ Object Oriented Perl Damian Conway @@ -341,6 +343,11 @@ Recommended books on (or mostly on) Perl follow. ISBN 1884777791 [1st edition August 1999] http://www.manning.com/Conway/ + Data Munging with Perl + Dave Cross + ISBN 1930110006 [1st edition 2001] + http://www.manning.com/cross + Learning Perl/Tk by Nancy Walsh ISBN 1-56592-314-6 [1st edition January 1999] @@ -351,13 +358,13 @@ Recommended books on (or mostly on) Perl follow. =head2 Perl in Magazines The first and only periodical devoted to All Things Perl, I<The -Perl Journal> contains tutorials, demonstrations, case studies, -announcements, contests, and much more. I<TPJ> has columns on web +Perl Journal> contained tutorials, demonstrations, case studies, +announcements, contests, and much more. I<TPJ> had columns on web development, databases, Win32 Perl, graphical programming, regular -expressions, and networking, and sponsors the Obfuscated Perl -Contest. It is published quarterly under the gentle hand of its -editor, Jon Orwant. See http://www.tpj.com/ or send mail to -subscriptions@tpj.com . +expressions, and networking, and sponsored the Obfuscated Perl +Contest. Sadly, this publication is no longer in circulation, but +should it be resurrected, it will most likely be announced on +http://use.perl.org/ . Beyond this, magazines that frequently carry high-quality articles on Perl are I<Web Techniques> (see http://www.webtechniques.com/), @@ -369,13 +376,14 @@ http://www.stonehenge.com/merlyn/WebTechniques/ . =head2 Perl on the Net: FTP and WWW Access To get the best performance, pick a site from -the list below and use it to grab the complete list of mirror sites. +the list below and use it to grab the complete list of mirror sites +which is at /CPAN/MIRRORED.BY or at http://mirror.cpan.org/. From there you can find the quickest site for you. Remember, the following list is I<not> the complete list of CPAN mirrors -(the complete list contains 161 sites as of January 2001): +(the complete list contains 165 sites as of January 2001): + http://www.cpan.org/ http://www.perl.com/CPAN/ - http://www.cpan.org/CPAN/ http://download.sourceforge.net/mirrors/CPAN/ ftp://ftp.digital.com/pub/plan/perl/CPAN/ ftp://ftp.flirble.org/pub/languages/perl/CPAN/ @@ -385,18 +393,20 @@ following list is I<not> the complete list of CPAN mirrors ftp://mirror.aarnet.edu.au/pub/perl/CPAN/ ftp://cpan.if.usp.br/pub/mirror/CPAN/ +One may also use xx.cpan.org where "xx" is the 2-letter country code +for your domain; e.g. Australia would use au.cpan.org. + =head2 What mailing lists are there for Perl? Most of the major modules (Tk, CGI, libwww-perl) have their own mailing lists. Consult the documentation that came with the module for -subscription information. The Perl Mongers attempt to maintain a -list of mailing lists at: +subscription information. - http://www.perl.org/support/online_support.html#mail + http://lists.cpan.org/ =head2 Archives of comp.lang.perl.misc -Have you tried Deja or AltaVista? Those are the +Have you tried Deja or AltaVista? Those are the best archives. Just look up "*perl*" as a newsgroup. http://www.deja.com/dnquery.xp?QRY=&DBS=2&ST=PS&defaultOp=AND&LNG=ALL&format=terse&showsort=date&maxhits=25&subjects=&groups=*perl*&authors=&fromdate=&todate= @@ -476,14 +486,9 @@ Read the perlbug(1) man page (perl5.004 or later) for more information. =head2 What is perl.com? Perl Mongers? pm.org? perl.org? -The perl.com domain is owned by Tom Christiansen, who created it as a -public service long before perl.org came about. Despite the name, it's a -pretty non-commercial site meant to be a clearinghouse for information -about all things Perlian, accepting no paid advertisements, bouncy -happy GIFs, or silly Java applets on its pages. The Perl Home Page at -http://www.perl.com/ is currently hosted on a T3 line courtesy of Songline -Systems, a software-oriented subsidiary of O'Reilly and Associates. -Other starting points include +The Perl Home Page at http://www.perl.com/ is currently hosted on a +T3 line courtesy of Songline Systems, a software-oriented subsidiary of +O'Reilly and Associates. Other starting points include http://language.perl.com/ http://conference.perl.com/ @@ -491,23 +496,28 @@ Other starting points include Perl Mongers is an advocacy organization for the Perl language which maintains the web site http://www.perl.org/ as a general advocacy -site for the Perl language, with many sub-domains for special topics, -including - - http://history.perl.org/ - http://bugs.perl.org/ - http://use.perl.org/ +site for the Perl language. Perl Mongers uses the pm.org domain for services related to Perl user groups, including the hosting of mailing lists and web sites. See the Perl user group web site at http://www.pm.org/ for more information about joining, starting, or requesting services for a Perl user group. +Perl Mongers also maintain the perl.org domain to provide general +support services to the Perl community, including the hosting of mailing +lists, web sites, and other services. The web site +http://www.perl.org/ is a general advocacy site for the Perl language, +and there are many other sub-domains for special topics, such as + http://bugs.perl.org/ + http://history.perl.org/ + http://lists.perl.org/ + http://news.perl.org/ + http://use.perl.org/ =head1 AUTHOR AND COPYRIGHT -Copyright (c) 1997-1999 Tom Christiansen and Nathan Torkington. +Copyright (c) 1997-2001 Tom Christiansen and Nathan Torkington. All rights reserved. When included as an integrated part of the Standard Distribution diff --git a/pod/perlfaq3.pod b/pod/perlfaq3.pod index 3840a85074..7b64801be2 100644 --- a/pod/perlfaq3.pod +++ b/pod/perlfaq3.pod @@ -187,8 +187,8 @@ For Windows editors: you can download GNU Emacs (http://www.gnu.org/software/emacs/windows/ntemacs.html) or XEmacs (http://www.xemacs.org/Download/index.html), or a vi clone such as Elvis (ftp://ftp.cs.pdx.edu/pub/elvis/, http://www.fh-wedel.de/elvis/), -Vile (http://www.clark.net/pub/dickey/vile/vile.html), or -Vim (http://www.vim.org/) (win32: http://www.cs.vu.nl/%7Etmgil/vi.html). +Vile (http://vile.cx), or Vim (http://www.vim.org/) +(win32: http://www.cs.vu.nl/%7Etmgil/vi.html). For vi lovers in general, Windows or elsewhere: http://www.thomer.com/thomer/vi/vi.html. @@ -198,7 +198,7 @@ UNIX platforms you might be interested in trying it out, firstly because strictly speaking it is not a vi clone, it is the real vi, or the new incarnation of it, and secondly because you can embed Perl inside it to use Perl as the scripting language. nvi is not alone in this, -though: at least also vim offers an embedded Perl. +though: at least also vim and vile offer an embedded Perl. The following are Win32 multilanguage editor/IDESs that support Perl: Codewright (http://www.starbase.com/), MultiEdit (http://www.MultiEdit.com/), diff --git a/pod/perlfaq9.pod b/pod/perlfaq9.pod index 4c701cafde..3c150502bd 100644 --- a/pod/perlfaq9.pod +++ b/pod/perlfaq9.pod @@ -343,7 +343,7 @@ deliverable which are compliant. Many are tempted to try to eliminate many frequently-invalid mail addresses with a simple regex, such as -C</^[\w.-]+\@([\w.-]\.)+\w+$/>. It's a very bad idea. However, +C</^[\w.-]+\@([\w.-]+\.)+\w+$/>. It's a very bad idea. However, this also throws out many valid ones, and says nothing about potential deliverability, so is not suggested. Instead, see http://www.perl.com/CPAN/authors/Tom_Christiansen/scripts/ckaddr.gz , diff --git a/pod/perlmodlib.PL b/pod/perlmodlib.PL index a2069da3cd..5546dc831d 100644 --- a/pod/perlmodlib.PL +++ b/pod/perlmodlib.PL @@ -43,6 +43,8 @@ while (<MANIFEST>) { } print OUT <<'EOF'; +# Generated by perlmodlib.PL DO NOT EDIT! + =head1 NAME perlmodlib - constructing new Perl modules and finding existing ones @@ -249,167 +251,230 @@ You should try to choose one close to you: =item Africa - South Africa ftp://ftp.is.co.za/programming/perl/CPAN/ - ftp://ftp.saix.net/pub/CPAN/ - ftp://ftp.sun.ac.za/CPAN/ - ftp://ftpza.co.za/pub/mirrors/cpan/ - + South Africa ftp://ftp.is.co.za/programming/perl/CPAN/ + ftp://ftp.saix.net/pub/CPAN/ + ftp://ftpza.co.za/pub/mirrors/cpan/ + ftp://ftp.sun.ac.za/CPAN/ =item Asia - China ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/ - Hong Kong ftp://ftp.pacific.net.hk/pub/mirror/CPAN/ - Indonesia ftp://malone.piksi.itb.ac.id/pub/CPAN/ - Israel ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/ - Japan ftp://ftp.dti.ad.jp/pub/lang/CPAN/ - ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/ - ftp://ftp.lab.kdd.co.jp/lang/perl/CPAN/ - ftp://ftp.meisei-u.ac.jp/pub/CPAN/ - ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/ - ftp://mirror.nucba.ac.jp/mirror/Perl/ - Saudi-Arabia ftp://ftp.isu.net.sa/pub/CPAN/ - Singapore ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/ - South Korea ftp://ftp.bora.net/pub/CPAN/ - ftp://ftp.kornet.net/pub/CPAN/ - ftp://ftp.nuri.net/pub/CPAN/ - Taiwan ftp://coda.nctu.edu.tw/computer-languages/perl/CPAN/ - ftp://ftp.ee.ncku.edu.tw/pub3/perl/CPAN/ - ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/ - Thailand ftp://ftp.nectec.or.th/pub/mirrors/CPAN/ - - -=item Australasia - - Australia ftp://cpan.topend.com.au/pub/CPAN/ - ftp://ftp.labyrinth.net.au/pub/perl-CPAN/ - ftp://ftp.sage-au.org.au/pub/compilers/perl/CPAN/ - ftp://mirror.aarnet.edu.au/pub/perl/CPAN/ - New Zealand ftp://ftp.auckland.ac.nz/pub/perl/CPAN/ - ftp://sunsite.net.nz/pub/languages/perl/CPAN/ - + China ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/ + http://www2.linuxforum.net/mirror/CPAN/ + Hong Kong http://CPAN.pacific.net.hk/ + ftp://ftp.pacific.net.hk/pub/mirror/CPAN/ + Indonesia http://piksi.itb.ac.id/CPAN/ + ftp://mirrors.piksi.itb.ac.id/CPAN/ + http://CPAN.mweb.co.id/ + ftp://ftp.mweb.co.id/pub/languages/perl/CPAN/ + Israel http://www.iglu.org.il:/pub/CPAN/ + ftp://ftp.iglu.org.il/pub/CPAN/ + http://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/ + ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/ + Japan ftp://ftp.u-aizu.ac.jp/pub/lang/perl/CPAN/ + ftp://ftp.kddlabs.co.jp/CPAN/ + http://mirror.nucba.ac.jp/mirror/Perl/ + ftp://mirror.nucba.ac.jp/mirror/Perl/ + ftp://ftp.meisei-u.ac.jp/pub/CPAN/ + ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/ + ftp://ftp.dti.ad.jp/pub/lang/CPAN/ + ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/ + Saudi Arabia ftp://ftp.isu.net.sa/pub/CPAN/ + Singapore http://ftp.nus.edu.sg/unix/perl/CPAN/ + ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/ + South Korea http://CPAN.bora.net/ + ftp://ftp.bora.net/pub/CPAN/ + http://ftp.kornet.net/CPAN/ + ftp://ftp.kornet.net/pub/CPAN/ + ftp://ftp.nuri.net/pub/CPAN/ + Taiwan ftp://coda.nctu.edu.tw/computer-languages/perl/CPAN/ + ftp://ftp.ee.ncku.edu.tw/pub/perl/CPAN/ + ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/ + Thailand http://download.nectec.or.th/CPAN/ + ftp://ftp.nectec.or.th/pub/languages/CPAN/ + ftp://ftp.cs.riubon.ac.th/pub/mirrors/CPAN/ =item Central America - Costa Rica ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/ - + Costa Rica ftp://ftp.linux.co.cr/mirrors/CPAN/ + http://ftp.ucr.ac.cr/Unix/CPAN/ + ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/ =item Europe - Austria ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/ - Belgium ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/ - Bulgaria ftp://ftp.ntrl.net/pub/mirrors/CPAN/ - Croatia ftp://ftp.linux.hr/pub/CPAN/ - Czech Republic ftp://ftp.fi.muni.cz/pub/perl/ - ftp://sunsite.mff.cuni.cz/Languages/Perl/CPAN/ - Denmark ftp://sunsite.auc.dk/pub/languages/perl/CPAN/ - Estonia ftp://ftp.ut.ee/pub/languages/perl/CPAN/ - Finland ftp://ftp.funet.fi/pub/languages/perl/CPAN/ - France ftp://ftp.grolier.fr/pub/perl/CPAN/ - ftp://ftp.lip6.fr/pub/perl/CPAN/ - ftp://ftp.oleane.net/pub/mirrors/CPAN/ - ftp://ftp.pasteur.fr/pub/computing/CPAN/ - ftp://ftp.uvsq.fr/pub/perl/CPAN/ - German ftp://ftp.gigabell.net/pub/CPAN/ - Germany ftp://ftp.archive.de.uu.net/pub/CPAN/ - ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/ - ftp://ftp.gmd.de/packages/CPAN/ - ftp://ftp.gwdg.de/pub/languages/perl/CPAN/ - -ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/ - ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/ - ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/ - ftp://ftp.uni-erlangen.de/pub/source/CPAN/ - ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/ - Germany ftp://ftp.archive.de.uu.net/pub/CPAN/ - ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/ - ftp://ftp.gmd.de/packages/CPAN/ - ftp://ftp.gwdg.de/pub/languages/perl/CPAN/ - -ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/ - ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/ - ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/ - ftp://ftp.uni-erlangen.de/pub/source/CPAN/ - ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/ - Greece ftp://ftp.ntua.gr/pub/lang/perl/ - Hungary ftp://ftp.kfki.hu/pub/packages/perl/CPAN/ - Iceland ftp://ftp.gm.is/pub/CPAN/ - Ireland ftp://cpan.indigo.ie/pub/CPAN/ - ftp://sunsite.compapp.dcu.ie/pub/perl/ - Italy ftp://cis.uniRoma2.it/CPAN/ - ftp://ftp.flashnet.it/pub/CPAN/ - ftp://ftp.unina.it/pub/Other/CPAN/ - ftp://ftp.unipi.it/pub/mirror/perl/CPAN/ - Netherlands ftp://ftp.cs.uu.nl/mirror/CPAN/ - ftp://ftp.nluug.nl/pub/languages/perl/CPAN/ - Norway ftp://ftp.uit.no/pub/languages/perl/cpan/ - ftp://sunsite.uio.no/pub/languages/perl/CPAN/ - Poland ftp://ftp.man.torun.pl/pub/CPAN/ - ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/ - ftp://sunsite.icm.edu.pl/pub/CPAN/ - Portugal ftp://ftp.ci.uminho.pt/pub/mirrors/cpan/ - ftp://ftp.ist.utl.pt/pub/CPAN/ - ftp://ftp.ua.pt/pub/CPAN/ - Romania ftp://ftp.dnttm.ro/pub/CPAN/ - Russia ftp://ftp.chg.ru/pub/lang/perl/CPAN/ - ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/ - Slovakia ftp://ftp.entry.sk/pub/languages/perl/CPAN/ - Slovenia ftp://ftp.arnes.si/software/perl/CPAN/ - Spain ftp://ftp.etse.urv.es/pub/perl/ - ftp://ftp.rediris.es/mirror/CPAN/ - Sweden ftp://ftp.sunet.se/pub/lang/perl/CPAN/ - Switzerland ftp://sunsite.cnlab-switch.ch/mirror/CPAN/ - Turkey ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/ - United Kingdom ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/ - ftp://ftp.flirble.org/pub/languages/perl/CPAN/ - -ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/ - ftp://ftp.plig.org/pub/CPAN/ - ftp://sunsite.doc.ic.ac.uk/packages/CPAN/ - + Austria ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/ + Belgium http://ftp.easynet.be/CPAN/ + ftp://ftp.easynet.be/CPAN/ + ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/ + Bulgaria ftp://ftp.ntrl.net/pub/mirrors/CPAN/ + Croatia ftp://ftp.linux.hr/pub/CPAN/ + Czech Republic http://www.fi.muni.cz/pub/perl/ + ftp://ftp.fi.muni.cz/pub/perl/ + ftp://sunsite.mff.cuni.cz/MIRRORS/ftp.funet.fi/pub/languages/perl/CPAN/ + Denmark ftp://sunsite.auc.dk/pub/languages/perl/CPAN/ + http://www.cpan.dk/CPAN/ + England http://www.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN + ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/ + ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/ + ftp://ftp.flirble.org/pub/languages/perl/CPAN/ + ftp://ftp.plig.org/pub/CPAN/ + ftp://sunsite.doc.ic.ac.uk/packages/CPAN/ + http://mirror.uklinux.net/CPAN/ + ftp://mirror.uklinux.net/pub/CPAN/ + ftp://usit.shef.ac.uk/pub/packages/CPAN/ + Estonia ftp://ftp.ut.ee/pub/languages/perl/CPAN/ + Finland ftp://ftp.funet.fi/pub/languages/perl/CPAN/ + France ftp://cpan.ftp.worldonline.fr/pub/CPAN/ + ftp://ftp.club-internet.fr/pub/perl/CPAN/ + ftp://ftp.lip6.fr/pub/perl/CPAN/ + ftp://ftp.oleane.net/pub/mirrors/CPAN/ + ftp://ftp.pasteur.fr/pub/computing/CPAN/ + ftp://cpan.cict.fr/pub/CPAN/ + ftp://ftp.uvsq.fr/pub/perl/CPAN/ + Germany ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/ + ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/CPAN/ + ftp://ftp.uni-erlangen.de/pub/source/CPAN/ + ftp://ftp-stud.fht-esslingen.de/pub/Mirrors/CPAN + ftp://ftp.gigabell.net/pub/CPAN/ + http://ftp.gwdg.de/pub/languages/perl/CPAN/ + ftp://ftp.gwdg.de/pub/languages/perl/CPAN/ + ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/ + ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/ + ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/ + ftp://ftp.gmd.de/packages/CPAN/ + Greece ftp://ftp.ntua.gr/pub/lang/perl/ + Hungary http://cpan.artifact.hu/ + ftp://cpan.artifact.hu/CPAN/ + ftp://ftp.kfki.hu/pub/packages/perl/CPAN/ + Iceland http://cpan.gm.is/ + ftp://ftp.gm.is/pub/CPAN/ + Ireland http://cpan.indigo.ie/ + ftp://cpan.indigo.ie/pub/CPAN/ + http://sunsite.compapp.dcu.ie/pub/perl/ + ftp://sunsite.compapp.dcu.ie/pub/perl/ + Italy http://cpan.nettuno.it/ + http://softcity.iol.it/cpan + ftp://softcity.iol.it/pub/cpan + ftp://ftp.unina.it/pub/Other/CPAN/ + ftp://ftp.unipi.it/pub/mirror/perl/CPAN/ + ftp://cis.uniRoma2.it/CPAN/ + ftp://ftp.edisontel.it/pub/CPAN_Mirror/ + ftp://ftp.flashnet.it/pub/CPAN/ + Latvia http://kvin.lv/pub/CPAN/ + Netherlands ftp://download.xs4all.nl/pub/mirror/CPAN/ + ftp://ftp.nl.uu.net/pub/CPAN/ + ftp://ftp.cpan.nl/pub/CPAN/ + ftp://ftp.nluug.nl/pub/languages/perl/CPAN/ + http://www.cs.uu.nl/mirror/CPAN/ + ftp://ftp.cs.uu.nl/mirror/CPAN/ + Norway ftp://sunsite.uio.no/pub/languages/perl/CPAN/ + ftp://ftp.uit.no/pub/languages/perl/cpan/ + Poland ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/ + ftp://ftp.mega.net.pl/pub/mirrors/ftp.perl.com/ + ftp://ftp.man.torun.pl/pub/doc/CPAN/ + ftp://sunsite.icm.edu.pl/pub/CPAN/ + Portugal ftp://ftp.ua.pt/pub/CPAN/ + ftp://perl.di.uminho.pt/pub/CPAN/ + ftp://ftp.ist.utl.pt/pub/CPAN/ + ftp://ftp.netc.pt/pub/CPAN/ + Romania ftp://archive.logicnet.ro/mirrors/ftp.cpan.org/CPAN/ + ftp://ftp.kappa.ro/pub/mirrors/ftp.perl.org/pub/CPAN/ + ftp://ftp.dntis.ro/pub/cpan/ + ftp://ftp.opsynet.com/cpan/ + ftp://ftp.dnttm.ro/pub/CPAN/ + Russia ftp://ftp.chg.ru/pub/lang/perl/CPAN/ + http://cpan.rinet.ru/ + ftp://cpan.rinet.ru/pub/mirror/CPAN/ + ftp://ftp.aha.ru/pub/CPAN/ + ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/ + Slovakia ftp://ftp.entry.sk/pub/languages/perl/CPAN/ + Slovenia ftp://ftp.arnes.si/software/perl/CPAN/ + Spain ftp://ftp.rediris.es/mirror/CPAN/ + ftp://ftp.etse.urv.es/pub/perl/ + Sweden http://ftp.du.se/CPAN/ + ftp://ftp.du.se/pub/CPAN/ + ftp://ftp.sunet.se/pub/lang/perl/CPAN/ + Switzerland ftp://ftp.danyk.ch/CPAN/ + ftp://sunsite.cnlab-switch.ch/mirror/CPAN/ + Turkey ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/ =item North America - Alberta ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/ - California ftp://cpan.nas.nasa.gov/pub/perl/CPAN/ - ftp://cpan.valueclick.com/CPAN/ - ftp://ftp.cdrom.com/pub/perl/CPAN/ - http://download.sourceforge.net/mirrors/CPAN/ - Colorado ftp://ftp.cs.colorado.edu/pub/perl/CPAN/ - Florida ftp://ftp.cise.ufl.edu/pub/perl/CPAN/ - Georgia ftp://ftp.twoguys.org/CPAN/ - Illinois ftp://uiarchive.uiuc.edu/pub/lang/perl/CPAN/ - Indiana ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN/ - ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/ - Kentucky ftp://ftp.uky.edu/CPAN/ - Manitoba ftp://theoryx5.uwinnipeg.ca/pub/CPAN/ - Massachusetts -ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/ - ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/ - Mexico ftp://ftp.msg.com.mx/pub/CPAN/ - New York ftp://ftp.deao.net/pub/CPAN/ - ftp://ftp.rge.com/pub/languages/perl/ - North Carolina ftp://ftp.duke.edu/pub/perl/ - Nova Scotia ftp://cpan.chebucto.ns.ca/pub/CPAN/ - Oklahoma ftp://ftp.ou.edu/mirrors/CPAN/ - Ontario ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/ - Oregon ftp://ftp.orst.edu/pub/packages/CPAN/ - Pennsylvania ftp://ftp.epix.net/pub/languages/perl/ - Tennessee ftp://ftp.sunsite.utk.edu/pub/CPAN/ - Texas ftp://ftp.sedl.org/pub/mirrors/CPAN/ - ftp://jhcloos.com/pub/mirror/CPAN/ - Utah ftp://mirror.xmission.com/CPAN/ - Virginia ftp://ftp.perl.org/pub/perl/CPAN/ - ftp://ruff.cs.jmu.edu/pub/CPAN/ - Washington ftp://ftp-mirror.internap.com/pub/CPAN/ - ftp://ftp.llarian.net/pub/CPAN/ - ftp://ftp.spu.edu/pub/CPAN/ - + Alberta http://sunsite.ualberta.ca/pub/Mirror/CPAN/ + ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/ + Alabama http://mirror.hiwaay.net/CPAN/ + ftp://mirror.hiwaay.net/CPAN/ + California http://www.cpan.org/ + ftp://ftp.cpan.org/CPAN/ + ftp://cpan.nas.nasa.gov/pub/perl/CPAN/ + ftp://ftp.digital.com/pub/plan/perl/CPAN/ + http://www.kernel.org/pub/mirrors/cpan/ + ftp://ftp.kernel.org/pub/mirrors/cpan/ + http://www.perl.com/CPAN/ + http://download.sourceforge.net/mirrors/CPAN/ + Colorado ftp://ftp.cs.colorado.edu/pub/perl/CPAN/ + Florida ftp://ftp.cise.ufl.edu/pub/perl/CPAN/ + Georgia ftp://ftp.twoguys.org/CPAN/ + Illinois http://www.neurogames.com/mirrors/CPAN + Indiana ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/ + http://cpan.nitco.com/ + ftp://cpan.nitco.com/pub/CPAN/ + ftp://cpan.in-span.net/ + http://csociety-ftp.ecn.purdue.edu/pub/CPAN + ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN + Manitoba http://theoryx5.uwinnipeg.ca/pub/CPAN/ + ftp://theoryx5.uwinnipeg.ca/pub/CPAN/ + Massachusetts ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/ + ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/ + Mexico http://www.msg.com.mx/CPAN/ + ftp://ftp.msg.com.mx/pub/CPAN/ + New Jersey ftp://ftp.cpanel.net/pub/CPAN/ + New York ftp://ftp.freesoftware.com/pub/perl/CPAN/ + http://www.deao.net/mirrors/CPAN/ + ftp://ftp.deao.net/pub/CPAN/ + ftp://ftp.stealth.net/pub/mirrors/ftp.cpan.org/pub/CPAN/ + http://mirror.nyc.anidea.com/CPAN/ + ftp://mirror.nyc.anidea.com/pub/CPAN/ + http://www.rge.com/pub/languages/perl/ + ftp://ftp.rge.com/pub/languages/perl/ + ftp://mirrors.cloud9.net/pub/mirrors/CPAN/ + North Carolina ftp://ftp.duke.edu/pub/perl/ + Nova Scotia ftp://cpan.chebucto.ns.ca/pub/CPAN/ + Ohio ftp://ftp.loaded.net/pub/CPAN/ + Oklahoma ftp://ftp.ou.edu/mirrors/CPAN/ + Ontario ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/ + Oregon ftp://ftp.orst.edu/pub/packages/CPAN/ + Pennsylvania http://ftp.epix.net/CPAN/ + ftp://ftp.epix.net/pub/languages/perl/ + ftp://carroll.cac.psu.edu/pub/CPAN/ + Tennessee ftp://ftp.sunsite.utk.edu/pub/CPAN/ + Texas http://ftp.sedl.org/pub/mirrors/CPAN/ + http://jhcloos.com/pub/mirror/CPAN/ + ftp://jhcloos.com/pub/mirror/CPAN/ + Utah ftp://mirror.xmission.com/CPAN/ + Virginia http://mirrors.rcn.net/pub/lang/CPAN/ + ftp://mirrors.rcn.net/pub/lang/CPAN/ + ftp://ruff.cs.jmu.edu/pub/CPAN/ + Washington http://cpan.llarian.net/ + ftp://cpan.llarian.net/pub/CPAN/ + ftp://ftp-mirror.internap.com/pub/CPAN/ + ftp://ftp.spu.edu/pub/CPAN/ + +=item Oceania + + Australia http://ftp.planetmirror.com/pub/CPAN/ + ftp://ftp.planetmirror.com/pub/CPAN/ + ftp://mirror.aarnet.edu.au/pub/perl/CPAN/ + ftp://cpan.topend.com.au/pub/CPAN/ + New Zealand ftp://ftp.auckland.ac.nz/pub/perl/CPAN/ =item South America - Brazil ftp://cpan.if.usp.br/pub/mirror/CPAN/ - ftp://ftp.matrix.com.br/pub/perl/ - Chile ftp://sunsite.dcc.uchile.cl/pub/Lang/PERL/ + Argentina ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/ + Brazil ftp://cpan.pop-mg.com.br/pub/CPAN/ + ftp://ftp.matrix.com.br/pub/perl/ + ftp://cpan.if.usp.br/pub/mirror/CPAN/ + Chile ftp://ftp.psinet.cl/pub/programming/perl/CPAN/ + ftp://sunsite.dcc.uchile.cl/pub/lang/perl/ =back diff --git a/pod/perlobj.pod b/pod/perlobj.pod index 9a9bda94d9..285ed9975e 100644 --- a/pod/perlobj.pod +++ b/pod/perlobj.pod @@ -559,8 +559,8 @@ breaks the circularities in the self-referential structure. =head1 SEE ALSO -A kinder, gentler tutorial on object-oriented programming in Perl -can be found in L<perltoot> and L<perltootc>. You should also check -out L<perlbot> for other object tricks, traps, and tips, as well -as L<perlmodlib> for some style guides on constructing both modules -and classes. +A kinder, gentler tutorial on object-oriented programming in Perl can +be found in L<perltoot>, L<perlbootc> and L<perltootc>. You should +also check out L<perlbot> for other object tricks, traps, and tips, as +well as L<perlmodlib> for some style guides on constructing both +modules and classes. diff --git a/pod/perlport.pod b/pod/perlport.pod index 08a1704baf..de2d855ff3 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -1066,7 +1066,7 @@ Also see: * -L<perlos390>, F<README.os390>, F<perlposix-bc>, F<README.vmesa>, +L<perlos390>, F<README.os390>, F<perlbs2000>, F<README.vmesa>, L<perlebcdic>. =item * @@ -2018,7 +2018,7 @@ http://www.perl.com/CPAN/ports/index.html for binary distributions. =head1 SEE ALSO L<perlaix>, L<perlamiga>, L<perlcygwin>, L<perldos>, L<perlepoc>, -L<perlebcdic>, L<perlhpux>, L<perlos2>, L<perlos390>, L<perlposix-bc>, +L<perlebcdic>, L<perlhpux>, L<perlos2>, L<perlos390>, L<perlbs2000>, L<perlwin32>, L<perlvms>, L<perlvos>, and L<Win32>. =head1 AUTHORS / CONTRIBUTORS diff --git a/pod/perlre.pod b/pod/perlre.pod index 2e2f59cdfd..02dd2cda5d 100644 --- a/pod/perlre.pod +++ b/pod/perlre.pod @@ -40,7 +40,7 @@ is, no matter what C<$*> contains, C</s> without C</m> will force "^" to match only at the beginning of the string and "$" to match only at the end (or just before a newline at the end) of the string. Together, as /ms, they let the "." match any character whatsoever, -while yet allowing "^" and "$" to match, respectively, just after +while still allowing "^" and "$" to match, respectively, just after and just before newlines within the string. =item x @@ -334,12 +334,14 @@ I<backreference>. There is no limit to the number of captured substrings that you may use. However Perl also uses \10, \11, etc. as aliases for \010, -\011, etc. (Recall that 0 means octal, so \011 is the 9'th ASCII -character, a tab.) Perl resolves this ambiguity by interpreting -\10 as a backreference only if at least 10 left parentheses have -opened before it. Likewise \11 is a backreference only if at least -11 left parentheses have opened before it. And so on. \1 through -\9 are always interpreted as backreferences." +\011, etc. (Recall that 0 means octal, so \011 is the character at +number 9 in your coded character set; which would be the 10th character, +a horizontal tab under ASCII.) Perl resolves this +ambiguity by interpreting \10 as a backreference only if at least 10 +left parentheses have opened before it. Likewise \11 is a +backreference only if at least 11 left parentheses have opened +before it. And so on. \1 through \9 are always interpreted as +backreferences. Examples: @@ -955,10 +957,10 @@ escape it with a backslash. "-" is also taken literally when it is at the end of the list, just before the closing "]". (The following all specify the same class of three characters: C<[-az]>, C<[az-]>, and C<[a\-z]>. All are different from C<[a-z]>, which -specifies a class containing twenty-six characters.) -Also, if you try to use the character classes C<\w>, C<\W>, C<\s>, -C<\S>, C<\d>, or C<\D> as endpoints of a range, that's not a range, -the "-" is understood literally. +specifies a class containing twenty-six characters, even on EBCDIC +based coded character sets.) Also, if you try to use the character +classes C<\w>, C<\W>, C<\s>, C<\S>, C<\d>, or C<\D> as endpoints of +a range, that's not a range, the "-" is understood literally. Note also that the whole range idea is rather unportable between character sets--and even within character sets they may cause results @@ -970,11 +972,11 @@ spell out the character sets in full. Characters may be specified using a metacharacter syntax much like that used in C: "\n" matches a newline, "\t" a tab, "\r" a carriage return, "\f" a form feed, etc. More generally, \I<nnn>, where I<nnn> is a string -of octal digits, matches the character whose ASCII value is I<nnn>. -Similarly, \xI<nn>, where I<nn> are hexadecimal digits, matches the -character whose ASCII value is I<nn>. The expression \cI<x> matches the -ASCII character control-I<x>. Finally, the "." metacharacter matches any -character except "\n" (unless you use C</s>). +of octal digits, matches the character whose coded character set value +is I<nnn>. Similarly, \xI<nn>, where I<nn> are hexadecimal digits, +matches the character whose numeric value is I<nn>. The expression \cI<x> +matches the character control-I<x>. Finally, the "." metacharacter +matches any character except "\n" (unless you use C</s>). You can specify a series of alternatives for a pattern using "|" to separate them, so that C<fee|fie|foe> will match any of "fee", "fie", @@ -1278,5 +1280,7 @@ L<perlfunc/pos>. L<perllocale>. +L<perlebcdic>. + I<Mastering Regular Expressions> by Jeffrey Friedl, published by O'Reilly and Associates. diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 1c77054820..316cc936a0 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -236,8 +236,8 @@ unary &, unary *, (TYPE) =item Regexp Quote-Like Operators ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>, -qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/, -s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, +qq/STRING/, "STRING", qr/STRING/imosx, qw/STRING/, qu/STRING/, qx/STRING/, +`STRING`, s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds, y/SEARCHLIST/REPLACEMENTLIST/cds =item Gory details of parsing quoted constructs @@ -366,16 +366,17 @@ DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, -q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, -quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read -FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, -readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, -ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, -require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir -DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, -rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir -DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, -semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send +q/STRING/, qq/STRING/, qr/STRING/, qu/STRING/, qw/STRING/, qx/STRING/, +quotemeta EXPR, quotemeta, rand EXPR, rand, read +FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir +DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, recv +SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename +OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset, +return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex +STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar +EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select +FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl +ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, @@ -1342,6 +1343,8 @@ C<(?(condition)yes-pattern|no-pattern)> =item DESCRIPTION +=item Class Data in a Can + =item Class Data as Package Variables =over 4 @@ -3813,14 +3816,14 @@ B<filter_fetch_value> AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, -bytes_to_utf8, call_argv, call_method, call_pv, call_sv, CLASS, Copy, -croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, -eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, get_av, get_cv, -get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod, -gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD, -G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, -HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, -hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, +bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv, +CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, +dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, +get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, +gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, +G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, +HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, +hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items, @@ -3830,10 +3833,9 @@ newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, -PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_modglobal, -PL_na, PL_ofs_sv, PL_rs, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, -POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, -Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, +PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, +POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, +Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, @@ -3876,7 +3878,8 @@ XS_VERSION_BOOTCHECK, Zero =item DESCRIPTION -djSP, is_gv_magical, LVRET, start_glob +djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, +PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob =item AUTHORS @@ -3884,6 +3887,74 @@ djSP, is_gv_magical, LVRET, start_glob =back +=head2 perliol - C API for Perl's implementation of IO in Layers. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item History and Background + +=item Layers vs Disciplines + +=item Data Structures + +1. The functions and attributes of the "layer class", 2. The per-instance +data for a particular handle + +=item Functions and Attributes + +1. Opening and setup functions, 2. Basic IO operations, 3. Stdio class +buffering options, 4. Functions to support Perl's traditional "fast" access +to the buffer + +=item Per-instance Data + +=item Layers in action. + +=item Per-instance flag bits + +PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR, +PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8, +PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF, +PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS + +=item Methods in Detail + +IV (*Fileno)(PerlIO *f);, PerlIO * (*Fdopen)(PerlIO_funcs +*tab, int fd, const char *mode);, PerlIO * (*Open)(PerlIO_funcs *tab, +const char *path, const char *mode);, int (*Reopen)(const char +*path, const char *mode, PerlIO *f);, IV (*Pushed)(PerlIO +*f,const char *mode,const char *arg,STRLEN len);, IV +(*Popped)(PerlIO *f);, SSize_t (*Read)(PerlIO *f, void *vbuf, Size_t +count);, SSize_t (*Unread)(PerlIO *f, const void *vbuf, Size_t count);, +SSize_t (*Write)(PerlIO *f, const void *vbuf, Size_t count);, IV + (*Seek)(PerlIO *f, Off_t offset, int whence);, Off_t +(*Tell)(PerlIO *f);, IV (*Close)(PerlIO *f);, IV + (*Flush)(PerlIO *f);, IV (*Fill)(PerlIO *f);, IV + (*Eof)(PerlIO *f);, IV (*Error)(PerlIO *f);, void + (*Clearerr)(PerlIO *f);, void (*Setlinebuf)(PerlIO *f);, +STDCHAR * (*Get_base)(PerlIO *f);, Size_t +(*Get_bufsiz)(PerlIO *f);, STDCHAR * (*Get_ptr)(PerlIO *f);, SSize_t + (*Get_cnt)(PerlIO *f);, void (*Set_ptrcnt)(PerlIO *f,STDCHAR +*ptr,SSize_t cnt); + +=item Core Layers + +"unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" + +=item Extension Layers + +"encoding" + +=back + +=back + =head2 perlapio - perl's IO abstraction interface. =over 4 @@ -3892,27 +3963,36 @@ djSP, is_gv_magical, LVRET, start_glob =item DESCRIPTION -B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>, -B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>, +1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>, +B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>, +B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>, B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>, B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>, B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>, B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>, B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>, -B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>, -B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, -B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()> +B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>, +B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>, +B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)> =over 4 =item Co-existence with stdio B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>, -B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>, -B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>, -B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>, -B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, -B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)> +B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)> + +=item "Fast gets" Functions + +B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>, +B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>, +B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>, +B<PerlIO_get_bufsiz(f)> + +=item Other Functions + +PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), +'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...) =back @@ -5279,6 +5359,49 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back +=head2 perlbs2000, README.posix-bc - building and installing Perl for +BS2000 POSIX. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item gzip + +=item bison + +=item Unpacking + +=item Compiling + +=item Testing + +=item Install + +=item Using Perl + +=item Floating point anomalies + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=item HISTORY + +=back + =head2 perlcygwin, README.cygwin - Perl for Cygwin =over 4 @@ -5364,6 +5487,50 @@ Source, Compiled Module Source, Perl Modules/Scripts =back +=head2 perldos - Perl under DOS, W31, W95. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Prerequisites + +DJGPP, Pthreads + +=item Shortcomings of Perl under DOS + +=item Building + +=item Testing + +=item Installation + +=back + +=item BUILDING AND INSTALLING MODULES + +=over 4 + +=item Prerequisites + +=item Unpacking CPAN Modules + +=item Building Non-XS Modules + +=item Building XS Modules + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlepoc, README.epoc - Perl for EPOC =over 4 @@ -5746,50 +5913,13 @@ C<COND_WAIT>, F<os2.c> =item testing anomalies -=item Usage Hints - -=item Modules and Extensions - -=back - -=item AUTHORS - -=item SEE ALSO - -=over 4 - -=item Mailing list - -=back - -=item HISTORY - -=back - -=head2 perlposix-bc, README.posix-bc - building and installing Perl for -BS2000 POSIX. - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION +=item installation anomalies -=over 4 - -=item gzip - -=item bison - -=item Unpacking - -=item Compiling - -=item Testing +=item Usage Hints -=item Install +=item Floating point anomalies -=item Using Perl +=item Modules and Extensions =back @@ -5891,6 +6021,52 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Unpacking + +=item Setup and utilities + +=item Configure + +- Don't turn on the compiler optimization flag "-O". There's a bug in +the compiler (APAR PQ18812) that generates some bad code the +optimizer is on, - As VM/ESA doesn't fully support the fork() API programs +relying on this call will not work. I've replaced fork()/exec() with +spawn() and the standalone exec() with spawn(). This has a side +effect when opening unnamed pipes in a shell script: there is no child +process generated under + +=item testing anomalies + +=item Usage Hints + +When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII +character sets are different. Perl builtin functions that may behave +differently under EBCDIC are mentioned in the perlport.pod document. + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=back + =head2 perlvms - VMS-specific documentation for Perl =over 4 @@ -6004,6 +6180,48 @@ LIST, waitpid PID,FLAGS =back +=head2 perlwin32 - Perl under Win32 + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Setting Up + +Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC + +=item Building + +=item Testing + +=item Installation + +=item Usage Hints + +Environment Variables, File Globbing, Using perl from the command line, +Building Extensions, Command-line Wildcard Expansion, Win32 Specific +Extensions, Running Perl Scripts, Miscellaneous Things + +=back + +=item BUGS AND CAVEATS + +=item AUTHORS + +Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy +E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons +E<lt>nick@ing-simmons.netE<gt> + +=item SEE ALSO + +=item HISTORY + +=back + =head1 PRAGMA DOCUMENTATION =head2 attrs - set/get attributes of a subroutine (deprecated) @@ -7987,17 +8205,17 @@ C<revision>, C<rm>, C<rmail>, C<runnm> C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>, C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>, -C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>, -C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>, -C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, C<siteprefixexp>, -C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>, -C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>, -C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>, -C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, -C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>, -C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, -C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>, -C<strings>, C<submit>, C<subversion>, C<sysman> +C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>, +C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, +C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, +C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, +C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, +C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, +C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, +C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, +C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, +C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, +C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman> =item t @@ -12590,6 +12808,10 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item The test script output +B<1..M>, B<'ok', 'not ok'. Ok?>, B<test numbers>, +B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>, +B<Bail out!>, B<Comments> + =back =item EXPORT diff --git a/pod/perltoot.pod b/pod/perltoot.pod index 594cb99daa..38cc1f3e65 100644 --- a/pod/perltoot.pod +++ b/pod/perltoot.pod @@ -425,6 +425,10 @@ this could be done: Notice how there's no memory to deallocate in the destructor? That's something that Perl takes care of for you all by itself. +Alternatively, you could use the Class::Data::Inheritable module from +CPAN. + + =head2 Accessing Class Data It turns out that this is not really a good way to go about handling @@ -1750,6 +1754,16 @@ L<perltie>, and L<overload>. +L<perlboot> is a kinder, gentler introduction to object-oriented +programming. + +L<perltootc> provides more detail on class data. + +Some modules which might prove interesting are Class::Accessor, +Class::Class, Class::Contract, Class::Data::Inheritable, +Class::MethodMaker and Tie::SecureHash + + =head1 AUTHOR AND COPYRIGHT Copyright (c) 1997, 1998 Tom Christiansen diff --git a/pod/perltootc.pod b/pod/perltootc.pod index ee0bd02f62..d2d881c999 100644 --- a/pod/perltootc.pod +++ b/pod/perltootc.pod @@ -74,6 +74,15 @@ you can elect to permit access to them from anywhere in the entire file scope, or you can limit direct data access exclusively to the methods implementing those attributes. +=head1 Class Data in a Can + +One of the easiest ways to solve a hard problem is to let someone else +do it for you! In this case, Class::Data::Inheritable (available on a +CPAN near you) offers a canned solution to the class data problem +using closures. So before you wade into this document, consider +having a look at that module. + + =head1 Class Data as Package Variables Because a class in Perl is really just a package, using package variables @@ -1302,7 +1311,8 @@ would just confuse the examples. L<perltoot>, L<perlobj>, L<perlmod>, and L<perlbot>. -The Tie::SecureHash module from CPAN is worth checking out. +The Tie::SecureHash and Class::Data::Inheritable modules from CPAN are +worth checking out. =head1 AUTHOR AND COPYRIGHT @@ -1334,4 +1344,4 @@ object-oriented languages enforce. =head1 HISTORY -Last edit: Fri May 21 15:47:56 MDT 1999 +Last edit: Sun Feb 4 20:50:28 EST 2001 |