From 849d92fde593e07ed7a813b6962a8eafbd2186d3 Mon Sep 17 00:00:00 2001 From: Jarkko Hietaniemi Date: Fri, 10 May 2002 15:08:51 +0000 Subject: [PATCH] Regen toc. p4raw-id: //depot/perl@16538 --- pod/perltoc.pod | 452 ++++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 345 insertions(+), 107 deletions(-) diff --git a/pod/perltoc.pod b/pod/perltoc.pod index b14290c..59c1467 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -1854,6 +1854,104 @@ string =item DESCRIPTION +=item What Is A Thread Anyway? + +=item Threaded Program Models + +=over 4 + +=item Boss/Worker + +=item Work Crew + +=item Pipeline + +=back + +=item Native threads + +=item What kind of threads are perl threads? + +=item Threadsafe Modules + +=item Thread Basics + +=over 4 + +=item Basic Thread Support + +=item Creating Threads + +=item Giving up control + +=item Waiting For A Thread To Exit + +=item Ignoring A Thread + +=back + +=item Threads And Data + +=over 4 + +=item Shared And Unshared Data + +=item Thread Pitfalls: Races + +=item Controlling access: lock() + +=item Thread Pitfall: Deadlocks + +=item Queues: Passing Data Around + +=back + +=item Threads And Code + +=over 4 + +=item Semaphores: Synchronizing Data Access + +Basic semaphores, Advanced Semaphores + +=back + +=item General Thread Utility Routines + +=over 4 + +=item What Thread Am I In? + +=item Thread IDs + +=item Are These Threads The Same? + +=item What Threads Are Running? + +=back + +=item A Complete Example + +=item Conclusion + +=item Bibliography + +=over 4 + +=item Introductory Texts + +=item OS-Related References + +=item Other References + +=back + +=item Acknowledgements + +=item AUTHOR + +=item Copyrights + =back =head2 perlothrtut - old tutorial on threads in Perl @@ -2836,8 +2934,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.21 $, $Date: 2002/04/28 -15:51:10 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06 +13:11:13 $) =over 4 @@ -2921,8 +3019,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.20 $, $Date: 2002/04/07 -18:46:13 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.21 $, $Date: 2002/05/06 +13:08:46 $) =over 4 @@ -2942,7 +3040,7 @@ Trig functions? =item How do I convert between numeric representations? -B, B, B, B, B, B, B @@ -3800,7 +3898,7 @@ C, C, C =item EXAMPLE 8 (Coming Soon) -=item EXAMPLE 9 (Coming Soon) +=item EXAMPLE 9 Passing open files to XSes =item Troubleshooting these Examples @@ -4360,8 +4458,8 @@ HEf_SVKEY, Nullch, Nullsv get_hv, 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, newHV, Nullhv +hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval, +hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv =item Magical Functions @@ -4428,13 +4526,13 @@ sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset, 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_taint, sv_tainted, sv_true, -sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, -sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, -sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn +sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_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_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags, +sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, +sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags, +sv_uv, sv_vcatpvfn, sv_vsetpvfn =item Unicode Support @@ -4539,7 +4637,7 @@ Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt =item Extension Layers -":encoding", ":Scalar", ":Object" or ":Perl" +":encoding", ":Scalar", ":Via" =back @@ -4572,7 +4670,7 @@ B, B, B =item Co-existence with stdio B, B, -B, B +B, B =item "Fast gets" Functions @@ -5030,6 +5128,11 @@ finish, 'enter', print F, F, F, F, F, F, F, F, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib +=item Special Make Test Targets + +coretest, test.deparse, minitest, test.third check.third utest.third +ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8 + =back =item EXTERNAL TOOLS FOR DEBUGGING PERL @@ -5209,11 +5312,13 @@ I =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales +=item Modifying $_ Inside for(..) + =item mod_perl 1.26 Doesn't Build With Threaded Perl =item lib/ftmp-security tests warn 'system possibly insecure' -=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured +=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured =item Linux With Sfio Fails op/misc Test 48 @@ -5237,8 +5342,6 @@ I =item XML::Parser not working -=item Localising a Tied Variable Leaks Memory - =item z/OS (OS/390) =item Localising Tied Arrays and Hashes Is Broken @@ -7991,6 +8094,37 @@ method, locked =back +=head2 threadshared::queue, threads::shared::queue - thread-safe queues + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS AND METHODS + +new, enqueue LIST, dequeue, dequeue_nb, pending + +=item SEE ALSO + +=back + +=head2 threadshared::semaphore, threads::shared::semaphore - thread-safe +semaphores + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS AND METHODS + +new, new NUMBER, down, down NUMBER, up, up NUMBER + +=back + =head2 threadshared::shared, threads::shared - Perl extension for sharing data structures between threads @@ -8027,7 +8161,8 @@ from perl =item DESCRIPTION $thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->yield();, threads->list(); +threads->self, $thread->tid, threads->yield();, threads->list();, async +BLOCK; =item WARNINGS @@ -8693,7 +8828,8 @@ from perl =item DESCRIPTION $thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->yield();, threads->list(); +threads->self, $thread->tid, threads->yield();, threads->list();, async +BLOCK; =item WARNINGS @@ -8736,6 +8872,37 @@ cond_signal VARIABLE, cond_broadcast VARIABLE =back +=head2 threadshared::queue, threads::shared::queue - thread-safe queues + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS AND METHODS + +new, enqueue LIST, dequeue, dequeue_nb, pending + +=item SEE ALSO + +=back + +=head2 threadshared::semaphore, threads::shared::semaphore - thread-safe +semaphores + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item FUNCTIONS AND METHODS + +new, new NUMBER, down, down NUMBER, up, up NUMBER + +=back + =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source code @@ -10167,8 +10334,7 @@ C, C =item b -C, C, C, C, C, -C, C +C, C, C, C, C, C, C =item c @@ -10184,78 +10350,77 @@ C, C, C C, C, C, C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -11126,6 +11291,8 @@ guess_encoding($data, [, I]) =item CAVEATS +=item TO DO + =item SEE ALSO =back @@ -11234,11 +11401,12 @@ the Cyrillic world, gsm0338 - Hentai Latin 1 =item CJK: Chinese, Japanese, Korean (Multibyte) Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, -Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN =item Miscellaneous encodings -Encode::EBCDIC, Encode::Symbols +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess =back @@ -11432,6 +11600,8 @@ guess_encoding($data, [, I]) =item CAVEATS +=item TO DO + =item SEE ALSO =back @@ -11514,11 +11684,12 @@ the Cyrillic world, gsm0338 - Hentai Latin 1 =item CJK: Chinese, Japanese, Korean (Multibyte) Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, -Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN =item Miscellaneous encodings -Encode::EBCDIC, Encode::Symbols +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess =back @@ -12095,6 +12266,49 @@ B =back +=head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in +ExtUtils::MakeMaker + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +maybe_command + +guess_name + +macify + +patternify + +init_main + +init_others + +init_dirscan + +libscan (o) + +constants (o) + +static (o) + +dlsyms (o) + +dynamic (o) + +clean (o) + +realclean (o) + +rulez (o) + +processPL (o) + =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -12108,6 +12322,8 @@ ExtUtils::MakeMaker constants (o) +static_lib (o) + dynamic_lib (o) =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in @@ -12495,6 +12711,16 @@ dist_core (o) pasthru (o) +=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization =over 4 @@ -17507,7 +17733,7 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN =back -=head2 Storable - persistency for perl data structures +=head2 Storable - persistence for Perl data structures =over 4 @@ -17523,6 +17749,10 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN =item CANONICAL REPRESENTATION +=item FORWARD COMPATIBILITY + +utf8 data, restricted hashes, files from future versions of Storable + =item ERROR REPORTING =item WIZARDS ONLY @@ -17555,8 +17785,6 @@ C =item CREDITS -=item TRANSLATIONS - =item AUTHOR =item SEE ALSO @@ -18802,7 +19030,7 @@ $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD =back -=head2 Unicode::Collate - use UCA (Unicode Collation Algorithm) +=head2 Unicode::Collate - Unicode Collation Algorithm =over 4 @@ -18818,30 +19046,40 @@ alternate, backwards, entry, ignoreName, ignoreChar, level, normalization, overrideCJK, overrideHangul, preprocess, rearrange, table, undefName, undefChar, katakana_before_hiragana, upper_before_lower -=item Other methods +=item Methods for Collation C<@sorted = $Collator-Esort(@not_sorted)>, C<$result = $Collator-Ecmp($a, $b)>, C<$result = $Collator-Eeq($a, $b)>, C<$result = $Collator-Ene($a, $b)>, C<$result = $Collator-Elt($a, $b)>, C<$result = $Collator-Ele($a, $b)>, C<$result = $Collator-Egt($a, $b)>, C<$result = $Collator-Ege($a, $b)>, -C<$sortKey = $Collator-EgetSortKey($string)>, C<$position = +C<$sortKey = $Collator-EgetSortKey($string)>, C<$sortKeyForm = +$Collator-EviewSortKey($string)>, C<$position = $Collator-Eindex($string, $substring)>, C<($position, $length) = $Collator-Eindex($string, $substring)> +=item Other Methods + +UCA_Version, Base_Unicode_Version + =item EXPORT =item TODO =item CAVEAT +=item BUGS + =back =item AUTHOR =item SEE ALSO -Unicode Collation Algorithm - Unicode TR #10, L +http://www.unicode.org/unicode/reports/tr10/, +http://www.unicode.org/unicode/reports/tr10/allkeys.txt, +http://www.unicode.org/unicode/reports/tr15/, +http://www.unicode.org/unicode/reports/tr18, L =back -- 1.8.3.1