Rename README.posix-bc to README.bs2000 to avoid confusion

when people think that perlposix-bc.pod tells anything about
Perl and POSIX.  Regen toc.

p4raw-id: //depot/perl@8730

8 files changed, 324 insertions, 95 deletions

diff --git a/MANIFEST b/MANIFEST
index ecb3e51812..2855857d74 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -38,6 +38,7 @@ README.aix		Notes about AIX port
 README.amiga		Notes about AmigaOS port
 README.apollo		Notes about Apollo DomainOS port
 README.beos		Notes about BeOS port
+README.bs2000		Notes about BS2000 POSIX port
 README.cygwin		Notes about Cygwin port
 README.dos		Notes about dos/djgpp port
 README.epoc		Notes about EPOC port
@@ -50,7 +51,6 @@ README.mpeix		Notes about MPE/iX port
 README.os2		Notes about OS/2 port
 README.os390		Notes about OS/390 (nee MVS) port
 README.plan9		Notes about Plan9 port
-README.posix-bc		Notes about BS2000 POSIX port
 README.qnx		Notes about QNX port
 README.solaris		Notes about Solaris port
 README.threads		Notes about multithreading
diff --git a/README.posix-bc b/README.bs2000
index a0128fda81..a0128fda81 100644
--- a/README.posix-bc
+++ b/README.bs2000
diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index f2dba95f61..1e55649ca8 100644
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -140,6 +140,7 @@ if (-d "pod") {
     perldbmfilter       
     perlapi             
     perlintern          
+    perliol            
     perlapio            
     perltodo            
     perlhack            
@@ -152,6 +153,7 @@ if (-d "pod") {
 
     perlaix
     perlamiga          
+    perlbs2000
     perlcygwin          
     perldos             
     perlepoc             
@@ -160,8 +162,8 @@ if (-d "pod") {
     perlmpeix         
     perlos2             
     perlos390           
-    perlposix-bc
     perlsolaris
+    perlvmesa
     perlvms             
     perlvos             
     perlwin32           
@@ -170,6 +172,7 @@ if (-d "pod") {
 @ARCHPODS = qw(
     perlaix	
     perlamiga          
+    perlbs2000
     perlcygwin          
     perldos             
     perlepoc             
@@ -178,8 +181,8 @@ if (-d "pod") {
     perlmpeix
     perlos2             
     perlos390           
-    perlposix-bc
     perlsolaris
+    perlvmesa
     perlvms             
     perlvos             
     perlwin32           
diff --git a/pod/perl.pod b/pod/perl.pod
index 4e08cc8ede..7f6320436a 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -94,6 +94,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perldbmfilter	Perl DBM filters
     perlapi		Perl API listing (autogenerated)
     perlintern		Perl internal functions (autogenerated)
+    perliol		C API for Perl's implementation of IO in Layers
     perlapio		Perl internal IO abstraction interface
     perltodo		Perl things to do
     perlhack		Perl hackers guide
@@ -106,6 +107,7 @@ For ease of access, the Perl manual has been split up into several sections:
 
     perlaix		Perl notes for AIX
     perlamiga		Perl notes for Amiga
+    perlbs2000		Perl notes for POSIX-BC BS2000
     perlcygwin		Perl notes for Cygwin
     perldos		Perl notes for DOS
     perlepoc		Perl notes for EPOC
@@ -114,8 +116,8 @@ For ease of access, the Perl manual has been split up into several sections:
     perlmpeix		Perl notes for MPE/iX
     perlos2		Perl notes for OS/2
     perlos390		Perl notes for OS/390
-    perlposix-bc	Perl notes for POSIX-BC
     perlsolaris 	Perl notes for Solaris
+    perlvmesa		Perl notes for POSIX-BC BS2000
     perlvms		Perl notes for VMS
     perlvos		Perl notes for Stratus VOS
     perlwin32		Perl notes for Windows
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 08a1704baf..de2d855ff3 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -1066,7 +1066,7 @@ Also see:
 
 *
 
-L<perlos390>, F<README.os390>, F<perlposix-bc>, F<README.vmesa>,
+L<perlos390>, F<README.os390>, F<perlbs2000>, F<README.vmesa>,
 L<perlebcdic>.
 
 =item *
@@ -2018,7 +2018,7 @@ http://www.perl.com/CPAN/ports/index.html for binary distributions.
 =head1 SEE ALSO
 
 L<perlaix>, L<perlamiga>, L<perlcygwin>, L<perldos>, L<perlepoc>,
-L<perlebcdic>, L<perlhpux>, L<perlos2>, L<perlos390>, L<perlposix-bc>,
+L<perlebcdic>, L<perlhpux>, L<perlos2>, L<perlos390>, L<perlbs2000>,
 L<perlwin32>, L<perlvms>, L<perlvos>, and L<Win32>.
 
 =head1 AUTHORS / CONTRIBUTORS
diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index 1c77054820..316cc936a0 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -236,8 +236,8 @@ unary &, unary *, (TYPE)
 =item Regexp Quote-Like Operators
 
 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
-qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
-s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
+qq/STRING/, "STRING", qr/STRING/imosx, qw/STRING/, qu/STRING/, qx/STRING/,
+`STRING`, s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 y/SEARCHLIST/REPLACEMENTLIST/cds
 
 =item Gory details of parsing quoted constructs
@@ -366,16 +366,17 @@ 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
+q/STRING/, qq/STRING/, qr/STRING/, qu/STRING/, qw/STRING/, qx/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,
@@ -1342,6 +1343,8 @@ C<(?(condition)yes-pattern|no-pattern)>
 
 =item DESCRIPTION
 
+=item Class Data in a Can
+
 =item Class Data as Package Variables
 
 =over 4
@@ -3813,14 +3816,14 @@ B<filter_fetch_value>
 
 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
-bytes_to_utf8, call_argv, call_method, call_pv, call_sv, CLASS, Copy,
-croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, dXSI32, ENTER,
-eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, get_av, get_cv,
-get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, gv_fetchmethod,
-gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
-G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
-HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete,
-hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
+bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv,
+CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS,
+dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS,
+get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth,
+gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY,
+G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY,
+HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear,
+hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
 isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
@@ -3830,10 +3833,9 @@ newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, newSVpv, newSVpvf,
 newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto,
 Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc,
 perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
-PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_modglobal,
-PL_na, PL_ofs_sv, PL_rs, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl,
-POPn, POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK,
-Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP,
+PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn,
+POPp, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew,
+Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP,
 SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE,
 StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp,
 SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV,
@@ -3876,7 +3878,8 @@ XS_VERSION_BOOTCHECK, Zero
 
 =item DESCRIPTION
 
-djSP, is_gv_magical, LVRET, start_glob
+djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
+PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob
 
 =item AUTHORS
 
@@ -3884,6 +3887,74 @@ djSP, is_gv_magical, LVRET, start_glob
 
 =back
 
+=head2 perliol - C API for Perl's implementation of IO in Layers.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item History and Background
+
+=item Layers vs Disciplines
+
+=item Data Structures
+
+1. The functions and attributes of the "layer class", 2. The per-instance
+data for a particular handle
+
+=item Functions and Attributes
+
+1. Opening and setup functions, 2. Basic IO operations, 3. Stdio class
+buffering options, 4. Functions to support Perl's traditional "fast" access
+to the buffer
+
+=item Per-instance Data
+
+=item Layers in action.
+
+=item Per-instance flag bits
+
+PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
+PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
+PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
+PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
+
+=item Methods in Detail
+
+IV	(*Fileno)(PerlIO *f);,	PerlIO *	(*Fdopen)(PerlIO_funcs
+*tab, int fd, const char *mode);,  PerlIO *	 (*Open)(PerlIO_funcs *tab,
+const char *path, const char *mode);,  int	     (*Reopen)(const char
+*path, const char *mode, PerlIO *f);,  IV	   (*Pushed)(PerlIO
+*f,const char *mode,const char *arg,STRLEN len);,  IV	      
+(*Popped)(PerlIO *f);,	SSize_t (*Read)(PerlIO *f, void *vbuf, Size_t
+count);,  SSize_t (*Unread)(PerlIO *f, const void *vbuf, Size_t count);, 
+SSize_t (*Write)(PerlIO *f, const void *vbuf, Size_t count);,  IV	   
+    (*Seek)(PerlIO *f, Off_t offset, int whence);,  Off_t	   
+(*Tell)(PerlIO *f);,  IV		(*Close)(PerlIO *f);,  IV	   
+    (*Flush)(PerlIO *f);,  IV		    (*Fill)(PerlIO *f);,  IV	   
+	(*Eof)(PerlIO *f);,  IV 	(*Error)(PerlIO *f);,  void	   
+    (*Clearerr)(PerlIO *f);,  void	    (*Setlinebuf)(PerlIO *f);, 
+STDCHAR *   (*Get_base)(PerlIO *f);,  Size_t		   
+(*Get_bufsiz)(PerlIO *f);,  STDCHAR *	(*Get_ptr)(PerlIO *f);,  SSize_t   
+    (*Get_cnt)(PerlIO *f);,  void	    (*Set_ptrcnt)(PerlIO *f,STDCHAR
+*ptr,SSize_t cnt);
+
+=item Core Layers
+
+"unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
+
+=item Extension Layers
+
+"encoding"
+
+=back
+
+=back
+
 =head2 perlapio - perl's IO abstraction interface.
 
 =over 4
@@ -3892,27 +3963,36 @@ djSP, is_gv_magical, LVRET, start_glob
 
 =item DESCRIPTION
 
-B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
-B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
+1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
+B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
+B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
-B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
-B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
-B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
+B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
+B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
+B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
 
 =over 4
 
 =item Co-existence with stdio
 
 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
-B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
-B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
-B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
-B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
-B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
+B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>
+
+=item "Fast gets" Functions
+
+B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
+B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
+B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
+B<PerlIO_get_bufsiz(f)>
+
+=item Other Functions
+
+PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
+'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
 
 =back
 
@@ -5279,6 +5359,49 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
 
 =back
 
+=head2 perlbs2000, README.posix-bc - building and installing Perl for
+BS2000 POSIX.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item gzip
+
+=item bison
+
+=item Unpacking
+
+=item Compiling
+
+=item Testing
+
+=item Install
+
+=item Using Perl
+
+=item Floating point anomalies
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list
+
+=back
+
+=item HISTORY
+
+=back
+
 =head2 perlcygwin, README.cygwin - Perl for Cygwin
 
 =over 4
@@ -5364,6 +5487,50 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perldos - Perl under DOS, W31, W95.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites
+
+DJGPP, Pthreads
+
+=item Shortcomings of Perl under DOS
+
+=item Building
+
+=item Testing
+
+=item Installation
+
+=back
+
+=item BUILDING AND INSTALLING MODULES
+
+=over 4
+
+=item Prerequisites
+
+=item Unpacking CPAN Modules
+
+=item Building Non-XS Modules
+
+=item Building XS Modules
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 perlepoc, README.epoc - Perl for EPOC
 
 =over 4
@@ -5746,50 +5913,13 @@ C<COND_WAIT>, F<os2.c>
 
 =item testing anomalies
 
-=item Usage Hints
-
-=item Modules and Extensions
-
-=back
-
-=item AUTHORS
-
-=item SEE ALSO
-
-=over 4
-
-=item Mailing list
-
-=back
-
-=item HISTORY
-
-=back
-
-=head2 perlposix-bc, README.posix-bc - building and installing Perl for
-BS2000 POSIX.
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item installation anomalies
 
-=over 4
-
-=item gzip
-
-=item bison
-
-=item Unpacking
-
-=item Compiling
-
-=item Testing
+=item Usage Hints
 
-=item Install
+=item Floating point anomalies
 
-=item Using Perl
+=item Modules and Extensions
 
 =back
 
@@ -5891,6 +6021,52 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =back
 
+=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Unpacking
+
+=item Setup and utilities
+
+=item Configure
+
+- Don't turn on the compiler optimization flag "-O".  There's	  a bug in
+the compiler (APAR PQ18812) that generates some bad code       the
+optimizer is on, - As VM/ESA doesn't fully support the fork() API programs
+relying on	 this call will not work. I've replaced fork()/exec() with
+spawn()       and the standalone exec() with spawn(). This has a side
+effect when	opening unnamed pipes in a shell script: there is no child
+process      generated under
+
+=item testing anomalies
+
+=item Usage Hints
+
+When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII
+character sets are different.  Perl builtin functions that may behave
+differently under EBCDIC are mentioned in the perlport.pod document.
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list
+
+=back
+
+=back
+
 =head2 perlvms - VMS-specific documentation for Perl
 
 =over 4
@@ -6004,6 +6180,48 @@ LIST, waitpid PID,FLAGS
 
 =back
 
+=head2 perlwin32 - Perl under Win32
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Setting Up
+
+Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
+
+=item Building
+
+=item Testing
+
+=item Installation
+
+=item Usage Hints
+
+Environment Variables, File Globbing, Using perl from the command line,
+Building Extensions, Command-line Wildcard Expansion, Win32 Specific
+Extensions, Running Perl Scripts, Miscellaneous Things
+
+=back
+
+=item BUGS AND CAVEATS
+
+=item AUTHORS
+
+Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
+E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
+E<lt>nick@ing-simmons.netE<gt>
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
 =head1 PRAGMA DOCUMENTATION
 
 =head2 attrs - set/get attributes of a subroutine (deprecated)
@@ -7987,17 +8205,17 @@ C<revision>, C<rm>, C<rmail>, C<runnm>
 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
-C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
-C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>,
-C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, C<siteprefixexp>,
-C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
-C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
-C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
-C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
-C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
-C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
-C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
-C<strings>, C<submit>, C<subversion>, C<sysman>
+C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
+C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
+C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
+C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
+C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
+C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
+C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
+C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
+C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
+C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
+C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
 
 =item t
 
@@ -12590,6 +12808,10 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item The test script output
 
+B<1..M>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
+B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
+B<Bail out!>, B<Comments>
+
 =back
 
 =item EXPORT
diff --git a/win32/Makefile b/win32/Makefile
index abd3b14163..49edc1ba42 100644
--- a/win32/Makefile
+++ b/win32/Makefile
@@ -1028,7 +1028,8 @@ utils: $(PERLEXE) $(X2P)
 	copy ..\README.machten .\perlmachten.pod
 	copy ..\README.os2 .\perlos2.pod
 	copy ..\README.os390 .\perlos390.pod
-	copy ..\README.posix .\perlposix.pod
+	copy ..\README.vmesa .\perlvmesa.pod
+	copy ..\README.bs2000 .\perlbs2000.pod
 	copy ..\README.solaris .\perlsolaris.pod
 	copy ..\vms\perlvms.pod .\perlvms.pod
 	copy ..\README.vos .\perlvos.pod
diff --git a/win32/makefile.mk b/win32/makefile.mk
index 9b1e3e7cf8..5a4a7385ac 100644
--- a/win32/makefile.mk
+++ b/win32/makefile.mk
@@ -1251,7 +1251,8 @@ utils: $(PERLEXE) $(X2P)
 	copy ..\README.machten ..\pod\perlmachten.pod
 	copy ..\README.os2 ..\pod\perlos2.pod
 	copy ..\README.os390 ..\pod\perlos390.pod
-	copy ..\README.posix-bc ..\pod\perlposix-bc.pod
+	copy ..\README.vmesa ..\pod\perlvmesa.pod
+	copy ..\README.bs2000 ..\pod\perlbs2000.pod
 	copy ..\README.solaris ..\pod\perlsolaris.pod
 	copy ..\vms\perlvms.pod ..\pod\perlvms.pod
 	copy ..\README.vos ..\pod\perlvos.pod