From: Jarkko Hietaniemi Date: Sun, 18 Mar 2001 20:19:07 +0000 (+0000) Subject: Regen toc and api pods. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=4d4e713df03e36e02b94d8347b24e61304531f93;p=p5sagit%2Fp5-mst-13.2.git Regen toc and api pods. p4raw-id: //depot/perl@9209 --- diff --git a/pod/perlapi.pod b/pod/perlapi.pod index 3454edd..aaa9e90 100644 --- a/pod/perlapi.pod +++ b/pod/perlapi.pod @@ -1036,7 +1036,7 @@ Found in file handy.h =item is_utf8_char Tests if some arbitrary number of bytes begins in a valid UTF-8 -character. Note that an ASCII character is a valid UTF-8 character. +character. Note that an INVARIANT (i.e. ASCII) character is a valid UTF-8 character. The actual number of bytes in the UTF-8 character will be returned if it is valid, otherwise 0. diff --git a/pod/perltoc.pod b/pod/perltoc.pod index af5b4cc..311e90b 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -926,6 +926,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item DESCRIPTION +=over 4 + =item Declaration and Access of Arrays of Arrays =item Growing Your Own @@ -934,6 +936,8 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, =item Slices +=back + =item SEE ALSO =item AUTHOR @@ -1815,8 +1819,6 @@ http://testers.cpan.org/ =item DOS and Derivatives -Build instructions for OS/2, L - =item S =item VMS @@ -2303,8 +2305,8 @@ Look around, Check it's new, Discuss the need, Choose a name, Check again =item Step-by-step: Making the module Start with F, Use L and L, Use -L, Use L - wisely!, -Use L, Write tests, Write the README +L, Use L - wisely!, Use L, Write tests, Write the README =item Step-by-step: Distributing your module @@ -3892,12 +3894,12 @@ 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, -utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uv, -utf8_to_uv_simple, uv_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, -XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, -XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, -XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, -Zero +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, +XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, +XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, +XS_VERSION, XS_VERSION_BOOTCHECK, Zero =item AUTHORS @@ -5053,7 +5055,7 @@ Thread, attrs, fields, re =item Changes in existing modules Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, -MakeMaker, CPAN, Cwd, Benchmark +MakeMaker, CPAN, Cwd =back @@ -5688,6 +5690,8 @@ EMX, RSX, HPFS, pdksh =over 4 +=item "It does not work" + =item I cannot run external programs =item I cannot embed perl into my program, or use F from my @@ -5746,6 +5750,8 @@ Perl manual in F<.INF> format, Pdksh =over 4 +=item The short story + =item Prerequisites =item Getting perl source @@ -5759,7 +5765,7 @@ Perl manual in F<.INF> format, Pdksh =item Testing A lot of C, Process terminated by SIGTERM/SIGINT, F, -F, F, F, F +F =item Installing the built perl @@ -5806,13 +5812,29 @@ C, C, C, C, C, C, C, C, C, -C +C, +C, C, +OS2::SysInfo(), OS2::BootDrive(), C, +C, C, +C, C, +OS2::get_control87(), C + +=item Prebuilt variables: + +$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver =item Misfeatures =item Modifications -C, C, C, C, C, C +C, C, C, C, C, C, C, +C + +=item Identifying DLLs + +=item Centralized management of resources + +C, C =back @@ -5834,8 +5856,6 @@ C, C, C, C, C, C =item Why chimera build? -explicit fork(), open FH, "|-", open FH, "-|" - =back =item ENVIRONMENT @@ -6404,8 +6424,8 @@ new, phash =back -=head2 integer - Perl pragma to compute arithmetic in integer instead of -double +=head2 integer - Perl pragma to use integer arithmetic instead of floating +point =over 4 @@ -6688,6 +6708,15 @@ and non-UTF data. =item DESCRIPTION +=over 4 + +=item Utility functions + +$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]), +utf8::encode($string), $flag = utf8::decode($string) + +=back + =item SEE ALSO =back @@ -6973,8 +7002,7 @@ bytecode B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, -B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the -output. =back +B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> =item EXAMPLES @@ -7314,8 +7342,7 @@ STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache ( B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>, B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>, -B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> Stores package in the -output. =back +B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage> =item EXAMPLES @@ -8679,8 +8706,7 @@ strings in binary data, perl/Encode wrappers on non-Unicode XS modules =item Messing with Perl's Internals -utf8_downgrade($string[, CHECK]), is_utf8(STRING [, CHECK]), -valid_utf8(STRING) +is_utf8(STRING [, CHECK]), valid_utf8(STRING) =item IMPLEMENTATION CLASSES @@ -8955,8 +8981,6 @@ canonpath, cflags, manifypods, perl_archive =back -perl_archive_after - =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -8966,8 +8990,12 @@ ExtUtils::MakeMaker =item DESCRIPTION +=item METHODS + =back +perl_archive_after + =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker =over 4 @@ -10096,8 +10124,6 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item SYNOPSIS - use Filter::Util::Call ; - =item DESCRIPTION =over 4 @@ -10126,6 +10152,8 @@ B<$_>, B<$status>, B and B, B =back +=item Filter::Simple + =item AUTHOR =item DATE @@ -10420,6 +10448,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell +=item SEE ALSO + =item HISTORY =back @@ -10658,6 +10688,8 @@ $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell +=item SEE ALSO + =item HISTORY =back @@ -10906,6 +10938,183 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back +=head2 Locale::Constants - constants for Locale codes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Language, Locale::Country, Locale::Currency + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Country - ISO codes for country identification (ISO 3166) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +B, B, B + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ), +country_code2code( CODE, CODESET, CODESET ) + +=back + +=over 4 + +=item QUERY ROUTINES + +C, C + +=back + +=over 4 + +=item CODE ALIASING + +=back + +=over 4 + +=item EXAMPLES + +=item DOMAIN NAMES + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Language, Locale::Currency, ISO 3166, +http://www.din.de/gremien/nas/nabd/iso3166ma/, +http://www.egt.ie/standards/iso3166/iso3166-1-en.html, +http://www.cia.gov/cia/publications/factbook/docs/app-f.html + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Currency - ISO three letter codes for currency +identification (ISO 4217) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +XTS, XXX + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2currency(), currency2code() + +=back + +=over 4 + +=item QUERY ROUTINES + +C, C + +=back + +=over 4 + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Locale::Language - ISO two letter codes for language identification +(ISO 639) + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=back + +=over 4 + +=item CONVERSION ROUTINES + +code2language(), language2code() + +=back + +=over 4 + +=item QUERY ROUTINES + +C, C + +=back + +=over 4 + +=item EXAMPLES + +=item KNOWN BUGS AND LIMITATIONS + +=item SEE ALSO + +Locale::Country, Locale::Currency, ISO 639:1988 (E/F), +http://lcweb.loc.gov/standards/iso639-2/langhome.html + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 Math::BigFloat - Arbitrary length float math package =over 4 @@ -11027,6 +11236,8 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11152,6 +11363,8 @@ functions =item SYNOPSIS +=item DESCRIPTION + C, C, C =item DIAGNOSTICS @@ -11424,18 +11637,16 @@ after =back =item Warnings multiple occurence of link target I, line containing nothing but -whitespace in paragraph, file does not start with =head, No numeric -argument for =over, previous =item has no contents, preceding non-item -paragraph(s), =item type mismatch (I vs. I), I unescaped -CE> in paragraph, Unknown entity, No items in =over, No argument -for =item, empty section in previous paragraph, Verbatim paragraph in NAME -section +whitespace in paragraph, file does not start with =head, previous =item has +no contents, preceding non-item paragraph(s), =item type mismatch (I +vs. I), I unescaped CE> in paragraph, Unknown entity, No +items in =over, No argument for =item, empty section in previous paragraph, +Verbatim paragraph in NAME section =item Hyperlinks -collapsing newlines to blanks, ignoring leading/trailing whitespace in -link, (section) in '$page' deprecated, alternative text/node '%s' contains -non-escaped | or / +ignoring leading/trailing whitespace in link, (section) in '$page' +deprecated, alternative text/node '%s' contains non-escaped | or / =back @@ -12682,6 +12893,38 @@ C =back +=head2 Switch - A switch statement for Perl + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item BACKGROUND + +=item DESCRIPTION + +=over 4 + +=item Allowing fall-through + +=item Automating fall-through + +=item Higher-order Operations + +=back + +=item DEPENDENCIES + +=item AUTHOR + +=item BUGS + +=item COPYRIGHT + +=back + =head2 Symbol - manipulate Perl symbols and their names =over 4 @@ -12822,7 +13065,7 @@ C, C, C =back -=head2 Test - provides a simple framework for writing test scripts +=head2 Test - provides a simple framework for writing test scripts =over 4 @@ -12856,7 +13099,7 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item The test script output -B<1..M>, B<'ok', 'not ok'. Ok?>, B, +B<'1..M'>, B<'ok', 'not ok'. Ok?>, B, B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, B, B, B @@ -12897,6 +13140,75 @@ C =back +=head2 Text::Balanced - Extract delimited text sequences from strings. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item General behaviour in list contexts + +[0], [1], [2] + +=item General behaviour in scalar and void contexts + +=item A note about prefixes + +=item C + +=item C + +=item C + +C $listref>, C $listref>, C $str>, +[0], [1], [2], [3], [4], [5] + +=item C + +=item C + +[0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10] + +=item C and "here documents" + +[0], [1], [2], [3], [4], [5], [6], [7..10] + +=item C + +=item C + +=item C + +=back + +=item DIAGNOSTICS + + C, C, +C, C, C, +C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, C, C + +=item AUTHOR + +=item BUGS AND IRRITATIONS + +=item COPYRIGHT + +=back + =head2 Text::ParseWords - parse text into an array of tokens or array of arrays @@ -13205,6 +13517,18 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) =back +=head2 Unicode::UCD - Unicode character database versioning + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 User::grent - by-name interface to Perl's built-in getgr*() functions