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

1 files changed, 24 insertions, 10 deletions

diff --git a/README.hurd b/README.hurd
index 6db3ef3638..17e04b0353 100644
--- a/README.hurd
+++ b/README.hurd
@@ -1,13 +1,19 @@
-Notes on Perl on the Hurd
-Last Updated: Fri, 29 Oct 1999 22:50:30 +0200
-Written by: Mark Kettenis <kettenis@gnu.org>
+If you read this file _as_is_, just ignore the funny characters you see.
+It is written in the POD format (see pod/perlpod.pod) which is specially
+designed to be readable as is.
+
+=head1 NAME
+
+README.hurd - Perl version 5 on Hurd
+
+=head1 DESCRIPTION
 
 If you want to use Perl on the Hurd, I recommend using the Debian
 GNU/Hurd distribution (see http://www.debian.org), even if an
 official, stable release has not yet been made.  The old `gnu-0.2'
 binary distribution will most certainly have additional problems.
 
-* Known Problems
+=head2 Known Problems with Perl on Hurd 
 
 The Perl test suite may still report some errors on the Hurd.  The
 `lib/anydbm' and `pragma/warnings' tests will almost certainly fail.
@@ -21,12 +27,13 @@ information.
 
 Here are the statistics for Perl 5.005_62 on my system:
 
-Failed Test  Status Wstat Total Fail  Failed  List of failed
--------------------------------------------------------------------------------
-lib/anydbm.t                 12    1   8.33%  12
-pragma/warnings             333    1   0.30%  215
-8 tests and 24 subtests skipped.
-Failed 2/229 test scripts, 99.13% okay. 2/10850 subtests failed, 99.98% okay.
+ Failed Test  Status Wstat Total Fail  Failed  List of failed
+ -------------------------------------------------------------------------
+ lib/anydbm.t                 12    1   8.33%  12
+ pragma/warnings             333    1   0.30%  215
+
+ 8 tests and 24 subtests skipped.
+ Failed 2/229 test scripts, 99.13% okay. 2/10850 subtests failed, 99.98% okay.
 
 There are quite a few systems out there that do worse!
 
@@ -38,3 +45,10 @@ encounter more failures.  Likely candidates are: `op/stat', `lib/io_pipe',
 In any way, if you're seeing failures beyond those mentioned in this
 document, please consider upgrading to the latest Hurd before reporting
 the failure as a bug. 
+
+=head1 AUTHOR
+
+Mark Kettenis <kettenis@gnu.org>
+
+Last Updated: Fri, 29 Oct 1999 22:50:30 +0200
+