diff options
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/buildtoc.PL | 2 | ||||
| -rw-r--r-- | pod/perl.pod | 1 | ||||
| -rw-r--r-- | pod/perl5005delta.pod | 2 | ||||
| -rw-r--r-- | pod/perl571delta.pod | 2 | ||||
| -rw-r--r-- | pod/perlapi.pod | 75 | ||||
| -rw-r--r-- | pod/perldebtut.pod | 2 | ||||
| -rw-r--r-- | pod/perlebcdic.pod | 6 | ||||
| -rw-r--r-- | pod/perlfaq3.pod | 6 | ||||
| -rw-r--r-- | pod/perlfunc.pod | 13 | ||||
| -rw-r--r-- | pod/perlguts.pod | 2 | ||||
| -rw-r--r-- | pod/perlhack.pod | 10 | ||||
| -rw-r--r-- | pod/perlmodlib.pod | 20 | ||||
| -rw-r--r-- | pod/perlnewmod.pod | 27 | ||||
| -rw-r--r-- | pod/perltoc.pod | 583 | ||||
| -rw-r--r-- | pod/perltodo.pod | 14 | ||||
| -rw-r--r-- | pod/perlutil.pod | 2 | ||||
| -rw-r--r-- | pod/perlxstut.pod | 6 |
17 files changed, 680 insertions, 93 deletions
diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL index 6c43035889..a89c4c98eb 100644 --- a/pod/buildtoc.PL +++ b/pod/buildtoc.PL @@ -169,6 +169,7 @@ if (-d "pod") { perlos2 perlos390 perlsolaris + perltru64 perlvmesa perlvms perlvos @@ -190,6 +191,7 @@ if (-d "pod") { perlos2 perlos390 perlsolaris + perltru64 perlvmesa perlvms perlvos diff --git a/pod/perl.pod b/pod/perl.pod index c047d347d5..fd15c1725c 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -123,6 +123,7 @@ For ease of access, the Perl manual has been split up into several sections: perlos2 Perl notes for OS/2 perlos390 Perl notes for OS/390 perlsolaris Perl notes for Solaris + perltru64 Perl notes for Tru64 perlvmesa Perl notes for VM/ESA perlvms Perl notes for VMS perlvos Perl notes for Stratus VOS diff --git a/pod/perl5005delta.pod b/pod/perl5005delta.pod index 78bf90f616..c60d37c3e6 100644 --- a/pod/perl5005delta.pod +++ b/pod/perl5005delta.pod @@ -145,7 +145,7 @@ Most of the Perl documentation was previously under the implicit GNU General Public License or the Artistic License (at the user's choice). Now much of the documentation unambiguously states the terms under which it may be distributed. Those terms are in general much less restrictive -than the GNU GPL. See L<perl> and the individual perl man pages listed +than the GNU GPL. See L<perl> and the individual perl manpages listed therein. =head1 Core Changes diff --git a/pod/perl571delta.pod b/pod/perl571delta.pod index 9a069beebb..df132ccf77 100644 --- a/pod/perl571delta.pod +++ b/pod/perl571delta.pod @@ -62,7 +62,7 @@ natively, ASCII or EBCDIC, unless GLOB_ALPHASORT is specified.) =head1 Core Enhancements -=head1 AUTOLOAD Is Now Lvaluable +=head2 AUTOLOAD Is Now Lvaluable AUTOLOAD is now lvaluable, meaning that you can add the :lvalue attribute to AUTOLOAD subroutines and you can assign to the AUTOLOAD return value. diff --git a/pod/perlapi.pod b/pod/perlapi.pod index ca4d5e6a97..824ec5948e 100644 --- a/pod/perlapi.pod +++ b/pod/perlapi.pod @@ -318,7 +318,7 @@ L<perlsub/"Constant Functions">. SV* cv_const_sv(CV* cv) =for hackers -Found in file op.c +Found in file opmini.c =item dMARK @@ -1100,7 +1100,7 @@ method, similar to C<use Foo::Bar VERSION LIST>. void load_module(U32 flags, SV* name, SV* ver, ...) =for hackers -Found in file op.c +Found in file opmini.c =item looks_like_number @@ -1239,7 +1239,7 @@ eligible for inlining at compile-time. CV* newCONSTSUB(HV* stash, char* name, SV* sv) =for hackers -Found in file op.c +Found in file opmini.c =item newHV @@ -1385,7 +1385,7 @@ Found in file sv.c Used by C<xsubpp> to hook up XSUBs as Perl subs. =for hackers -Found in file op.c +Found in file opmini.c =item newXSproto @@ -2208,7 +2208,7 @@ Found in file sv.h Tells an SV that it is a string and disables all other OK bits, and leaves the UTF8 status as it was. - + void SvPOK_only_UTF8(SV* sv) =for hackers @@ -2608,6 +2608,20 @@ Handles 'get' magic, but not 'set' magic. See C<sv_catpvn_mg>. =for hackers Found in file sv.c +=item sv_catpvn_flags + +Concatenates the string onto the end of the string which is in the SV. The +C<len> indicates number of bytes to copy. If the SV has the UTF8 +status set, then the bytes appended should be valid UTF8. +If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<dsv> if +appropriate, else not. C<sv_catpvn> and C<sv_catpvn_nomg> are implemented +in terms of this function. + + void sv_catpvn_flags(SV* sv, const char* ptr, STRLEN len, I32 flags) + +=for hackers +Found in file sv.c + =item sv_catpvn_mg Like C<sv_catpvn>, but also handles 'set' magic. @@ -2637,6 +2651,18 @@ not 'set' magic. See C<sv_catsv_mg>. =for hackers Found in file sv.c +=item sv_catsv_flags + +Concatenates the string from SV C<ssv> onto the end of the string in +SV C<dsv>. Modifies C<dsv> but not C<ssv>. If C<flags> has C<SV_GMAGIC> +bit set, will C<mg_get> on the SVs if appropriate, else not. C<sv_catsv> +and C<sv_catsv_nomg> are implemented in terms of this function. + + void sv_catsv_flags(SV* dsv, SV* ssv, I32 flags) + +=for hackers +Found in file sv.c + =item sv_catsv_mg Like C<sv_catsv>, but also handles 'set' magic. @@ -2846,6 +2872,18 @@ Get a sensible string out of the SV somehow. =for hackers Found in file sv.c +=item sv_pvn_force_flags + +Get a sensible string out of the SV somehow. +If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<sv> if +appropriate, else not. C<sv_pvn_force> and C<sv_pvn_force_nomg> are +implemented in terms of this function. + + char* sv_pvn_force_flags(SV* sv, STRLEN* lp, I32 flags) + +=for hackers +Found in file sv.c + =item sv_pvutf8n_force Get a sensible UTF8-encoded string out of the SV somehow. See @@ -3083,6 +3121,19 @@ C<sv_setsv_mg>. =for hackers Found in file sv.c +=item sv_setsv_flags + +Copies the contents of the source SV C<ssv> into the destination SV C<dsv>. +The source SV may be destroyed if it is mortal. Does not handle 'set' +magic. If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<ssv> if +appropriate, else not. C<sv_setsv> and C<sv_setsv_nomg> are implemented +in terms of this function. + + void sv_setsv_flags(SV* dsv, SV* ssv, I32 flags) + +=for hackers +Found in file sv.c + =item sv_setsv_mg Like C<sv_setsv>, but also handles 'set' magic. @@ -3242,6 +3293,20 @@ if all the bytes have hibit clear. =for hackers Found in file sv.c +=item sv_utf8_upgrade_flags + +Convert the PV of an SV to its UTF8-encoded form. +Forces the SV to string form it it is not already. +Always sets the SvUTF8 flag to avoid future validity checks even +if all the bytes have hibit clear. If C<flags> has C<SV_GMAGIC> bit set, +will C<mg_get> on C<sv> if appropriate, else not. C<sv_utf8_upgrade> and +C<sv_utf8_upgrade_nomg> are implemented in terms of this function. + + STRLEN sv_utf8_upgrade_flags(SV *sv, I32 flags) + +=for hackers +Found in file sv.c + =item sv_vcatpvfn Processes its arguments like C<vsprintf> and appends the formatted output diff --git a/pod/perldebtut.pod b/pod/perldebtut.pod index e11102e567..693e938e94 100644 --- a/pod/perldebtut.pod +++ b/pod/perldebtut.pod @@ -666,7 +666,7 @@ and there's a B<vi> interface too. You don't have to do this all on the command line, though, there are a few GUI options out there. The nice thing about these is you can wave a mouse over a -variable and a dump of it's data will appear in an appropriate window, or in a +variable and a dump of its data will appear in an appropriate window, or in a popup balloon, no more tiresome typing of 'x $varname' :-) In particular have a hunt around for the following: diff --git a/pod/perlebcdic.pod b/pod/perlebcdic.pod index ccfe1392ba..c98b46c6e7 100644 --- a/pod/perlebcdic.pod +++ b/pod/perlebcdic.pod @@ -45,7 +45,7 @@ A particular 8-bit extension to ASCII that includes grave and acute accented Latin characters. Languages that can employ ISO 8859-1 include all the languages covered by ASCII as well as Afrikaans, Albanian, Basque, Catalan, Danish, Faroese, Finnish, Norwegian, -Portugese, Spanish, and Swedish. Dutch is covered albeit without +Portuguese, Spanish, and Swedish. Dutch is covered albeit without the ij ligature. French is covered too but without the oe ligature. German can use ISO 8859-1 but must do so without German-style quotation marks. This set is based on Western European extensions @@ -597,7 +597,7 @@ XPG operability often implies the presence of an I<iconv> utility available from the shell or from the C library. Consult your system's documentation for information on iconv. -On OS/390 or z/OS see the iconv(1) man page. One way to invoke the iconv +On OS/390 or z/OS see the iconv(1) manpage. One way to invoke the iconv shell utility from within perl would be to: # OS/390 or z/OS example @@ -1243,7 +1243,7 @@ translation difficulties. In particular one popular nroff implementation was known to strip accented characters to their unaccented counterparts while attempting to view this document through the B<pod2man> program (for example, you may see a plain C<y> rather than one with a diaeresis -as in E<yuml>). Another nroff truncated the resultant man page at +as in E<yuml>). Another nroff truncated the resultant manpage at the first occurrence of 8 bit characters. Not all shells will allow multiple C<-e> string arguments to perl to diff --git a/pod/perlfaq3.pod b/pod/perlfaq3.pod index fdfa26d277..dabe5687a5 100644 --- a/pod/perlfaq3.pod +++ b/pod/perlfaq3.pod @@ -11,7 +11,7 @@ and programming support. Have you looked at CPAN (see L<perlfaq2>)? The chances are that someone has already written a module that can solve your problem. -Have you read the appropriate man pages? Here's a brief index: +Have you read the appropriate manpages? Here's a brief index: Basics perldata, perlvar, perlsyn, perlop, perlsub Execution perlrun, perldebug @@ -25,12 +25,12 @@ Have you read the appropriate man pages? Here's a brief index: Various http://www.perl.com/CPAN/doc/FMTEYEWTK/index.html (not a man-page but still useful) -A crude table of contents for the Perl man page set is found in L<perltoc>. +A crude table of contents for the Perl manpage set is found in L<perltoc>. =head2 How can I use Perl interactively? The typical approach uses the Perl debugger, described in the -perldebug(1) man page, on an ``empty'' program, like this: +perldebug(1) manpage, on an ``empty'' program, like this: perl -de 42 diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index c2b9f39f66..89123011ca 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -4291,6 +4291,12 @@ loop control operators described in L<perlsyn> or with C<goto>. When C<use locale> is in effect, C<sort LIST> sorts LIST according to the current collation locale. See L<perllocale>. +Perl does B<not> guarantee that sort is stable. (A I<stable> sort +preserves the input order of elements that compare equal.) 5.7 and +5.8 happen to use a stable mergesort, but 5.6 and earlier used quicksort, +which is not stable. Do not assume that future perls will continue to +use a stable sort. + Examples: # sort lexically @@ -5616,6 +5622,13 @@ command if the files already exist: $now = time; utime $now, $now, @ARGV; +If the first two elements of the list are C<undef>, then the utime(2) +function in the C library will be called with a null second argument. +On most systems, this will set the file's access and modification +times to the current time. (i.e. equivalent to the example above.) + + utime undef, undef, @ARGV; + =item values HASH Returns a list consisting of all the values of the named hash. (In a diff --git a/pod/perlguts.pod b/pod/perlguts.pod index 391cf8ae74..44f3640183 100644 --- a/pod/perlguts.pod +++ b/pod/perlguts.pod @@ -1289,7 +1289,7 @@ where C<SP> is the macro that represents the local copy of the stack pointer, and C<num> is the number of elements the stack should be extended by. Now that there is room on the stack, values can be pushed on it using C<PUSHs> -macro. The values pushed will often need to be "mortal" (See L</Reference Counts and Mortality). +macro. The values pushed will often need to be "mortal" (See L</Reference Counts and Mortality>). PUSHs(sv_2mortal(newSViv(an_integer))) PUSHs(sv_2mortal(newSVpv("Some String",0))) diff --git a/pod/perlhack.pod b/pod/perlhack.pod index 94c6dfd96b..6b67e5706b 100644 --- a/pod/perlhack.pod +++ b/pod/perlhack.pod @@ -273,7 +273,7 @@ From http://rsync.samba.org/README.html: "Rsync uses rsh or ssh for communication. It does not need to be setuid and requires no special privileges for installation. It - does not require a inetd entry or a deamon. You must, however, + does not require an inetd entry or a daemon. You must, however, have a working rsh or ssh system. Using ssh is recommended for its security features." @@ -434,7 +434,7 @@ look how others apply the fix. =item Finding the source of misbehaviour When you keep in sync with bleadperl, the pumpking would love to -I<see> that the community efforts realy work. So after each of his +I<see> that the community efforts really work. So after each of his sync points, you are to 'make test' to check if everything is still in working order. If it is, you do 'make ok', which will send an OK report to perlbug@perl.org. (If you do not have access to a mailer @@ -442,7 +442,7 @@ from the system you just finished successfully 'make test', you can do 'make okfile', which creates the file C<perl.ok>, which you can than take to your favourite mailer and mail yourself). -But of course, as always, things will not allways lead to a success +But of course, as always, things will not always lead to a success path, and one or more test do not pass the 'make test'. Before sending in a bug report (using 'make nok' or 'make nokfile'), check the mailing list if someone else has reported the bug already and if @@ -1813,9 +1813,9 @@ In Tru64 the following options are available: =over 4 -=item -p[rodecures] +=item -p[rocedures] -Procecures sorted in descending order by the number of cycles executed +Procedures sorted in descending order by the number of cycles executed in each procedure. Useful for finding the hotspot procedures. (This is the default option.) diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index f63a984d07..1310b14bb0 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -374,6 +374,10 @@ Exporter guts Utilities to replace common UNIX commands in Makefiles etc. +=item ExtUtils::Constant + +Generate XS code to import C header constants + =item ExtUtils::Embed Utilities for embedding Perl in C/C++ applications @@ -538,6 +542,14 @@ Process single-character switches with switch clustering Compare 8-bit scalar data according to the current locale +=item I18N::LangTags + +Functions for dealing with RFC3066-style language tags + +=item I18N::LangTags::List + +List of tags for human languages + =item IO Load various IO modules @@ -566,6 +578,14 @@ ISO three letter codes for currency identification (ISO 4217) ISO two letter codes for language identification (ISO 639) +=item Locale::Maketext + +Framework for localization + +=item Locale::Maketext::TPJ13 + +Article about software localization + =item Math::BigFloat Arbitrary length float math package diff --git a/pod/perlnewmod.pod b/pod/perlnewmod.pod index ace8d85130..ccac5dc383 100644 --- a/pod/perlnewmod.pod +++ b/pod/perlnewmod.pod @@ -239,18 +239,21 @@ it connected to the rest of the CPAN, you'll need to tell the modules list about it. The best way to do this is to email them a line in the style of the modules list, like this: - Net::Acme bdpO Interface to Acme Frobnicator servers FOOBAR - ^ ^^^^ ^ ^ - | |||| Module description Your ID - | |||| - | |||\- Interface: (O)OP, (r)eferences, (h)ybrid, (f)unctions - | ||| - | ||\-- Language: (p)ure Perl, C(+)+, (h)ybrid, (C), (o)ther - | || - Module |\--- Support: (d)eveloper, (m)ailing list, (u)senet, (n)one - Name | - \---- Maturity: (i)dea, (c)onstructions, (a)lpha, (b)eta, - (R)eleased, (M)ature, (S)tandard + Net::Acme bdpOP Interface to Acme Frobnicator servers FOOBAR + ^ ^^^^^ ^ ^ + | ||||| Module description Your ID + | ||||| + | ||||\-Public Licence: (p)standard Perl, (g)GPL, (b)BSD, + | |||| (l)LGPL, (a)rtistic, (o)ther + | |||| + | |||\- Interface: (O)OP, (r)eferences, (h)ybrid, (f)unctions + | ||| + | ||\-- Language: (p)ure Perl, C(+)+, (h)ybrid, (C), (o)ther + | || + Module |\--- Support: (d)eveloper, (m)ailing list, (u)senet, (n)one + Name | + \---- Development: (i)dea, (c)onstructions, (a)lpha, (b)eta, + (R)eleased, (M)ature, (S)tandard plus a description of the module and why you think it should be included. If you hear nothing back, that means your module will diff --git a/pod/perltoc.pod b/pod/perltoc.pod index a75f39ea1f..35e70e3c46 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -361,16 +361,16 @@ lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open -FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir -DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, 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 +FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, +open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR +: ATTRIBUTES, 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 @@ -3903,18 +3903,19 @@ SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv, -sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, -sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec, -sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, -sv_isa, sv_isobject, sv_len, sv_len_utf8, sv_magic, sv_mortalcopy, -sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace, -sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, -sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, -sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, -sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, -sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, -sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, -sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER, +sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, +sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, +sv_cmp, sv_cmp_locale, sv_dec, sv_derived_from, sv_eq, sv_free, sv_gets, +sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_len, sv_len_utf8, +sv_magic, sv_mortalcopy, sv_newmortal, sv_pvn_force, sv_pvn_force_flags, +sv_pvutf8n_force, sv_reftype, sv_replace, sv_rvweaken, sv_setiv, +sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, +sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, +sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, +sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_true, +sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, sv_usepvn_mg, +sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, +sv_utf8_upgrade_flags, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, @@ -4076,6 +4077,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item use Thread for iThreads +=item make perl_clone optionally clone ops + =item Work out exit/die semantics for threads =item Typed lexicals for compiler @@ -4214,12 +4217,13 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Rewrite perldoc -=item Install .3p man pages +=item Install .3p manpages =item Unicode tutorial =item Update POSIX.pm for 1003.1-2 -=head2 Retargetable installation + +=item Retargetable installation =item POSIX emulation on non-POSIX systems @@ -4242,8 +4246,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Make tr/// return histogram =item Compile to real threaded code -=head2 Structured types -=head2 Modifiable $1 et al. + +=item Structured types + +=item Modifiable $1 et al. =item Procedural interfaces for IO::*, etc. @@ -4352,10 +4358,12 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Lexically scoped typeglobs =item format BOTTOM -=head2 report HANDLE + +=item report HANDLE =item Generalised want()/caller()) -=head2 Named prototypes + +=item Named prototypes =item Built-in globbing @@ -4466,9 +4474,13 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug =item PERL_DESTRUCT_LEVEL +=item Gprof Profiling + +-a, -b, -e routine, -f routine, -s, -z + =item Pixie Profiling --h, -l, -p[rodecures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, +-h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, -z[ero] =item CONCLUSION @@ -4535,6 +4547,8 @@ I<The Road goes ever on and on, down from the door where it began.> =item Incompatible Changes +=item Future Deprecations + =item Core Enhancements =item Modules and Pragmata @@ -4635,10 +4649,10 @@ I<The Road goes ever on and on, down from the door where it began.> =item Core Enhancements -=item AUTOLOAD Is Now Lvaluable - =over 4 +=item AUTOLOAD Is Now Lvaluable + =item PerlIO is Now The Default =item Signals Are Now Safe @@ -5676,14 +5690,12 @@ finally close()d =over 4 -=item Prerequisites +=item Build Prerequisites =item Getting the perl source =item Making - remember to use a hefty wad of stack (I use 2000000) - =item Testing =item Installing the built perl @@ -5857,6 +5869,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 Building 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 @@ -5918,6 +5974,8 @@ Source, Compiled Module Source, Perl Modules/Scripts =item Portability Between PA-RISC Versions +=item Itanium Processor Family + =item Building Dynamic Extensions on HP-UX =item The HP ANSI C Compiler @@ -5934,6 +5992,8 @@ Source, Compiled Module Source, Perl Modules/Scripts =item perl -P and // +=item Kernel parameters (maxdsiz) + =back =item AUTHOR @@ -5983,26 +6043,41 @@ op/lexassign.t, pragma/warnings.t =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE -=head1 SYNOPSIS - =over 4 +=item SYNOPSIS + +=item NOTE + =item What's New +=item Welcome + =item System Requirements =item How to Obtain Perl/iX =item Distribution Contents Highlights -README, public_html/feedback.cgi, 4, 6 +README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, +public_html/feedback.cgi, src/perl-5.6.0-mpe + +=item How to Compile Perl/iX + + 4, 6 =item Getting Started with Perl/iX =item MPE/iX Implementation Considerations +=item Known Bugs Under Investigation + +=item To-Do List + =item Change History +=item Author + =back =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. @@ -6383,6 +6458,33 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back +=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as +Digital UNIX formerly known as DEC OSF/1) systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Compiling Perl 5 on Tru64 + +=item Using Large Files with Perl on Tru64 + +=item Threaded Perl on Tru64 + +=item 64-bit Perl on Tru64 + +=item Warnings about floating-point overflow when compiling Perl on Tru64 + +=back + +=item Testing Perl on Tru64 + +=item AUTHOR + +=back + =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. =over 4 @@ -6399,21 +6501,10 @@ DATAMODEL_NATIVE specified", sh: ar: not found =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 @@ -6541,6 +6632,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) @@ -8372,13 +8505,9 @@ C<byacc>, C<byteorder> C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>, C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>, C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>, -C<clocktype>, C<comm>, C<compress> - -=item C - -C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>, -C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>, -C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh> +C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, +C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, +C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh> =item d @@ -9292,6 +9421,45 @@ test_f file =back +=head2 ExtUtils::Constant - generate XS code to import C header constants + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USAGE + +IV, UV, NV, PV, PVN + +=item FUNCTIONS + +=back + +C_stringify NAME + +constant_types + +memEQ_clause NAME, CHECKED_AT, INDENT + +return_clause VALUE, TYPE, INDENT, MACRO + +params WHAT + +C_constant SUBNAME, DEFAULT_TYPE, TYPES, INDENT, NAMELEN, ITEM.., name, +type, value, macro + +XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME + +autoload PACKAGE, VERSION + +=over 4 + +=item AUTHOR + +=back + =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications =over 4 @@ -10728,6 +10896,209 @@ locale =back +=head2 I18N::LangTags - functions for dealing with RFC3066-style language +tags + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +the function is_language_tag($lang1) + +the function extract_language_tags($whatever) + +the function same_language_tag($lang1, $lang2) + +the function similarity_language_tag($lang1, $lang2) + +the function is_dialect_of($lang1, $lang2) + +the function super_languages($lang1) + +the function locale2language_tag($locale_identifier) + +the function encode_language_tag($lang1) + +the function alternate_language_tags($lang1) + +=over 4 + +=item ABOUT LOWERCASING + +=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHOR + +=back + +=head2 I18N::LangTags::List, I18n::LangTags::List -- list of tags for human +languages + +=over 4 + +=item SYNOPSIS + +=item ABOUT LANGUAGE TAGS + +=item LIST OF LANGUAGES + +I<{ab}> : Abkhazian, I<{ace}> : Achinese, I<{ach}> : Acoli, I<{ada}> : +Adangme, I<{aa}> : Afar, I<{afh}> : Afrihili, I<{af}> : Afrikaans, +[I<{afa}> : Afro-Asiatic (Other)], I<{aka}> : Akan, I<{akk}> : Akkadian, +I<{sq}> : Albanian, I<{ale}> : Aleut, [I<{alg}> : Algonquian languages], +[I<{tut}> : Altaic (Other)], I<{am}> : Amharic, I<{i-ami}> : Ami, [I<{apa}> +: Apache languages], I<{ar}> : Arabic, I<{arc}> : Aramaic, I<{arp}> : +Arapaho, I<{arn}> : Araucanian, I<{arw}> : Arawak, I<{hy}> : Armenian, +[I<{art}> : Artificial (Other)], I<{as}> : Assamese, [I<{ath}> : Athapascan +languages], [I<{aus}> : Australian languages], [I<{map}> : Austronesian +(Other)], I<{ava}> : Avaric, I<{ae}> : Avestan, I<{awa}> : Awadhi, I<{ay}> +: Aymara, I<{az}> : Azerbaijani, I<{ban}> : Balinese, [I<{bat}> : Baltic +(Other)], I<{bal}> : Baluchi, I<{bam}> : Bambara, [I<{bai}> : Bamileke +languages], I<{bad}> : Banda, [I<{bnt}> : Bantu (Other)], I<{bas}> : Basa, +I<{ba}> : Bashkir, I<{eu}> : Basque, I<{btk}> : Batak (Indonesia), I<{bej}> +: Beja, I<{be}> : Belarusian, I<{bem}> : Bemba, I<{bn}> : Bengali, +[I<{ber}> : Berber (Other)], I<{bho}> : Bhojpuri, I<{bh}> : Bihari, +I<{bik}> : Bikol, I<{bin}> : Bini, I<{bi}> : Bislama, I<{bs}> : Bosnian, +I<{bra}> : Braj, I<{br}> : Breton, I<{bug}> : Buginese, I<{bg}> : +Bulgarian, I<{i-bnn}> : Bunun, I<{bua}> : Buriat, I<{my}> : Burmese, +I<{cad}> : Caddo, I<{car}> : Carib, I<{ca}> : Catalan, [I<{cau}> : +Caucasian (Other)], I<{ceb}> : Cebuano, [I<{cel}> : Celtic (Other)], +[I<{cai}> : Central American Indian (Other)], I<{chg}> : Chagatai, +[I<{cmc}> : Chamic languages], I<{ch}> : Chamorro, I<{ce}> : Chechen, +I<{chr}> : Cherokee, I<{chy}> : Cheyenne, I<{chb}> : Chibcha, I<{ny}> : +Chichewa, I<{zh}> : Chinese, I<{chn}> : Chinook Jargon, I<{chp}> : +Chipewyan, I<{cho}> : Choctaw, I<{cu}> : Church Slavic, I<{chk}> : +Chuukese, I<{cv}> : Chuvash, I<{cop}> : Coptic, I<{kw}> : Cornish, I<{co}> +: Corsican, I<{cre}> : Cree, I<{mus}> : Creek, [I<{cpe}> : English-based +Creoles and pidgins (Other)], [I<{cpf}> : French-based Creoles and pidgins +(Other)], [I<{cpp}> : Portuguese-based Creoles and pidgins (Other)], +[I<{crp}> : Creoles and pidgins (Other)], I<{hr}> : Croatian, [I<{cus}> : +Cushitic (Other)], I<{cs}> : Czech, I<{dak}> : Dakota, I<{da}> : Danish, +I<{day}> : Dayak, I<{i-default}> : Default (Fallthru) Language, I<{del}> : +Delaware, I<{din}> : Dinka, I<{div}> : Divehi, I<{doi}> : Dogri, I<{dgr}> : +Dogrib, [I<{dra}> : Dravidian (Other)], I<{dua}> : Duala, I<{nl}> : Dutch, +I<{dum}> : Middle Dutch (ca.1050-1350), I<{dyu}> : Dyula, I<{dz}> : +Dzongkha, I<{efi}> : Efik, I<{egy}> : Ancient Egyptian, I<{eka}> : Ekajuk, +I<{elx}> : Elamite, I<{en}> : English, I<{enm}> : Old English (1100-1500), +I<{ang}> : Old English (ca.450-1100), I<{eo}> : Esperanto, I<{et}> : +Estonian, I<{ewe}> : Ewe, I<{ewo}> : Ewondo, I<{fan}> : Fang, I<{fat}> : +Fanti, I<{fo}> : Faroese, I<{fj}> : Fijian, I<{fi}> : Finnish, [I<{fiu}> : +Finno-Ugrian (Other)], I<{fon}> : Fon, I<{fr}> : French, I<{frm}> : Middle +French (ca.1400-1600), I<{fro}> : Old French (842-ca.1400), I<{fy}> : +Frisian, I<{fur}> : Friulian, I<{ful}> : Fulah, I<{gaa}> : Ga, I<{gd}> : +Scots Gaelic, I<{gl}> : Gallegan, I<{lug}> : Ganda, I<{gay}> : Gayo, +I<{gba}> : Gbaya, I<{gez}> : Geez, I<{ka}> : Georgian, I<{de}> : German, +I<{gmh}> : Middle High German (ca.1050-1500), I<{goh}> : Old High German +(ca.750-1050), [I<{gem}> : Germanic (Other)], I<{gil}> : Gilbertese, +I<{gon}> : Gondi, I<{gor}> : Gorontalo, I<{got}> : Gothic, I<{grb}> : +Grebo, I<{grc}> : Ancient Greek (to 1453), I<{el}> : Modern Greek (1453-), +I<{gn}> : Guarani, I<{gu}> : Gujarati, I<{gwi}> : Gwich'in, I<{hai}> : +Haida, I<{ha}> : Hausa, I<{haw}> : Hawaiian, I<{he}> : Hebrew, I<{hz}> : +Herero, I<{hil}> : Hiligaynon, I<{him}> : Himachali, I<{hi}> : Hindi, +I<{ho}> : Hiri Motu, I<{hit}> : Hittite, I<{hmn}> : Hmong, I<{hu}> : +Hungarian, I<{hup}> : Hupa, I<{iba}> : Iban, I<{is}> : Icelandic, I<{ibo}> +: Igbo, I<{ijo}> : Ijo, I<{ilo}> : Iloko, [I<{inc}> : Indic (Other)], +[I<{ine}> : Indo-European (Other)], I<{id}> : Indonesian, I<{ia}> : +Interlingua (International Auxiliary Language Association), I<{ie}> : +Interlingue, I<{iu}> : Inuktitut, I<{ik}> : Inupiaq, [I<{ira}> : Iranian +(Other)], I<{ga}> : Irish, I<{mga}> : Middle Irish (900-1200), I<{sga}> : +Old Irish (to 900), [I<{iro}> : Iroquoian languages], I<{it}> : Italian, +I<{ja}> : Japanese, I<{jw}> : Javanese, I<{jrb}> : Judeo-Arabic, I<{jpr}> : +Judeo-Persian, I<{kab}> : Kabyle, I<{kac}> : Kachin, I<{kl}> : Kalaallisut, +I<{kam}> : Kamba, I<{kn}> : Kannada, I<{kau}> : Kanuri, I<{kaa}> : +Kara-Kalpak, I<{kar}> : Karen, I<{ks}> : Kashmiri, I<{kaw}> : Kawi, I<{kk}> +: Kazakh, I<{kha}> : Khasi, I<{km}> : Khmer, [I<{khi}> : Khoisan (Other)], +I<{kho}> : Khotanese, I<{ki}> : Kikuyu, I<{kmb}> : Kimbundu, I<{rw}> : +Kinyarwanda, I<{ky}> : Kirghiz, I<{i-klingon}> : Klingon, I<{kv}> : Komi, +I<{kon}> : Kongo, I<{kok}> : Konkani, I<{ko}> : Korean, I<{kos}> : +Kosraean, I<{kpe}> : Kpelle, I<{kro}> : Kru, I<{kj}> : Kuanyama, I<{kum}> : +Kumyk, I<{ku}> : Kurdish, I<{kru}> : Kurukh, I<{kut}> : Kutenai, I<{lad}> : +Ladino, I<{lah}> : Lahnda, I<{lam}> : Lamba, I<{lo}> : Lao, I<{la}> : +Latin, I<{lv}> : Latvian, I<{lb}> : Letzeburgesch, I<{lez}> : Lezghian, +I<{ln}> : Lingala, I<{lt}> : Lithuanian, I<{nds}> : Low German, I<{loz}> : +Lozi, I<{lub}> : Luba-Katanga, I<{lua}> : Luba-Lulua, I<{lui}> : Luiseno, +I<{lun}> : Lunda, I<{luo}> : Luo (Kenya and Tanzania), I<{lus}> : Lushai, +I<{mk}> : Macedonian, I<{mad}> : Madurese, I<{mag}> : Magahi, I<{mai}> : +Maithili, I<{mak}> : Makasar, I<{mg}> : Malagasy, I<{ms}> : Malay, I<{ml}> +: Malayalam, I<{mt}> : Maltese, I<{mnc}> : Manchu, I<{mdr}> : Mandar, +I<{man}> : Mandingo, I<{mni}> : Manipuri, [I<{mno}> : Manobo languages], +I<{gv}> : Manx, I<{mi}> : Maori, I<{mr}> : Marathi, I<{chm}> : Mari, +I<{mh}> : Marshall, I<{mwr}> : Marwari, I<{mas}> : Masai, [I<{myn}> : Mayan +languages], I<{men}> : Mende, I<{mic}> : Micmac, I<{min}> : Minangkabau, +I<{i-mingo}> : Mingo, [I<{mis}> : Miscellaneous languages], I<{moh}> : +Mohawk, I<{mo}> : Moldavian, [I<{mkh}> : Mon-Khmer (Other)], I<{lol}> : +Mongo, I<{mn}> : Mongolian, I<{mos}> : Mossi, [I<{mul}> : Multiple +languages], [I<{mun}> : Munda languages], I<{nah}> : Nahuatl, I<{na}> : +Nauru, I<{nv}> : Navajo, I<{nd}> : North Ndebele, I<{nr}> : South Ndebele, +I<{ng}> : Ndonga, I<{ne}> : Nepali, I<{new}> : Newari, I<{nia}> : Nias, +[I<{nic}> : Niger-Kordofanian (Other)], [I<{ssa}> : Nilo-Saharan (Other)], +I<{niu}> : Niuean, I<{non}> : Old Norse, [I<{nai}> : North American +Indian], I<{se}> : Northern Sami, I<{no}> : Norwegian, I<{nb}> : Norwegian +BokmE<aring>l, I<{nn}> : Norwegian Nynorsk, [I<{nub}> : Nubian languages], +I<{nym}> : Nyamwezi, I<{nyn}> : Nyankole, I<{nyo}> : Nyoro, I<{nzi}> : +Nzima, I<{oc}> : Occitan (post 1500), I<{oji}> : Ojibwa, I<{or}> : Oriya, +I<{om}> : Oromo, I<{osa}> : Osage, I<{os}> : Ossetian; Ossetic, [I<{oto}> : +Otomian languages], I<{pal}> : Pahlavi, I<{i-pwn}> : Paiwan, I<{pau}> : +Palauan, I<{pi}> : Pali, I<{pam}> : Pampanga, I<{pag}> : Pangasinan, +I<{pa}> : Panjabi, I<{pap}> : Papiamento, [I<{paa}> : Papuan (Other)], +I<{fa}> : Persian, I<{peo}> : Old Persian (ca.600-400 B.C.), [I<{phi}> : +Philippine (Other)], I<{phn}> : Phoenician, I<{pon}> : Pohnpeian, I<{pl}> : +Polish, I<{pt}> : Portuguese, [I<{pra}> : Prakrit languages], I<{pro}> : +Old ProvenE<ccedil>al (to 1500), I<{ps}> : Pushto, I<{qu}> : Quechua, +I<{rm}> : Raeto-Romance, I<{raj}> : Rajasthani, I<{rap}> : Rapanui, +I<{rar}> : Rarotongan, [I<{qaa}>-I<qtz> : Reserved for local use.], +[I<{roa}> : Romance (Other)], I<{ro}> : Romanian, I<{rom}> : Romany, +I<{rn}> : Rundi, I<{ru}> : Russian, [I<{sal}> : Salishan languages], +I<{sam}> : Samaritan Aramaic, [I<{smi}> : Sami languages (Other)], I<{sm}> +: Samoan, I<{sad}> : Sandawe, I<{sg}> : Sango, I<{sa}> : Sanskrit, I<{sat}> +: Santali, I<{sc}> : Sardinian, I<{sas}> : Sasak, I<{sco}> : Scots, +I<{sel}> : Selkup, [I<{sem}> : Semitic (Other)], I<{sr}> : Serbian, +I<{srr}> : Serer, I<{shn}> : Shan, I<{sn}> : Shona, I<{sid}> : Sidamo, +I<{sgn-...}> : Sign Languages, I<{bla}> : Siksika, I<{sd}> : Sindhi, +I<{si}> : Sinhalese, [I<{sit}> : Sino-Tibetan (Other)], [I<{sio}> : Siouan +languages], I<{den}> : Slave (Athapascan), [I<{sla}> : Slavic (Other)], +I<{sk}> : Slovak, I<{sl}> : Slovenian, I<{sog}> : Sogdian, I<{so}> : +Somali, I<{son}> : Songhai, I<{snk}> : Soninke, I<{wen}> : Sorbian +languages, I<{nso}> : Northern Sotho, I<{st}> : Southern Sotho, [I<{sai}> : +South American Indian (Other)], I<{es}> : Spanish, I<{suk}> : Sukuma, +I<{sux}> : Sumerian, I<{su}> : Sundanese, I<{sus}> : Susu, I<{sw}> : +Swahili, I<{ss}> : Swati, I<{sv}> : Swedish, I<{syr}> : Syriac, I<{tl}> : +Tagalog, I<{ty}> : Tahitian, [I<{tai}> : Tai (Other)], I<{tg}> : Tajik, +I<{tmh}> : Tamashek, I<{ta}> : Tamil, I<{i-tao}> : Tao, I<{tt}> : Tatar, +I<{i-tay}> : Tayal, I<{te}> : Telugu, I<{ter}> : Tereno, I<{tet}> : Tetum, +I<{th}> : Thai, I<{bo}> : Tibetan, I<{tig}> : Tigre, I<{ti}> : Tigrinya, +I<{tem}> : Timne, I<{tiv}> : Tiv, I<{tli}> : Tlingit, I<{tpi}> : Tok Pisin, +I<{tkl}> : Tokelau, I<{tog}> : Tonga (Nyasa), I<{to}> : Tonga (Tonga +Islands), I<{tsi}> : Tsimshian, I<{ts}> : Tsonga, I<{i-tsu}> : Tsou, +I<{tn}> : Tswana, I<{tum}> : Tumbuka, I<{tr}> : Turkish, I<{ota}> : Ottoman +Turkish (1500-1928), I<{tk}> : Turkmen, I<{tvl}> : Tuvalu, I<{tyv}> : +Tuvinian, I<{tw}> : Twi, I<{uga}> : Ugaritic, I<{ug}> : Uighur, I<{uk}> : +Ukrainian, I<{umb}> : Umbundu, I<{und}> : Undetermined, I<{ur}> : Urdu, +I<{uz}> : Uzbek, I<{vai}> : Vai, I<{ven}> : Venda, I<{vi}> : Vietnamese, +I<{vo}> : VolapE<uuml>k, I<{vot}> : Votic, [I<{wak}> : Wakashan languages], +I<{wal}> : Walamo, I<{war}> : Waray, I<{was}> : Washo, I<{cy}> : Welsh, +I<{wo}> : Wolof, I<{x-...}> : Unregistered (Private Use), I<{xh}> : Xhosa, +I<{sah}> : Yakut, I<{yao}> : Yao, I<{yap}> : Yapese, I<{yi}> : Yiddish, +I<{yo}> : Yoruba, [I<{ypk}> : Yupik languages], I<{znd}> : Zande, [I<{zap}> +: Zapotec], I<{zen}> : Zenaga, I<{za}> : Zhuang, I<{zu}> : Zulu, I<{zun}> : +Zuni + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMER + +=item AUTHOR + +=back + =head2 IO - load various IO modules =over 4 @@ -11585,6 +11956,101 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =back +=head2 Locale::Maketext -- framework for localization + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item QUICK OVERVIEW + +=item METHODS + +=over 4 + +=item Construction Methods + +$lh = YourProjClass->get_handle( ...langtags... ) || die "lg-handle?";, $lh += YourProjClass->get_handleB<()> || die "lg-handle?";, $lh = +YourProjClass::langname->new();, $lh->init();, +YourProjClass->fallback_languages(), +YourProjClass->fallback_language_classes() + +=item The "maketext" Method + +$lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto + +=item Utility Methods + +$language->quant($number, $singular), $language->quant($number, $singular, +$plural), $language->quant($number, $singular, $plural, $negative), +$language->numf($number), $language->sprintf($format, @items), +$language->language_tag(), $language->encoding() + +=item Language Handle Attributes and Internals + +=back + +=item LANGUAGE CLASS HIERARCHIES + +=item ENTRIES IN EACH LEXICON + +=item BRACKET NOTATION + +=item AUTO LEXICONS + +=item CONTROLLING LOOKUP FAILURE + +=item HOW TO USE MAKETEXT + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMER + +=item AUTHOR + +=back + +=head2 Locale::Maketext::TPJ13 -- article about software localization + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Localization and Perl: gettext breaks, Maketext fixes + +=over 4 + +=item A Localization Horror Story: It Could Happen To You + +=item The Linguistic View + +=item Breaking gettext + +=item Replacing gettext + +=item Buzzwords: Abstraction and Encapsulation + +=item Buzzword: Isomorphism + +=item Buzzword: Inheritance + +=item Buzzword: Concision + +=item The Devil in the Details + +=item The Proof in the Pudding: Localizing Web Sites + +=item References + +=back + +=back + =head2 MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -14125,6 +14591,13 @@ getitimer ( $which ) =item Week Number +=item strftime method + +%%, %a, %A, %b, %B, %c, %C, %d, %D, %e, %h, %H, %I, %j, %m, %M, %n, %p, %r, +%R, %S, %t, %T, %u, %U, %V, %w, %W, %x, %y, %Y, %Z + +=item strptime function + =item Global Overriding =back diff --git a/pod/perltodo.pod b/pod/perltodo.pod index 8c94a29c9a..3882498750 100644 --- a/pod/perltodo.pod +++ b/pod/perltodo.pod @@ -68,6 +68,11 @@ They have some tricks Perl doesn't yet implement. Artur Bergman's C<iThreads> module is a start on this, but needs to be more mature. +=head2 make perl_clone optionally clone ops + +So that pseudoforking, mod_perl, iThreads and nvi will work properly +(but not as efficiently) until the regex engine is fixed to be threadsafe. + =head2 Work out exit/die semantics for threads =head2 Typed lexicals for compiler @@ -418,9 +423,9 @@ There are a few suggestions for what to do with C<perldoc>: maybe a full-text search, an index function, locating pages on a particular high-level subject, and so on. -=head2 Install .3p man pages +=head2 Install .3p manpages -This is a bone of contention; we can create C<.3p> man pages for each +This is a bone of contention; we can create C<.3p> manpages for each built-in function, but should we install them by default? Tcl does this, and it clutters up C<apropos>. @@ -429,6 +434,7 @@ and it clutters up C<apropos>. Simon Cozens promises to do this before he gets old. =head2 Update POSIX.pm for 1003.1-2 + =head2 Retargetable installation Allow C<@INC> to be changed after Perl is built. @@ -468,7 +474,9 @@ code. There is a patch for this, but it may require Unicodification. =head2 Compile to real threaded code + =head2 Structured types + =head2 Modifiable $1 et al. ($x = "elephant") =~ /e(ph)/; @@ -690,11 +698,13 @@ This would break old code; use C<do{{ }}> instead. Not needed now we have lexical IO handles. =head2 format BOTTOM + =head2 report HANDLE Damian Conway's text formatting modules seem to be the Way To Go. =head2 Generalised want()/caller()) + =head2 Named prototypes These both seem to be delayed until Perl 6. diff --git a/pod/perlutil.pod b/pod/perlutil.pod index 45341d9e85..f299f2d13f 100644 --- a/pod/perlutil.pod +++ b/pod/perlutil.pod @@ -29,7 +29,7 @@ described in this document. If it's run from a terminal, F<perldoc> will usually call F<pod2man> to translate POD (Plain Old Documentation - see L<perlpod> for an -explanation) into a man page, and then run F<man> to display it; if +explanation) into a manpage, and then run F<man> to display it; if F<man> isn't available, F<pod2text> will be used instead and the output piped through your favourite pager. diff --git a/pod/perlxstut.pod b/pod/perlxstut.pod index f06e166326..ad648ebf37 100644 --- a/pod/perlxstut.pod +++ b/pod/perlxstut.pod @@ -915,9 +915,9 @@ way to store and load your extra subroutines. There is absolutely no excuse for not documenting your extension. Documentation belongs in the .pm file. This file will be fed to pod2man, -and the embedded documentation will be converted to the man page format, -then placed in the blib directory. It will be copied to Perl's man -page directory when the extension is installed. +and the embedded documentation will be converted to the manpage format, +then placed in the blib directory. It will be copied to Perl's +manpage directory when the extension is installed. You may intersperse documentation and Perl code within the .pm file. In fact, if you want to use method autoloading, you must do this, |