From: Jarkko Hietaniemi Date: Fri, 9 Feb 2001 15:11:13 +0000 (+0000) Subject: Rename README.posix-bc to README.bs2000 to avoid confusion X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=dc5c060f96a5de06c9e1797503c70e8155e23e3e;p=p5sagit%2Fp5-mst-13.2.git 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 --- diff --git a/MANIFEST b/MANIFEST index ecb3e51..2855857 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 similarity index 100% rename from README.posix-bc rename to README.bs2000 diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL index f2dba95..1e55649 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 4e08cc8..7f63204 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 08a1704..de2d855 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -1066,7 +1066,7 @@ Also see: * -L, F, F, F, +L, F, F, F, L. =item * @@ -2018,7 +2018,7 @@ http://www.perl.com/CPAN/ports/index.html for binary distributions. =head1 SEE ALSO L, L, L, L, L, -L, L, L, L, L, +L, L, L, L, L, L, L, L, and L. =head1 AUTHORS / CONTRIBUTORS diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 1c77054..316cc93 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 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, B, B, B, -B, B, +1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B, +B, B, B, +B, B, B, B, B, B, B, B, B, B, B, B, B, B, B, -B, B, B, -B, B, B, -B, B +B, B, B, +B, B, B, +B, B, B =over 4 =item Co-existence with stdio B, B, -B, B, B, -B, B, B, -B, B, -B, B, B, -B, B +B, B + +=item "Fast gets" Functions + +B, B, B, +B, B, B, +B, B, B, +B + +=item Other Functions + +PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), +'E' read, 'E' 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, F =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 E71564.1743@CompuServe.COME, Gurusamy Sarathy +Egsar@activestate.comE, Nick Ing-Simmons +Enick@ing-simmons.netE + +=item SEE ALSO + +=item HISTORY + +=back + =head1 PRAGMA DOCUMENTATION =head2 attrs - set/get attributes of a subroutine (deprecated) @@ -7987,17 +8205,17 @@ C, C, C, C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C =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, +B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, +B, B + =back =item EXPORT diff --git a/win32/Makefile b/win32/Makefile index abd3b14..49edc1b 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 9b1e3e7..5a4a738 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