From f9e8b92ef5d16db4f94e55abea889303ab48b43e Mon Sep 17 00:00:00 2001 From: Jarkko Hietaniemi Date: Tue, 11 Jul 2000 20:30:36 +0000 Subject: [PATCH] Reintroduce perlbook (updated for Mk III), introduce perlposix-bc, regen perltoc. p4raw-id: //depot/cfgperl@6372 --- MANIFEST | 1 + pod/Makefile.SH | 4 +-- pod/buildtoc.PL | 5 ++- pod/perl.pod | 2 ++ pod/perlbook.pod | 17 ++++++++++ pod/perltoc.pod | 98 ++++++++++++++++++++++++++++++++++++++++++-------------- 6 files changed, 100 insertions(+), 27 deletions(-) create mode 100644 pod/perlbook.pod diff --git a/MANIFEST b/MANIFEST index 71e83d5..53d2aa1 100644 --- 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 --- 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 --- 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 () { 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 --- 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 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, 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. diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 9808e5f..accb11c 100644 --- 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, F =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 -- 2.7.4