GNU 'merge' Simon's copy of perliol.pod with version
patched by Craig's patch.

p4raw-id: //depot/perlio@8591

PerlIO doc tweaks from Craig A. Berry <craig.berry@psinetcs.com>

p4raw-id: //depot/perlio@8590

Integrate change #8586 from maint-5.6/perl.

make the BOM detection code not call tell() until it has to
(meant to fix esoteric compatibility issues where PL_rsfp
is overridden)

p4raw-link: @8586 on //depot/maint-5.6/perl: 7b18f0b9fd425b568b9ff49e195709c84e549b71

p4raw-id: //depot/perl@8589
p4raw-integrated: from //depot/maint-5.6/perl@8588 'merge in' toke.c
(@8579..)

MAking Solaris malloc() the default
Message-ID: <20010129125936.Z4830@alanya.lupe-christoph.de>

The README.solaris part slightly tweaked.

p4raw-id: //depot/perl@8588

[ID 20010128.003] [PATCH] perlre.pod \b buglet
Message-Id: <200101281932.UAA15768@ak-75.mind.de>

p4raw-id: //depot/perl@8587

Update Changes.

p4raw-id: //depot/perl@8585

Integrate perlio:

[  8582]
Add pod/perliol.pod to MANIFEST :-(

[  8581]
PerlIO documentation. Proofing and sub-editing requested.

p4raw-link: @8582 on //depot/perlio: d5ed24328bb9459af92b6545aa51dd9d971234f0
p4raw-link: @8581 on //depot/perlio: 50b80e251bdb7e866faeb20ccfeb18b474ffc6cb

p4raw-id: //depot/perl@8584

Patch from Inaba Hiroto:
- canonical UTF-8 hash keys: if a key string for a hash is
  UTF8-on, try downgrade the string and use it if
  unicode::distinct is not in effect.
  For the task, I added a function bytes_from_utf8() to utf8.c.
  It might resemble utf8_to_bytes() but it is not convenient
  to the task.
  Made a test for it and added to t/op/each.t
- Changed do_print in doio.c to apply sv_utf8_(downgrade|upgrade) to
  the mortal copy of the argument SV.
  And changed t/io/utf8.t test 18 which expects print() to
  upgrade its argument.
- re-implement sv_eq with bytes_from_utf8()
- some bug fixes
  - tr/// does not handle UTF8 range (\x{}-\x{})
  - \ before raw UTF8 character produced
    "Malformed UTF-8 character" warning.
  - "\x{100}\N{CENT SIGN}" is Malformed.
    Added tests for these 3.
  - and one silly bug (by me) with qu operator.

p4raw-id: //depot/perl@8583

Add pod/perliol.pod to MANIFEST :-(

p4raw-id: //depot/perlio@8582

PerlIO documentation. Proofing and sub-editing requested.

p4raw-id: //depot/perlio@8581

Retract #8552.

p4raw-id: //depot/perl@8573

Integrate mainline

p4raw-id: //depot/perlio@8567

More documentation for the regexp context stack.

p4raw-id: //depot/perl@8566

Update Changes.

p4raw-id: //depot/perl@8565

Threadedness patch for #8562 from Doug MacEachern.

p4raw-id: //depot/perl@8564

[ID 20000808.005] OP_REFGEN as an lvalue
Message-ID: <14959.59703.507462.978833@soda.csua.berkeley.edu>

p4raw-id: //depot/perl@8563

Re: Announce : Tokener reporting patch
Message-ID: <20010122021722.A9334@pembro26.pmb.ox.ac.uk>

p4raw-id: //depot/perl@8562

Forgot from #8545.  Oops.

p4raw-id: //depot/perl@8561

A better module compilation test, use MANIFEST as suggested
by Spider.

p4raw-id: //depot/perl@8560

EBCDIC cleanup for B test
Message-ID: <Pine.OSF.4.10.10101261635400.14820-100000@aspara.forte.com>

p4raw-id: //depot/perl@8559

EBCDIC branch for pragma/sub-lval.t
Message-ID: <Pine.OSF.4.10.10101261603460.14820-100000@aspara.forte.com>

p4raw-id: //depot/perl@8558

a peek at uuencoded EBCDIC (st-06compat.t)
Message-ID: <Pine.OSF.4.10.10101261443561.14820-100000@aspara.forte.com>

p4raw-id: //depot/perl@8557

minor update to README.os390
Message-ID: <Pine.OSF.4.10.10101261425560.14820-100000@aspara.forte.com>

p4raw-id: //depot/perl@8556

No point in checking the length before we know whether the pointer
is bogus or not, fixes Abigail's odbm failures in Linux.

p4raw-id: //depot/perl@8555

Integrate mainline

p4raw-id: //depot/perlio@8554

(Retracted by #8573)

Subject: [PATCH Text::Wrap 2000.06292219] Spurious leading whitespace
Message-ID: <20010126092831.A15328@blackrider.aocn.com>

p4raw-id: //depot/perl@8552

Integrate mainline

p4raw-id: //depot/perlio@8550

Layout using tabulator is not a good idea in a pod.

p4raw-id: //depot/perl@8547

overload int()
Message-ID: <20010124190657.A8512@math.ohio-state.edu>

p4raw-id: //depot/perl@8545

completion and docs for dynamic loading on OS/390
Message-ID: <Pine.OSF.4.10.10101241706120.411912-100000@aspara.forte.com>

p4raw-id: //depot/perl@8544

SYN SYN

p4raw-id: //depot/vmsperl@8535

Integrate mainline.

p4raw-id: //depot/perlio@8534

Forgotten from #8501.

p4raw-id: //depot/perl@8533

RE: [PATCH perl@8269] Corrections for Perl_yylex_r (used by a reentrant parser as Bison)
Message-ID: <5930DC161690D21196670090271575470397E915@madt009a.siemens.es>

p4raw-id: //depot/perl@8532

Update Changes.

p4raw-id: //depot/perl@8531

De-cut-and-pasto.

p4raw-id: //depot/perl@8530

Document the mkdir trailing slashes case.

p4raw-id: //depot/perl@8529

lib/lib.pm is arch dependent, and lib/lib_pm.PL shouldn't
get installed:

Subject: lib/lib.pm
Message-ID: <20000829003508.21281.qmail@foad.org>

p4raw-id: //depot/perl@8528

Attach -perlio to the archname if so selected.

p4raw-id: //depot/perl@8526

pod/perlvar.pod
Message-ID: <20010123004110.22259.qmail@foad.org>

p4raw-id: //depot/perl@8525

A bug introduced in #8217 (the undefined variable in the
lib/safe1_t #3) fixed, by Charles Lane:

The earlier patch made it so that stuff running in Safe
compartments could do a "caller" and see "main".  That
little change in name is done right before the code in
the compartment is run, and apparantly the parser
was picking up the stash name before it got changed.

(why it was threaded vs. unthreaded Perl that was sensitive to this
I still don't know...and it probably doesn't matter).

I tryed removing the stash name-change and saw that threaded Perl
did indeed pass the lib/safe1.t tests.

So here's a patch; a routine (_safe_pkg_prep) is added to Opcode to
do the name change (and to connect _ in the compartment to the global
_) which is removed from _safe_call_sv.   Then Safe.pm is modified
to call _safe_pkg_prep when creating a new compartment.

Passes all tests with threaded perl on linux; passes all tests
with unthreaded perl on VMS.

At some point I'll probably want to revisit Safe and Opcode to
provide more sensible handling of global variables...and to get
formats working in Safe compartments, which they don't do currently.

p4raw-id: //depot/perl@8524

Also the lib/Thread.pm itself needs to be ignored if
the Thread extension hasn't been built.

p4raw-id: //depot/perl@8523

print() instead of warn() so that stderr doesn't get
unnecessarily polluted.

p4raw-id: //depot/perl@8522

Integrate perlio:

[  8520]
More messing with Encode:
Extra fields in header to allow multiple names and to record
other things "compile" knows.
Re-organise compile to factor out common output routines.

[  8519]
Change file-of-files command line from -F to -f to avoid case issues on VMS.

p4raw-link: @8520 on //depot/perlio: dcda1f94ccf07b68dc3a74b49b117aa6026f2557
p4raw-link: @8519 on //depot/perlio: 3865e8e16e47e0d7cb9fff45bba4e84e396abd42

p4raw-id: //depot/perl@8521

More messing with Encode:
  Extra fields in header to allow multiple names and to record
  other things "compile" knows.
  Re-organise compile to factor out common output routines.

p4raw-id: //depot/perlio@8520

Change file-of-files command line from -F to -f to avoid case issues on VMS.

p4raw-id: //depot/perlio@8519

Integrate mainline

p4raw-id: //depot/perlio@8518

Add sv_force_normal() to sv_utf8_downgrade() as suggested
by Inaba Hiroto.

p4raw-id: //depot/perl@8517

More SIG_SIZE fixes.

p4raw-id: //depot/perl@8516

typo in last week's configure.com frenzy
Message-Id: <p04330103b6917f35375b@[172.16.52.1]>

p4raw-id: //depot/perl@8515

VMS catches up with change #8501
Message-Id: <p04330101b691596f577f@[172.16.52.1]>

p4raw-id: //depot/perl@8514

Add the .ucm encoding tables to the MANIFEST.

p4raw-id: //depot/perl@8513

Integrate perlio:

[  8511]
Make "real" layers of ":utf8" and ":raw".
So now PERLIO=utf8 perl ...
does what Andreas wanted.
Fix arg passing in open.pm (still have a Carp issue).

[  8508]
Switch "compiled in" encodings to .ucm format.
(Leave others as .enc till we can run-time load .ucm,
or find some other way to load them.)

p4raw-link: @8511 on //depot/perlio: dfebf9581083f76d0f88d6a3edc9e5b72e852d91
p4raw-link: @8508 on //depot/perlio: e03ac09223e234f57407d65d0cb9cc67f3394e0a

p4raw-id: //depot/perl@8512

Make "real" layers of ":utf8" and ":raw".
 So now PERLIO=utf8 perl ...
does what Andreas wanted.
Fix arg passing in open.pm (still have a Carp issue).

p4raw-id: //depot/perlio@8511

Document the regex content pushing/popping a bit better.

p4raw-id: //depot/perl@8510

Tweak the mkdir trailing slash code some more.

TO DO: the same handling should probably be done for
all the other filesystem functions that can have directories
as their arguments.

p4raw-id: //depot/perl@8509

Switch "compiled in" encodings to .ucm format.
(Leave others as .enc till we can run-time load .ucm,
or find some other way to load them.)

p4raw-id: //depot/perlio@8508

Integrate (partial) mainline.

p4raw-id: //depot/perlio@8507

Update Changes.

p4raw-id: //depot/perl@8506

Minor typos in perlfaq2.pod
Message-Id: <200101192101.QAA11911@spotter.yi.org>

with a nit from Philip Newton.

p4raw-id: //depot/perl@8505

Sanity check for conflicting thread flavours.

p4raw-id: //depot/perl@8503

The SIG_SIZE is the number of the elements *excluding*
the terminating NULL.

p4raw-id: //depot/perl@8501

Integrate perlio:

[  8498]
Encode cleanup.
Add command line control over "compile" so that Makefile.PL
needs can be combined with other uses.
Use command line options in Makefile.PL.
Fix multi-byte parsing in .ucm files.

[  8497]
Warn and set errno when open(...,":encoding(xxxxx)",...) cannot find xxxxx.

[  8496]
Fixup after integrate:
missed the .sym files that are changed by regen_headers
sv.c and proto.h disagreed about pTHX_ ness of EXPECT_NUMBER.

[  8484]
Infrastructure to allow:
open($fh,"|-",@array);
to be implemented
i.e. mark pp_open as needing a stack mark, and make pp_open
process its args in that style (and pass them _all_ to tied handles OPEN).
Invent do_openn() which takes SV ** at allow it to see multiple args.
Note this does not _do_ anything yet.

p4raw-link: @8498 on //depot/perlio: afdae191a418d1363d2ddc3dcefffb0785c0a155
p4raw-link: @8497 on //depot/perlio: 52744f63cab71e4f408a2490707f42c331bb389e
p4raw-link: @8496 on //depot/perlio: 9dd79c3f9b66ee5059b4277b6f15d5bfcd846510
p4raw-link: @8484 on //depot/perlio: a567e93b903bc9849952c06533059c2f2e2fb226

p4raw-id: //depot/perl@8500

Re: 8482 busted for $^V sprintf()s on OS/390
Message-Id: <200101211334.NAA18121@crypt.compulink.co.uk>

In sprintf UTF8ize only if necessary.

p4raw-id: //depot/perl@8499

Encode cleanup.
Add command line control over "compile" so that Makefile.PL
needs can be combined with other uses.
Use command line options in Makefile.PL.
Fix multi-byte parsing in .ucm files.

p4raw-id: //depot/perlio@8498

Warn and set errno when open(...,":encoding(xxxxx)",...) cannot find xxxxx.

p4raw-id: //depot/perlio@8497

Fixup after integrate:
 missed the .sym files that are changed by regen_headers
 sv.c and proto.h disagreed about pTHX_ ness of EXPECT_NUMBER.

p4raw-id: //depot/perlio@8496

Integrate mainline.

p4raw-id: //depot/perlio@8495

Forgot the expect_number() prototype.

p4raw-id: //depot/perl@8494

README.vms URL updates
Message-ID: <Pine.OSF.4.10.10101191856510.61572-100000@aspara.forte.com>

Plus Craig A. Berry's suggestion to use compaq.com instead
of digital.com.

p4raw-id: //depot/perl@8493

Memory management calls documentation.

p4raw-id: //depot/perl@8492

Signedness nit plus few memcpy/Copy nits.

p4raw-id: //depot/perl@8491

minor typos in some dl_$foo.xs files
Message-ID: <Pine.OSF.4.10.10101191841080.61505-100000@aspara.forte.com>

p4raw-id: //depot/perl@8490

win32 Makefile(s) handle podified READMEs
Message-ID: <Pine.OSF.4.10.10101191828050.61158-100000@aspara.forte.com>

p4raw-id: //depot/perl@8489

remove redundant dependencies that are unneeded
Message-ID: <Pine.OSF.4.10.10101191816550.61158-100000@aspara.forte.com>

p4raw-id: //depot/perl@8488

partial support for dynaloading on OS/390
Message-ID: <Pine.OSF.4.10.10101191646420.61158-100000@aspara.forte.com>

p4raw-id: //depot/perl@8487

floating point mangling warnings for README.os390 and README.posix-bc
Message-ID: <Pine.OSF.4.10.10101191347140.59299-100000@aspara.forte.com>

p4raw-id: //depot/perl@8486

Document and test the new qu operator.

p4raw-id: //depot/perl@8485

Infrastructure to allow:
  open($fh,"|-",@array);
to be implemented
i.e. mark pp_open as needing a stack mark, and make pp_open
process its args in that style (and pass them _all_ to tied handles OPEN).
Invent do_openn() which takes SV ** at allow it to see multiple args.
Note this does not _do_ anything yet.

p4raw-id: //depot/perlio@8484

Integrate mainline.

p4raw-id: //depot/perlio@8483

Update Changes.

p4raw-id: //depot/perl@8482

Re: new feature: s?printf parameter reordering
Message-Id: <200101111709.RAA23756@crypt.compulink.co.uk>

- support reordering for all parameters: %, *v, *, .*
- lay down that the reordering specification must immediately
  follow that parameter: %3$, *v3$, *3$, .*3$
- fix vectorisation of a zero-length string
- factor out the code choosing the argument to format

Possibly unwanted side-effects:
- the special format specifiers ' +-0' must now precede any
  vectorisation specifier. Tests in op/sprintf and op/ver
  have been changed to reflect this.
- sprintf.t test #214 changed its expectations because in many
  cases, the next parameter has already been consumed when an
  invalid type letter is detected.

Probably wanted side-effects:
- attempts to format a non-existent parameter will warn as if C<undef>
- attempt to write to non-existent parameter with '%n' will complain
  of "attempt to modify read-only value" instead of being silent

p4raw-id: //depot/perl@8481

PATCH pragma/locale.t
Message-ID: <m3lms98czy.fsf@ak-71.mind.de>

p4raw-id: //depot/perl@8480

Add tracing for debugging extensions builds in VMS, from Charles Lane.

p4raw-id: //depot/perl@8479

Automate 1_compile.t.

p4raw-id: //depot/perl@8478

Integrate perlio:

[  8475]
Win32 "safe signals" co-existance fix.
Fix SIG_SIZE value.
Clear PL_sig_pending when cloning (fork).

p4raw-link: @8475 on //depot/perlio: 66fe0623488f98a7806a1e9f1451648932318696

p4raw-id: //depot/perl@8477

Integrate mainline

p4raw-id: //depot/perlio@8476

Win32 "safe signals" co-existance fix.
Fix SIG_SIZE value.
Clear PL_sig_pending when cloning (fork).

p4raw-id: //depot/perlio@8475

It's Pod::Text::Overstrike, not Pod::Overstrike.

p4raw-id: //depot/perl@8474

The first bug found by 1_compile.t.

p4raw-id: //depot/perl@8472

Add Schwern's 1_compile test.  The compile_module script renamed
to be a bit shorter for the 8.3 people.

p4raw-id: //depot/perl@8471

Re: subversion undef on VMS (was Re: [ID 20001218.033] Not OK: perl v5.6.1 +v5.6.1-TRIAL1 on   VMS_AXP V7.2-1)
Message-ID: <Pine.OSF.4.10.10101171255380.289071-100000@aspara.forte.com>
Replace #8462.

p4raw-id: //depot/perl@8469

Integrate perlio:

[  8467]
"Safe" signals - trial implementation.
gv.c tweaked to zero PL_sig_pend array
perlio.c tweaked to PERL_ASYNC_CHECK() on EINTR
util.c tweaked to not set SA_RESTART to give perlio.c a chance.
Odd thing is that it "works" with PERLIO=stdio as well (linux).

p4raw-link: @8467 on //depot/perlio: 0a8e0eff0300ee74cef43b18ff11d05a6376450e

p4raw-id: //depot/perl@8468

"Safe" signals - trial implementation.
 gv.c tweaked to zero PL_sig_pend array
 perlio.c tweaked to PERL_ASYNC_CHECK() on EINTR
 util.c tweaked to not set SA_RESTART to give perlio.c a chance.
Odd thing is that it "works" with PERLIO=stdio as well (linux).

p4raw-id: //depot/perlio@8467

Integrate mainline.

p4raw-id: //depot/perlio@8466

Re: [PATCH: perl@8429]  lib/tie-substrhash.t FAILED at test 11
Message-ID: <20010117173133.I2633@plum.flirble.org>

p4raw-id: //depot/perl@8465

lib/tie-substrhash.t FAILED at test 11
Message-ID: <5930DC161690D2119667009027157547038C8A85@madt009a.siemens.es>

pp_int() was dropping an NV to the floor,
int(279964589018079/59) either returned not an integer
4745162525730.15, or one got "Attempt to free unreferenced scalar."

p4raw-id: //depot/perl@8464

(Replaced by #8469)

Subject: subversion undef on VMS (was Re: [ID 20001218.033] Not OK: perl v5.6.1 +v5.6.1-TRIAL1 on   VMS_AXP V7.2-1)
Message-Id: <p04330103b68ad8cfcbfd@[172.16.52.1]>

p4raw-id: //depot/perl@8462

Allow for one trailing slash in the directory of mkdir().

p4raw-id: //depot/perl@8461

Define SIG_SIZE, the number of elements in the sig_name and
sig_num arrays, including the final NULL entry.

p4raw-id: //depot/perl@8459