updated perlreftut.pod

p4raw-id: //depot/perl@2394

misc tweaks

p4raw-id: //depot/perl@2393

notes about -DPERL_POLLUTE

p4raw-id: //depot/perl@2392

explain various win32 build caveats more clearly

p4raw-id: //depot/perl@2391

remove I_POLL detection (Configure will do that now)

p4raw-id: //depot/perl@2390

add p4desc (augments 'p4 describe' output with diffs for new files)

p4raw-id: //depot/perl@2388

another threads reliability fix: serialize writes to thr->threadsv
avoid most uses of PL_na (which is much more inefficient than a
simple local); update docs to suit; PL_na now being thr->Tna may
be a minor compatibility issue for extensions--will require dTHR
outside of XSUBs (those get automatic dTHR)

p4raw-id: //depot/perl@2387

various fixes for race conditions under threads: mutex locks based
on PL_threadnum were seriously flawed, since it means more than one
thread could enter the critical region; PL_na was global instead of
thread-local; child thread could finish and free thr structures
before Thread->new() got around to creating the Thread object;
cv_clone() needed locking, as it mucks with PL_comppad and other
global data; new_struct_thread() needed to lock template-thread's
mutex while copying its data

p4raw-id: //depot/perl@2385

s/warn/print/ on multiply defined groups

p4raw-id: //depot/perl@2384

backout change#2334

p4raw-link: @2334 on //depot/perl: 60ad88b8fe9480f2f097fca26f4f3a9f83a4f830

p4raw-id: //depot/perl@2383

prefer IO::Handle for IO if FileHandle:: is empty (as suggested by
Tim Bunce)

p4raw-id: //depot/perl@2380

fix for pat.t failure under USE_THREADS

p4raw-id: //depot/perl@2379

More C.pm tweaks
  Save globs even if we have saved cv itself before - may be imported.

  While we don't save "bootstrap" CV we need to provide a stub,
  so that if we require it later we don't fall through and attempt
  to DynaLoad module again.

  Attempt to save %INC so that "require" does not reload things
  we have compiled-in (does not work right yet - seems to be due
  to PL_incgv being created in perl_parse() current scheme setting
  GvHV() is "better" than saving the glob, but still does not
  work as I expect).

p4raw-id: //depot/perl@2378

various tweaks; result passes all tests for normal build on Solaris;
fails two pat.t tests under USE_THREADS; io_poll.t test#3 fails on
win32 due to lack of select() that works on non-socket fds

p4raw-id: //depot/perl@2377

add $config_args to perl -V display (suggested by Ilya Zakharevich)

p4raw-id: //depot/perl@2376

integrate cfgperl changes into mainline

p4raw-id: //depot/perl@2375

Yet another OS/2 patch

Message-Id: <199811050721.CAA27998@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2374

Change $#+

Message-Id: <199811280651.BAA18095@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2373

Finishing off SNOBOL: $1 in (?{})

Message-Id: <199811280533.AAA25654@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2372

better -Mre=debugcolor

Message-Id: <199811272116.QAA03502@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2371

regcolors

Message-Id: <199811272022.PAA17874@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2370

allow final period in a file (not followed by a newline) to
terminate format spec

p4raw-id: //depot/perl@2369

Liblist tweak suggested by Swen Thuemmler <Swen.Thuemmler@paderlinx.de>;
add C<$Config{installarchlib}/CORE> to the default locations searched
on win32

p4raw-id: //depot/perl@2368

applied suggested patch with PERL_OBJECT tweaks
Message-Id: <199811260746.CAA23164@monk.mps.ohio-state.edu>
Subject: [PATCH 5.005_53] Enable $_ and pos() inside (?{ CODE }) in RExen

p4raw-id: //depot/perl@2367

additional documentation for qr//
Message-Id: <199811260751.CAA24560@monk.mps.ohio-state.edu>
Subject: [PATCH 5.005_*] Documentation (fwd)

p4raw-id: //depot/perl@2366

Fix \G in REx without //g

Message-Id: <199811260433.XAA29281@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2365

update Test.pm to Test-1.12; tweak 're' detection

p4raw-id: //depot/perl@2364

avoid command-line quoting portability problems in lex_assign.t

p4raw-id: //depot/perl@2363

PATCH: document English.pm sawampersand and thread issues

Message-Id: <m0zgZWx-000FOgC@feynman.localnet>

p4raw-id: //depot/perl@2362

