Reintroduce perlbook (updated for Mk III), introduce perlposix-bc,

regen perltoc.

p4raw-id: //depot/cfgperl@6372

diff --git a/MANIFEST b/MANIFEST
index 71e83d5..53d2aa1 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -1128,6 +1128,7 @@ pod/perl5005delta.pod     Changes from 5.004 to 5.005
 pod/perl56delta.pod    Changes from 5.005 to 5.6
 pod/perlapi.pod         Perl API documentation (autogenerated)
 pod/perlapio.pod       IO API info
+pod/perlbook.pod       Perl book information
 pod/perlboot.pod       Beginner's Object-oriented Tutorial
 pod/perlbot.pod                Object-oriented Bag o' Tricks
 pod/perlcall.pod       Callback info

diff --git a/pod/Makefile.SH b/pod/Makefile.SH
index 70bf7c7..45f1856 100644 (file)
--- a/pod/Makefile.SH
+++ b/pod/Makefile.SH
@@ -72,7 +72,7 @@ converters: $(CONVERTERS)
 
 regen_pods: perlmodlib.pod toc
 
-buildtoc:      buildtoc.PL
+buildtoc:      buildtoc.PL perl.pod ../MANIFEST
        $(PERL) -I ../lib buildtoc.PL
 
 man:   pod2man $(MAN)
@@ -81,7 +81,7 @@ html: pod2html $(HTML)
 
 tex:   pod2latex $(TEX)
 
-toc:
+toc:   buildtoc
        $(PERL) -I../lib buildtoc
 
 .SUFFIXES: .pm .pod

diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index e4a040a..54853d3 100644 (file)
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -63,6 +63,7 @@ if (-d "pod") {
     perl
     perlfaq
     perltoc
+    perlbook
 
     perlsyn
     perldata
@@ -152,6 +153,7 @@ if (-d "pod") {
     perlmachten         
     perlos2             
     perlos390           
+    perlposix-bc
     perlvms             
     perlwin32           
          );
@@ -164,6 +166,7 @@ if (-d "pod") {
     perlmachten         
     perlos2             
     perlos390           
+    perlposix-bc
     perlvms             
     perlwin32           
           );
@@ -186,7 +189,7 @@ close(MANI);
 open(PERLPOD, "perl.pod") || die "$0: opening perl.pod failed: $!\n";
 while (<PERLPOD>) {
   if (/^For ease of access, /../^\(If you're intending /) {
-       if (/^\s+(perl\w*)\s+\w/) {
+       if (/^\s+(perl\S*)\s+\w/) {
                push @PERLPODS, "$1.pod";
        }
   }

diff --git a/pod/perl.pod b/pod/perl.pod
index 2b3f5e4..0273dbf 100644 (file)
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -17,6 +17,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perl               Perl overview (this section)
     perlfaq            Perl frequently asked questions
     perltoc            Perl documentation table of contents
+    perlbook           Perl book information
 
     perlsyn            Perl syntax
     perldata           Perl data structures
@@ -106,6 +107,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perlmachten                Perl notes for Power MachTen
     perlos2            Perl notes for OS/2
     perlos390          Perl notes for OS/390
+    perlposix-bc       Perl notes for POSIX-BC
     perlvms            Perl notes for VMS
     perlwin32          Perl notes for Windows
 

diff --git a/pod/perlbook.pod b/pod/perlbook.pod
new file mode 100644 (file)
index 0000000..44f0233
--- /dev/null
+++ b/pod/perlbook.pod
@@ -0,0 +1,17 @@
+=head1 NAME
+
+perlbook - Perl book information
+
+=head1 DESCRIPTION
+
+The Camel Book, officially known as I<Programming Perl, Third Edition,
+July 2000>, by Larry Wall et al, ISBN 0-596-00027-8, is the definitive
+reference work covering nearly all of Perl.  You can order it and
+other Perl books from O'Reilly & Associates, 1-800-998-9938.
+Local/overseas is +1 707 829 0515.  If you can locate an O'Reilly
+order form, you can also fax to +1 707 829 0104.  If you're
+web-connected, you can even mosey on over to http://www.oreilly.com/
+for an online order form.
+
+Other Perl books from various publishers and authors 
+can be found listed in L<perlfaq2>.

diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index 9808e5f..accb11c 100644 (file)
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -325,6 +325,14 @@ DESCRIPTION
 
 =back
 
+=head2 perlbook - Perl book information
+
+=over
+
+=item DESCRIPTION
+
+=back
+
 =head2 perlsyn - Perl syntax
 
 =over
@@ -4668,8 +4676,9 @@ probably be written as "%s", %s() called too early to check prototype, %s
 argument is not a HASH or ARRAY element, %s argument is not a HASH or ARRAY
 element or slice, %s argument is not a subroutine name, %s package
 attribute may clash with future reserved word: %s, (in cleanup) %s, <>
-should be quotes, Attempt to join self, Bad evalled substitution pattern,
-Bad realloc() ignored, Bareword found in conditional, Binary number >
+should be quotes, Ambiguous range in transliteration operator, Attempt to
+join self, Bad evalled substitution pattern, Bad realloc() ignored,
+Bareword found in conditional, Binary number >
 0b11111111111111111111111111111111 non-portable, Bit vector size > 32
 non-portable, Buffer overflow in prime_env_iter: %s, Can't check filesystem
 of script "%s", Can't declare class for non-scalar %s in "%s", Can't
@@ -4687,28 +4696,28 @@ explicit package name, Hexadecimal number > 0xffffffff non-portable,
 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
-%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
-separator character %s in attribute list, Invalid separator character %s in
-subroutine attribute list, leaving effective %s failed, Lvalue subs
-returning %s not implemented yet, Method %s not permitted, Missing
-%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
-No %s specified for -%c, No package name allowed for variable %s in "our",
-No space allowed after -%c, no UTC offset information; assuming local time
-is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
-panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
-around "%s" list, Possible Y2K bug: %s, pragma "attrs" is deprecated, use
-"sub NAME : ATTRS" instead, Premature end of script headers, Repeat count
-in pack overflows, Repeat count in unpack overflows, realloc() of freed
-memory ignored, Reference is already weak, setpgrp can't take arguments,
-Strange *+?{} on zero-length expression, switching effective %s is not
-implemented, This Perl can't reset CRTL environ elements (%s), This Perl
-can't set CRTL environ elements (%s=%s), Too late to run %s block, Unknown
-open() mode '%s', Unknown process %x sent message to prime_env_iter: %s,
-Unrecognized escape \\%c passed through, Unterminated attribute parameter
-in attribute list, Unterminated attribute list, Unterminated attribute
-parameter in subroutine attribute list, Unterminated subroutine attribute
-list, Value of CLI symbol "%s" too long, Version number must be a constant
-number
+%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, invalid []
+range "%s" in transliteration operator, Invalid separator character %s in
+attribute list, Invalid separator character %s in subroutine attribute
+list, leaving effective %s failed, Lvalue subs returning %s not implemented
+yet, Method %s not permitted, Missing %sbrace%s on \N{}, Missing command in
+piped open, Missing name in "my sub", No %s specified for -%c, No package
+name allowed for variable %s in "our", No space allowed after -%c, no UTC
+offset information; assuming local time is UTC, Octal number > 037777777777
+non-portable, panic: del_backref, panic: kid popen errno read, panic:
+magic_killbackrefs, Parentheses missing around "%s" list, Possible Y2K bug:
+%s, pragma "attrs" is deprecated, use "sub NAME : ATTRS" instead, Premature
+end of script headers, Repeat count in pack overflows, Repeat count in
+unpack overflows, realloc() of freed memory ignored, Reference is already
+weak, setpgrp can't take arguments, Strange *+?{} on zero-length
+expression, switching effective %s is not implemented, This Perl can't
+reset CRTL environ elements (%s), This Perl can't set CRTL environ elements
+(%s=%s), Too late to run %s block, Unknown open() mode '%s', Unknown
+process %x sent message to prime_env_iter: %s, Unrecognized escape \\%c
+passed through, Unterminated attribute parameter in attribute list,
+Unterminated attribute list, Unterminated attribute parameter in subroutine
+attribute list, Unterminated subroutine attribute list, Value of CLI symbol
+"%s" too long, Version number must be a constant number
 
 =item New tests
 
@@ -6070,6 +6079,47 @@ C<COND_WAIT>, F<os2.c>
 
 =back
 
+=head2 perlposix-bc, README.posix-bc - building and installing Perl for
+BS2000 POSIX.
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item gzip
+
+=item bison
+
+=item Unpacking
+
+=item Compiling
+
+=item Testing
+
+=item Install
+
+=item Using Perl
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over
+
+=item Mailing list
+
+=back
+
+=item HISTORY
+
+=back
+
 =head2 perlvms - VMS-specific documentation for Perl
 
 =over