Podify the remaining README.platform files;

merge README.plan9 and plan9/perlplan9.pod;
delete plan9/perlplan9.* (the perlplan.doc needs to
be regenerated in Plan 9); make the =head1 and =head2
in the README.platform to be a little more verbose
(skipped README.os2 not to anger Ilya) so that they
look better in the toc; regen toc.

p4raw-id: //depot/perl@10461

3 files changed, 7 insertions, 180 deletions

diff --git a/plan9/mkfile b/plan9/mkfile
index e56aa3c472..a708d8f379 100644
--- a/plan9/mkfile
+++ b/plan9/mkfile
@@ -20,7 +20,10 @@ perlshr = $archlib/CORE/libperlshr.a
 installman1dir = /sys/man/1
 installman3dir = /sys/man/2
 
-podnames = perl perlbook perlbot perlcall perldata perldebug perldiag perldsc perlembed perlform perlfunc perlguts perlipc perllol perlmod perlobj perlop perlpod perlre perlref perlrun perlsec perlstyle perlsub perlsyn perltie perltoc perltrap perlvar perlxs perlxstut
+podnames = perl perlbook perlboot perlbot perldata perldebtut perldiag perldsc perlform perlfunc perlipc perllol perlmod perlmodlib perlmodinstall perlnewmod perlop perlopentut perlpod perlrequick perlretut perlref perlreftut perlrun perlsec perlstyle perlsub perlsyn perltie perltoc perltoot perltootc perltrap perlutil perlvar
+faqpodnames = perlfaq perlfaq1 perlfaq2 perlfaq3 perlfaq4 perlfaq5 perlfaq6 perlfaq7 perlfaq8 perlfaq9
+advpodnames = perlapi perlapio perlcall perlclib perlcompile perldebguts perldbmfilter perldebug perldelta perldiag perlebcdic perlembed perlfilter perlfor perlguts perlhack perlhist perlintern perliol perlnumber perlobj perlre perlthrtut perltodo perlunicode perlxs perlxs perlxstut
+archpodnames = perlaix perlapollo perlamiga perlbs2000 perlcygwin perldgux perldos perlepoc perlhpux perlhurd perlmachten perlmacos perlmint perlmpeix perlos2 perlos390 perlqnx perlsolaris perltru64 perlvmesa perlvms perlvos perlwin32
 
 libpods = ${podnames:%=pod/%.pod}
 
@@ -133,7 +136,9 @@ installall:V:
 man:V:		$perlpods pod/pod2man.PL perl
 			perl pod/pod2man.PL
 			for (i in $podnames) pod/pod2man pod/$i.pod > $installman3dir/$i
-			pod/pod2man plan9/perlplan9.pod > $installman3dir/perlplan9
+			for (i in $faqpodnames) pod/pod2man pod/$i.pod > $installman3dir/$i
+			for (i in $advpodnames) pod/pod2man pod/$i.pod > $installman3dir/$i
+			for (i in $archpodnames) pod/pod2man pod/$i.pod > $installman3dir/$i
 			
 nuke clean:V:	
 		rm -f *.$O   $extensions^.pm config.sh $perllib config.h $perlshr perlmain.c perl miniperl $archlib/Config.pm $ext_c