fix uninitialized warnings
Message-Id: <3654CA96.B64FCAEB@itginc.com>
Subject: Complete.pm patch (version 1.1)

p4raw-id: //depot/perl@2361

s/Array/List/ suggested by John Tobey

p4raw-id: //depot/perl@2360

update tie() entry in perlfunc to reflect TIEARRAY and TIEHANDLE

p4raw-id: //depot/perl@2359

Revamp the locale tests.
(0) Instead of rewiring a few locales scan for them.
(1) Bogus test #101 removed.
(2) All the locales are checked, the lists of failed
    and non-failed ones are displayed.
(3) The test #103 is again 'active' so that it may fail.
(4) To balance (3) a hopefully pacifying message is shown
    if the #103 fails.

p4raw-id: //depot/cfgperl@2358

add perlreftut.pod

p4raw-id: //depot/perl@2357

Change #2346 fallout.

p4raw-id: //depot/cfgperl@2356

IO.xs tweaks; avoid coredump in io_xs.t; remove newCONSTSUB();
ANSI prototypes

p4raw-id: //depot/perl@2355

add IO-1.20; mess with t/lib/io_*.t in an attempt to
keep platform hacks that aren't in the 1.20 dist; add new files
to MANIFEST; hack Makefile.PL; result hasn't been tested
anywhere

p4raw-id: //depot/perl@2354

Locale collation, ctype, and numeric, were initialized wrong
(if LC_ALL or LANG were unset, so were the collation/ctype/numeric),
as reported by
Subject: a bug in locale handling: LC_COLLATE ignored sometimes
To: perlbug@perl.com
Message-ID: <MLIST_199811250226.SAA12590@axi001.etak.sw>

p4raw-id: //depot/cfgperl@2353

Implement $^C to allow perl access to -c flag - I think this
was agreed once...

p4raw-id: //depot/perl@2352

Change #2251 fixup.

p4raw-id: //depot/cfgperl@2351

Integrate from mainperl.

p4raw-id: //depot/cfgperl@2350

Passwd and group file groveling.

p4raw-id: //depot/cfgperl@2349

