diff options
| -rw-r--r-- | pod/buildtoc.PL | 3 | ||||
| -rw-r--r-- | pod/perl.pod | 2 | ||||
| -rw-r--r-- | pod/perltoc.pod | 510 |
3 files changed, 348 insertions, 167 deletions
diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL index 26be6e854b..6c43035889 100644 --- a/pod/buildtoc.PL +++ b/pod/buildtoc.PL @@ -148,6 +148,7 @@ if (-d "pod") { perlhist perldelta + perl572delta perl571delta perl570delta perl56delta @@ -158,6 +159,7 @@ if (-d "pod") { perlamiga perlbs2000 perlcygwin + perldgux perldos perlepoc perlhpux @@ -178,6 +180,7 @@ if (-d "pod") { perlamiga perlbs2000 perlcygwin + perldgux perldos perlepoc perlhpux diff --git a/pod/perl.pod b/pod/perl.pod index a1bc034142..c047d347d5 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -102,6 +102,7 @@ For ease of access, the Perl manual has been split up into several sections: perlhist Perl history records perldelta Perl changes since previous version + perl572delta Perl changes in version 5.7.2 perl571delta Perl changes in version 5.7.1 perl570delta Perl changes in version 5.7.0 perl56delta Perl changes in version 5.6 @@ -112,6 +113,7 @@ For ease of access, the Perl manual has been split up into several sections: perlamiga Perl notes for Amiga perlbs2000 Perl notes for POSIX-BC BS2000 perlcygwin Perl notes for Cygwin + perldgux Perl notes for DG/UX perldos Perl notes for DOS perlepoc Perl notes for EPOC perlhpux Perl notes for HP-UX diff --git a/pod/perltoc.pod b/pod/perltoc.pod index ccc4480079..a75f39ea1f 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -362,20 +362,21 @@ 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, 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 +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 +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, @@ -2459,8 +2460,8 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there an IDE or Windows Perl Editor? -CodeMagicCD, Komodo, The Object System, PerlBuilder, Perl code magic, -visiPerl+, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, +Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, +CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha =item Where can I get Perl macros for vi? @@ -4053,301 +4054,336 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item DESCRIPTION -=item Infrastructure +=item To do during 5.6.x =over 4 -=item Mailing list archives +=item Support for I/O disciplines -=item Bug tracking system +=item Eliminate need for "use utf8"; -=item Regression Tests +=item Autoload byte.pm -Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to -perl5 +=item Make "\u{XXXX}" et al work -=back +=item Overloadable regex assertions -=item Configure +=item Unicode collation and normalization -=over 4 +=item Unicode case mappings -=item Install HTML +=item Unicode regular expression character classes -=back +=item use Thread for iThreads -=item Perl Language +=item Work out exit/die semantics for threads -=over 4 +=item Typed lexicals for compiler -=item 64-bit Perl +=item Compiler workarounds for Win32 -=item Prototypes +=item AUTOLOADing in the compiler -Named prototypes, Indirect objects, Method calls, Context, Scoped subs +=item Fixing comppadlist when compiling -=back +=item Cleaning up exported namespace -=item Perl Internals +=item Complete signal handling -=over 4 +=item Out-of-source builds -=item magic_setisa +=item POSIX realtime support -=item Garbage Collection +=item UNIX98 support -=item Reliable signals +=item IPv6 Support -Alternate runops() for signal despatch, Figure out how to die() in delayed -sighandler, Add tests for Thread::Signal, Automatic tests against CPAN +=item Long double conversion -=item Interpolated regex performance bugs +=item Locales -=item Memory leaks from failed eval/regcomp +=item Thread-safe regexes -=item Make XS easier to use +=item Arithmetic on non-Arabic numerals + +=item POSIX Unicode character classes + +=item Factoring out common suffices/prefices in regexps (trie optimization) + +=item Security audit shipped utilities + +=item Custom opcodes + +=item spawnvp() on Win32 + +=item DLL Versioning + +=item Introduce @( and @) + +=item Floating point handling + +=item IV/UV preservation + +=item Replace pod2html with something using Pod::Parser + +=item Automate module testing on CPAN + +=item sendmsg and recvmsg + +=item Rewrite perlre documentation -=item Make embedded Perl easier to use +=item Convert example code to IO::Handle filehandles -=item Namespace cleanup +=item Document Win32 choices -=item MULTIPLICITY +=item Check new modules -=item MacPerl +=item Make roffitall find pods and libs itself =back -=item Documentation +=item To do at some point =over 4 -=item A clear division into tutorial and reference +=item Remove regular expression recursion -=item Remove the artificial distinction between operators and functions +=item Memory leaks after failed eval -=item More tutorials +=item pack "(stuff)*" -Regular expressions, I/O, pack/unpack, Debugging +=item bitfields in pack -=item Include a search tool +=item Cross compilation -=item Include a locate tool +=item Perl preprocessor / macros -=item Separate function manpages by default +=item Perl lexer in Perl -=item Users can't find the manpages +=item Using POSIX calls internally -=item Install ALL Documentation +=item -i rename file when changed -=item Outstanding issues to be documented +=item All ARGV input should act like E<lt>E<gt> -=item Adapt www.linuxhq.com for Perl +=item Support for rerunning debugger -=item Replace man with a perl program +=item my sub foo { } -=item Unicode tutorial +=item One-pass global destruction -=back +=item Rewrite regexp parser -=item Modules +=item Cache recently used regexps -=over 4 +=item Re-entrant functions -=item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2 +=item Cross-compilation support -=item Module versions +=item Bit-shifting bitvectors -=item New modules +=item debugger pragma -=item Profiler +=item use less pragma -=item Tie Modules +=item switch structures -VecArray, SubstrArray, VirtualArray, ShiftSplice +=item Cache eval tree -=item Procedural options +=item rcatmaybe -=item RPC +=item Shrink opcode tables -=item y2k localtime/gmtime +=item Optimize away @_ -=item Export File::Find variables +=item Prototypes versus indirect objects -=item Ioctl +=item Install HMTL -=item Debugger attach/detach +=item Prototype method calls -=item Regular Expression debugger +=item Return context prototype declarations -=item Alternative RE Syntax +=item magic_setisa -=item Bundled modules +=item Garbage collection -=item Expect +=item IO tutorial -=item GUI::Native +=item pack/unpack tutorial -=item Update semibroken auxiliary tools; h2ph, a2p, etc. +=item Rewrite perldoc -=item pod2html +=item Install .3p man pages + +=item Unicode tutorial -=item Podchecker +=item Update POSIX.pm for 1003.1-2 +=head2 Retargetable installation + +=item POSIX emulation on non-POSIX systems + +=item Rename Win32 headers + +=item Finish off lvalue functions + +=item Update sprintf documentation + +=item Use fchown/fchmod internally =back -=item Tom's Wishes +=item Vague ideas =over 4 -=item Webperl +=item ref() in list context -=item Mobile agents +=item Make tr/// return histogram -=item POSIX on non-POSIX +=item Compile to real threaded code +=head2 Structured types +=head2 Modifiable $1 et al. -=item Portable installations +=item Procedural interfaces for IO::*, etc. -=back +=item RPC modules -=item Win32 Stuff +=item Attach/detach debugger from running program -=over 4 +=item Alternative RE syntax module -=item Rename new headers to be consistent with the rest +=item GUI::Native -=item Sort out the spawnvp() mess +=item foreach(reverse ...) -=item Work out DLL versioning +=item Constant function cache -=item Style-check +=item Approximate regular expression matching =back -=item Would be nice to have +=item Ongoing -C<pack "(stuff)*">, Contiguous bitfields in pack/unpack, lexperl, Bundled -perl preprocessor, Use posix calls internally where possible, format -BOTTOM, -i rename file only when successfully changed, All ARGV input -should act like <>, report HANDLE [formats], support in perlmain to rerun -debugger, lvalue functions +=over 4 -=item Possible pragmas +=item Update guts documentation -=over 4 +=item Add more tests -=item 'less' +=item Update auxiliary tools =back -=item Optimizations +=item Recently done things =over 4 -=item constant function cache +=item Safe signal handling -=item foreach(reverse...) +=item Tie Modules -=item Cache eval tree +=item gettimeofday -=item rcatmaybe +=item setitimer and getimiter -=item Shrink opcode tables +=item Testing __DIE__ hook -=item Cache hash value +=item CPP equivalent in Perl -=item Optimize away @_ where possible +=item Explicit switch statements -=item Optimize sort by { $a <=> $b } +=item autocroak -=item Rewrite regexp parser for better integrated optimization +=item UTF/EBCDIC -=back +=item UTF Regexes -=item Vague possibilities +=item perlcc to produce executable -ref function in list context, make tr/// return histogram in list context?, -Loop control on do{} et al, Explicit switch statements, compile to real -threaded code, structured types, Modifiable $1 et al +=item END blocks saved in compiled output -=item To Do Or Not To Do +=item Secure temporary file module -=over 4 +=item Integrate Time::HiRes -=item Making my() work on "package" variables +=item Turn Cwd into XS -=item "or" testing defined not truth +=item Mmap for input -=item "dynamic" lexicals +=item Byte to/from UTF8 and UTF8 to/from local conversion -=item "class"-based, rather than package-based "lexicals" +=item Add sockatmark support -=back +=item Mailing list archives -=item Threading +=item Bug tracking -=over 4 +=item Integrate MacPerl -=item Modules +=item Web "nerve center" for Perl -=item Testing +=item Regular expression tutorial -=item $AUTOLOAD +=item Debugging Tutorial -=item exit/die +=item Integrate new modules -=item External threads +=item Integrate profiler -=item Thread::Pool +=item Y2K error detection -=item thread-safety +=item Regular expression debugger -=item Per-thread GVs +=item POD checker -=back +=item "Dynamic" lexicals -=item Compiler +=item Cache precompiled modules -=over 4 +=back -=item Optimization +=item Deprecated Wishes -=item Byteperl +=over 4 -=item Precompiled modules +=item Loop control on do{} -=item Executables +=item Lexically scoped typeglobs -=item Typed lexicals +=item format BOTTOM +=head2 report HANDLE -=item Win32 +=item Generalised want()/caller()) +=head2 Named prototypes -=item END blocks +=item Built-in globbing -=item _AUTOLOAD +=item Regression tests for suidperl -=item comppadlist +=item Cached hash values -=item Cached compilation +=item Add compression modules -=back +=item Reorganise documentation into tutorials/references -=item Recently Finished Tasks +=item Remove distinction between functions and operators -=over 4 +=item Make XS easier to use -=item Figure a way out of $^(capital letter) +=item Make embedding easier to use -=item Filenames +=item man for perl -=item Foreign lines +=item my $Package::variable -=item Namespace cleanup +=item "or" tests defined, not truth -=item ISA.pm +=item "class"-based lexicals -=item gettimeofday +=item byteperl -=item autocroak? +=item Lazy evaluation / tail recursion removal =back @@ -4432,7 +4468,8 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug =item Pixie Profiling --h, -l, -p, -h, -i, -l, -testcoverage, -zero +-h, -l, -p[rodecures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, +-z[ero] =item CONCLUSION @@ -4488,6 +4525,104 @@ I<The Road goes ever on and on, down from the door where it began.> =back +=head2 perl572delta, perl571delta - what's new for perl v5.7.2 + +=over 4 + +=item DESCRIPTION + +=item Security Vulnerability Closed + +=item Incompatible Changes + +=item Core Enhancements + +=item Modules and Pragmata + +=over 4 + +=item New Modules + +=item Updated And Improved Modules and Pragmata + +=back + +=item Performance Enhancements + +=item Utility Changes + +=item New Documentation + +=item Installation and Configuration Improvements + +=over 4 + +=item New Or Improved Platforms + +=item Generic Improvements + +=back + +=item Selected Bug Fixes + +=over 4 + +=item Platform Specific Changes and Fixes + +=back + +=item New or Changed Diagnostics + +=item Changed Internals + +=over 4 + +=item Regex pre-/post-compilation items matched up + +=back + +=item New Tests + +=item Known Problems + +=over 4 + +=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl + +=item lib/ftmp-security tests warn 'system possibly insecure' + +=item lib/io_multihomed Fails In LP64-Configured HP-UX + +=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX + +=item lib/b test 19 + +=item Linux With Sfio Fails op/misc Test 48 + +=item sigaction test 13 in VMS + +=item sprintf tests 129 and 130 + +=item Failure of Thread tests + +=item Localising a Tied Variable Leaks Memory + +=item Self-tying of Arrays and Hashes Is Forbidden + +=item Building Extensions Can Fail Because Of Largefiles + +=item The Compiler Suite Is Still Experimental + +=back + +=item Reporting Bugs + +=item SEE ALSO + +=item HISTORY + +=back + =head2 perl571delta - what's new for perl v5.7.1 =over 4 @@ -4500,6 +4635,16 @@ 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 PerlIO is Now The Default + +=item Signals Are Now Safe + +=back + =item Modules and Pragmata =over 4 @@ -5680,6 +5825,38 @@ Source, Compiled Module Source, Perl Modules/Scripts =back +=head2 perldgux - Perl under DG/UX. + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=item BUILD + +=over 4 + +=item Non-threaded Case + +=item Threaded Case + +=item Testing + +=item Installing the built perl + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perlepoc, README.epoc - Perl for EPOC =over 4 @@ -8934,8 +9111,6 @@ reference, e.g.: =item Encoding and IO -=item Encode and PerlIO - =item Encoding How to ... IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8 @@ -13896,15 +14071,16 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this =item DESCRIPTION gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, -$interval_useconds ] ), tv_interval ( $ref_to_gettimeofday [, -$ref_to_later_gettimeofday] ), time (), sleep ( $floating_seconds ), alarm -( $floating_seconds [, $interval_floating_seconds ] ), setitimer ( $which, -$floating_seconds [, $interval_floating_seconds ] ), getitimer ( $which ) +$interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), +alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer, +getitimer ( $which ) =item EXAMPLES =item C API +=item CAVEATS + =item AUTHORS =item REVISION |