diff --git a/plan9/perlplan9.doc b/plan9/perlplan9.doc
deleted file mode 100644
index d6d7df8b74..0000000000
--- a/plan9/perlplan9.doc
+++ /dev/null
@@ -1,91 +0,0 @@
-
-     PLAN9/PERLPLAN9(1)   (perl 5.003, patch 05)    PLAN9/PERLPLAN9(1)
-
-     NNNNAAAAMMMMEEEE
-          perlplan9 - Plan 9-specific documentation for Perl
-
-     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
-          These are a few notes describing features peculiar to Plan 9
-          Perl. As such, it is not intended to be a replacement for
-          the rest of the Perl 5 documentation (which is both copious
-          and excellent). If you have any questions to which you can't
-          find answers in these man pages, contact Luther Huffman at
-          lutherh@stratcom.com and we'll try to answer them.
-
-          IIIInnnnvvvvooookkkkiiiinnnngggg PPPPeeeerrrrllll
-
-          Perl is invoked from the command line as described in the
-          _p_e_r_l manpage. Most perl scripts, however, do have a first
-          line such as "#!/usr/local/bin/perl". This is known as a
-          shebang (shell-bang) statement and tells the OS shell where
-          to find the perl interpreter. In Plan 9 Perl this statement
-          should be "#!/bin/perl" if you wish to be able to directly
-          invoke the script by its name.
-               Alternatively, you may invoke perl with the command
-          "Perl" instead of "perl". This will produce Acme-friendly
-          error messages of the form "filename:18".
-
-          Some scripts, usually identified with a *.PL extension, are
-          self-configuring and are able to correctly create their own
-          shebang path from config information located in Plan 9 Perl.
-          These you won't need to be worried about.
-
-          WWWWhhhhaaaatttt''''ssss iiiinnnn PPPPllllaaaannnn 9999 PPPPeeeerrrrllll
-
-          Although Plan 9 Perl currently only  provides static
-          loading, it is built with a number of useful extensions.
-          These include Opcode, FileHandle, Fcntl, and POSIX. Expect
-          to see others (and DynaLoading!) in the future.
-
-          WWWWhhhhaaaatttt''''ssss nnnnooootttt iiiinnnn PPPPllllaaaannnn 9999 PPPPeeeerrrrllll
-
-          As mentioned previously, dynamic loading isn't currently
-          available nor is MakeMaker. Both are high-priority items.
-
-          PPPPeeeerrrrllll5555 FFFFuuuunnnnccccttttiiiioooonnnnssss nnnnooootttt ccccuuuurrrrrrrreeeennnnttttllllyyyy ssssuuuuppppppppoooorrrrtttteeeedddd
-
-          Some, such as chown and umask aren't provided because the
-          concept does not exist within Plan 9. Others, such as some
-          of the socket-related functions, simply haven't been written
-          yet. Many in the latter category may be supported in the
-          future.
-
-          The functions not currently implemented include:
-
-     Page 1                      9/Oct/96            (printed 10/9/96)
-
-     PLAN9/PERLPLAN9(1)   (perl 5.003, patch 05)    PLAN9/PERLPLAN9(1)
-
-              chown, chroot, dbmclose, dbmopen, getsockopt,
-              setsockopt, recvmsg, sendmsg, getnetbyname,
-              getnetbyaddr, getnetent, getprotoent, getservent,
-              sethostent, setnetent, setprotoent, setservent,
-              endservent, endnetent, endprotoent, umask
-
-          There may be several other functions that have undefined
-          behavior so this list shouldn't be considered complete.
-
-          SSSSiiiiggggnnnnaaaallllssss
-
-          For compatibility with perl scripts written for the Unix
-          environment, Plan 9 Perl uses the POSIX signal emulation
-          provided in Plan 9's ANSI POSIX Environment (APE). Signal
-          stacking isn't supported. The signals provided are:
-
-              SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT,
-              SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGPIPE, SIGALRM,
-              SIGTERM, SIGUSR1, SIGUSR2, SIGCHLD, SIGCONT,
-              SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU
-
-     BBBBUUUUGGGGSSSS
-          "As many as there are grains of sand on all the beaches of
-          the world . . ." - Carl Sagan
-
-     RRRReeeevvvviiiissssiiiioooonnnn ddddaaaatttteeee
-          This document was revised 09-October-1996 for Perl 5.003_7.
-
-     AAAAUUUUTTTTHHHHOOOORRRR
-          Luther Huffman,    lutherh@stratcom.com
-
-     Page 2                      9/Oct/96            (printed 10/9/96)
-
diff --git a/plan9/perlplan9.pod b/plan9/perlplan9.pod
deleted file mode 100644
index fb58149440..0000000000
--- a/plan9/perlplan9.pod
+++ /dev/null
@@ -1,87 +0,0 @@
-=head1 NAME
-
-perlplan9 - Plan 9-specific documentation for Perl
-
-=head1 DESCRIPTION
-
-These are a few notes describing features peculiar to
-Plan 9 Perl. As such, it is not intended to be a replacement
-for the rest of the Perl 5 documentation (which is both 
-copious and excellent). If you have any questions to 
-which you can't find answers in these man pages, contact 
-Luther Huffman at lutherh@stratcom.com and we'll try to 
-answer them.
-
-=head2 Invoking Perl
-
-Perl is invoked from the command line as described in 
-L<perl>. Most perl scripts, however, do have a first line 
-such as "#!/usr/local/bin/perl". This is known as a shebang 
-(shell-bang) statement and tells the OS shell where to find 
-the perl interpreter. In Plan 9 Perl this statement should be 
-"#!/bin/perl" if you wish to be able to directly invoke the 
-script by its name.
-     Alternatively, you may invoke perl with the command "Perl"
-instead of "perl". This will produce Acme-friendly error
-messages of the form "filename:18".
-
-Some scripts, usually identified with a *.PL extension, are 
-self-configuring and are able to correctly create their own 
-shebang path from config information located in Plan 9 
-Perl. These you won't need to be worried about.
-
-=head2 What's in Plan 9 Perl
-
-Although Plan 9 Perl currently only  provides static 
-loading, it is built with a number of useful extensions. 
-These include Opcode, FileHandle, Fcntl, and POSIX. Expect 
-to see others (and DynaLoading!) in the future.
-
-=head2 What's not in Plan 9 Perl
-
-As mentioned previously, dynamic loading isn't currently 
-available nor is MakeMaker. Both are high-priority items.
-
-=head2 Perl5 Functions not currently supported
-
-Some, such as C<chown> and C<umask> aren't provided 
-because the concept does not exist within Plan 9. Others,
-such as some of the socket-related functions, simply
-haven't been written yet. Many in the latter category 
-may be supported in the future.
-
-The functions not currently implemented include:
-
-    chown, chroot, dbmclose, dbmopen, getsockopt, 
-    setsockopt, recvmsg, sendmsg, getnetbyname, 
-    getnetbyaddr, getnetent, getprotoent, getservent, 
-    sethostent, setnetent, setprotoent, setservent, 
-    endservent, endnetent, endprotoent, umask
-
-There may be several other functions that have undefined 
-behavior so this list shouldn't be considered complete.
-
-=head2 Signals
-
-For compatibility with perl scripts written for the Unix 
-environment, Plan 9 Perl uses the POSIX signal emulation
-provided in Plan 9's ANSI POSIX Environment (APE). Signal stacking
-isn't supported. The signals provided are:
-
-    SIGHUP, SIGINT, SIGQUIT, SIGILL, SIGABRT,
-    SIGFPE, SIGKILL, SIGSEGV, SIGPIPE, SIGPIPE, SIGALRM, 
-    SIGTERM, SIGUSR1, SIGUSR2, SIGCHLD, SIGCONT,
-    SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU
-
-=head1 BUGS
-
-"As many as there are grains of sand on all the beaches of the 
-world . . ." - Carl Sagan
-
-=head1 Revision date
-
-This document was revised 09-October-1996 for Perl 5.003_7.
-
-=head1 AUTHOR
-
-Luther Huffman,    lutherh@stratcom.com