more conservative version of changes#2345,2346,2347; those break
C<defined(@{"foo::ISA"})> which seems to be extensively used in
the libs :-(

p4raw-link: @2347 on //depot/perl: bbc8e6a4a34cbf904dc23fa18f4e503924aea3f8
p4raw-link: @2346 on //depot/perl: 659eaf7385567ca82dd230a62d6a7f51364f0d0a
p4raw-link: @2345 on //depot/perl: 6b377df57679ab68ed17b736ebee0458acb25b21

p4raw-id: //depot/perl@2348

tweak bogus test

p4raw-id: //depot/perl@2347

test cases for previous change

p4raw-id: //depot/perl@2346

fix typo in pp_defined() causing C<defined %tied> to fail

p4raw-id: //depot/perl@2345

s/comment/comment_t/ tweak (suggested by John Gorman
<jgorman@webbysoft.com>)

p4raw-id: //depot/perl@2344

add (stub) perldelta.pod

p4raw-id: //depot/perl@2343

rename perldelta.pod to perl5005delta.pod in preparation for
starting a new one

p4raw-id: //depot/perl@2342

fix MALLOC_LOCK #define

p4raw-id: //depot/perl@2341

OS/2 events get closer to Perl

Message-Id: <199811160125.UAA05268@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2340

Add -lm to dynix/ptx POSIX hints.
To: jhi@iki.fi
Subject: Re: Making Perl work on DYNIX/ptx
Message-ID: <1457015007.911990081@w-186d219.rhe.sequent.com>

p4raw-id: //depot/cfgperl@2339

Detypo.

p4raw-id: //depot/cfgperl@2338

Better LD_LIBRARY_PATH instructions for Bourneists.

p4raw-id: //depot/cfgperl@2337

teach CPAN.pm to ignore beta perl distributions when looking for
modules
Message-Id: <199811130408.XAA10578@dogberry.rutgers.edu>
Subject: recompile tries getting a perl distribution

p4raw-id: //depot/perl@2336

make $1 et al readonly under threads; make C<undef $1> fail like
C<$1 = undef> does

p4raw-id: //depot/perl@2335

s/Regexp/re/ and clarify policy on lowercased object namespaces

p4raw-id: //depot/perl@2334

document changed PERL_HASH()

p4raw-id: //depot/perl@2333

Handle INIT list in C.pm
1. Provide init_av() from B.xs
2. Export it in B.pm
3. Use it in C.pm
Also disable some pruning in savecv() which seems to undo
my previous patch.
Experimental feature - save pathnames of .so files in easily
grep-able form for use in wrapper to feed to linker.

p4raw-id: //depot/perl@2332

integrate change#2315 from maint-5.005

p4raw-link: @2315 on //depot/maint-5.005/perl: 7a4920e67d1e2d67a4397a908141c6608866ebb0

p4raw-id: //depot/perl@2327
p4raw-integrated: from //depot/maint-5.005/perl@2326 'ignore' op.c
(@2310..) 'merge in' sv.c (@2174..)

integrate changes#2304,2305,2306,2308 from maint-5.005

p4raw-link: @2308 on //depot/maint-5.005/perl: d9ff4e059542b05c512829c494eaa4d1a8c96869
p4raw-link: @2306 on //depot/maint-5.005/perl: 82bf2b55a275313af7da5198d3567127a2b619bb
p4raw-link: @2305 on //depot/maint-5.005/perl: fa8a3fc69bb318b2e84481c2b7919cb81c822866
p4raw-link: @2304 on //depot/maint-5.005/perl: 566aa6395795ff6a5a86565ea7a90bf3211e26a1

p4raw-id: //depot/perl@2326
p4raw-integrated: from //depot/maint-5.005/perl@2325 'copy in'
ext/DynaLoader/dl_mpeix.xs lib/ExtUtils/typemap (@1649..)
installperl (@2134..) lib/ExtUtils/MM_VMS.pm
lib/ExtUtils/MakeMaker.pm (@2154..) lib/ExtUtils/MM_Unix.pm
(@2304..)

malloc bugfix and documentation from Ilya Zakharevich
Date: Tue, 24 Nov 1998 17:24:55 -0500 (EST)
Message-Id: <199811242224.RAA22618@monk.mps.ohio-state.edu>
Subject: [PATCH 5.005_*] Re: Internal coredump
--
Date: Thu, 26 Nov 1998 03:06:10 -0500 (EST)
Message-Id: <199811260806.DAA28913@monk.mps.ohio-state.edu>
Subject: [PATCH 5.005_*] malloc.c documentation

p4raw-id: //depot/perl@2325

B::C tweaks to allow Tk compiles from Nick Ing-Simmons

p4raw-id: //depot/perl@2324

format "..." bug

Message-Id: <199811240137.KAA05867@luna.src.ricoh.co.jp>

p4raw-id: //depot/perl@2323

add ext/Devel/Peek
Message-ID: <36589ec9.49964585@smtp1.ibm.net>
Subject: [PATCH 5.005_53] Devel::Peek integration

p4raw-id: //depot/perl@2322

ensure 'make regen_headers' even without perl installed
(suggested by Ilya Zakharevich)

p4raw-id: //depot/perl@2321

Cosmetic malloc patch

Message-Id: <199811100003.TAA05815@monk.mps.ohio-state.edu>

p4raw-id: //depot/perl@2320

eliminate dup hunk from integration

p4raw-id: //depot/perl@2319

integrate cfgperl changes into mainline

p4raw-id: //depot/perl@2318

C<-x>.

p4raw-id: //depot/cfgperl@2317

Integrate from mainperl.

p4raw-id: //depot/cfgperl@2316

fix PL_defoutgv leak under threads

p4raw-id: //depot/perl@2301

properly free temporaries created by threads

p4raw-id: //depot/perl@2300

fix C<if (...) { package Foo; ... }> misoptimization that fails
to set the package for the block properly

p4raw-id: //depot/perl@2299

Part-1 of tweaks to allow Tk to be "compiled"
Make XS_UNIVERSAL_xxx non-static so they can be found in libperl.
(May also need attention to exports etc. - to follow.)

p4raw-id: //depot/perl@2298

The new socket tests need in some platforms
to #include <sys/types.h>.

p4raw-id: //depot/cfgperl@2294

Re: Test results for perl5.005_53 under NEXTSTEP 3.3 (intel)

To: Jarkko Hietaniemi <jhi@cc.hut.fi>
Message-Id: <9811230907.AA06484@AWT.nl>

NeXTstep NetInfo uses nidump to get the user/group databases.

p4raw-id: //depot/cfgperl@2293

Change#2284 aid: allow also for plain old MSG_ and SCM_ #defines.

p4raw-id: //depot/cfgperl@2286

MSG_PROXY for GNU/Hurd (previously we believed that
all GNU libc platforms have MSG_PROXY.  Untrue).
In fact this ended up as a major MSG_* and SCM_*
update.  The MSG_XXX known to be enums in some
versions of the glibc are now probed for and respective
HAS_MSG_XXX are defined.  While I was at it I noticed
SCM_RIGHTS being similarly an enum.  This reminded me of
an ancient discussion in perl5-porters:
http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/9612/msg01017.html
The BSD socket interface has a nifty feature for passing
file descriptors and credentials--via sockets.  It may be
too late to add this functionality to the CORE but
at least Configure now probes for the functions,
structs, and includes, defining the appropriate
HAS_YYY and I_ZZZ, and the Socket extension exports
the constants, in case somebody wants to write an
extension for this interface.

p4raw-id: //depot/cfgperl@2285

perlhist.pod 1.54, containing 5_53.

p4raw-id: //depot/cfgperl@2284

Fix thinko.

p4raw-id: //depot/cfgperl@2268

Document the d_socket override.

p4raw-id: //depot/cfgperl@2267

perlfaq typos
To: perl5-porters@perl.com
Message-ID: <MLIST_m0zhPeF-000FOgC@feynman.localnet>

p4raw-id: //depot/cfgperl@2266

DB_File 1.61 patch for 5.005_53 & 5.005_02
Newsgroups: hut.lists.perl5-porters
To: gsar@engin.umich.edu (Gurusamy Sarathy)
Cc: perl5-porters@perl.org (Perl5 Porters)

p4raw-id: //depot/cfgperl@2265

NeXTstep /etc/group and /etc/passwd are used only at boot time,
Subject: Test results for perl5.005_53 under NEXTSTEP 3.3 (intel)
To: perlbug@perl.com
Lines: 47
Message-ID: <MLIST_9811201533.AA22148@AWT.nl>

p4raw-id: //depot/cfgperl@2264

Permission testing is tricky when we have too much power.
Problem reported in
Subject: Test results for perl5.005_53 under NEXTSTEP 3.3 (intel)
To: perlbug@perl.com
Message-ID: <MLIST_9811201533.AA22148@AWT.nl>

p4raw-id: //depot/cfgperl@2263

fix broken CAPI generation

p4raw-id: //depot/perl@2262

-x should be C<-x>, reported by Gerben Wierda.

p4raw-id: //depot/cfgperl@2261

phase 2 of PERL_OBJECT cleanup; objXSUB.h autogeneration

p4raw-id: //depot/perl@2260

Re: [PATCH] Re: pod2man bug in date generated line
To: Albert Dvornik <bert@genscan.com>, "Larry W. Virden" <lvirden@cas.org>
Cc: perlbug@perl.com
Message-ID: <MLIST_19981120131523.A464@O2.chapin.edu>

p4raw-id: //depot/cfgperl@2259

Benchmark.pm suggestion
To: jhi@iki.fi, Tim.Bunce@ig.co.uk
Message-Id: <199811202243.RAA26252@harp.camb.inmet.com>

Added timesum().

p4raw-id: //depot/cfgperl@2256

another win32 portability fix: make sysread() and syswrite()
work on sockets

p4raw-id: //depot/perl@2255

win32_recvfrom() compatibility fix

p4raw-id: //depot/perl@2254

MPE/iX Perl 5.005_02 oops

To: jhi@iki.fi
Message-Id: <199811200110.RAA07395@spock.dis.cccd.edu>

p4raw-id: //depot/cfgperl@2253

mess_sv tweak for change#2249

p4raw-link: @2249 on //depot/perl: e72dc28c8f6f33daa2b69b80b6322e338e999561

p4raw-id: //depot/perl@2252

Display use64bits and usemultiplicity but only if necessary.

p4raw-id: //depot/cfgperl@2251

pp.c uses 'unsigned Quad_t'
To: perlbug@perl.com
Message-Id: <199811152357.UAA12768@sleipnir.valparaiso.cl>

p4raw-id: //depot/cfgperl@2250

use PL_mess_sv only during global destruction (fixes problems with
overlapping invocations of form()/warn()/die()/croak() trampling on
each other's messages)

p4raw-id: //depot/perl@2249

tweak change#2245 to skip previous message if any

p4raw-link: @2245 on //depot/perl: a99e4ac224ca891463a7704e48b83906ece3bb7c

p4raw-id: //depot/perl@2248

Integrate from mainperl.

p4raw-id: //depot/cfgperl@2247