Regen toc.
Jarkko Hietaniemi [Wed, 16 May 2001 13:41:09 +0000 (13:41 +0000)]
p4raw-id: //depot/perl@10124

pod/buildtoc.PL
pod/perl.pod
pod/perltoc.pod

index 26be6e8..6c43035 100644 (file)
@@ -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            
index a1bc034..c047d34 100644 (file)
@@ -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
index ccc4480..a75f39e 100644 (file)
@@ -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