Remove target before link() of perldiag.pod

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Reduce memory footprint of literal strings

(this is the same change as commit 1bd69d1d0fa002def016e601cb71bfcd93600bd3, but as applied)

Reduce memory footprint of literal strings

Subject: Fix for memory allocation on 'string'

Currently qq/a/ takes 2/3 of memory of "a" or 'a'. Test with

> env PERL_DEBUG_MSTATS=2 perl -e '$#a=10000; $a[$i] = qq// while $i++ <10000'

Memory allocation statistics after compilation: (buckets 8..8192)
   17552 free:     0     9    24    16    16   3   1     2   1 0 1
   43888 used:     0   119   232   176    16   5   3    10   0 0 1
Total sbrk():    61800. Odd ends: sbrk():     360, malloc():       0 bytes.
Memory allocation statistics after execution:   (buckets 8..65536)
   17136 free:     0   121    21    15    16   3   1     0   1 0 1 0 0 0
  515344 used:     0 10119   235   177    16   5   3   250   0 0 1 0 0 1
Total sbrk():   532840. Odd ends: sbrk():     360, malloc():       0 bytes.

> env PERL_DEBUG_MSTATS=2 perl -e '$#a=10000; $a[$i] = "a" while $i++ <10000'

Memory allocation statistics after compilation: (buckets 8..8192)
   17520 free:     0     9    23    16    16   3   1     2   1 0 1
   43920 used:     0   119   233   176    16   5   3    10   0 0 1
Total sbrk():    61800. Odd ends: sbrk():     360, malloc():       0 bytes.
Memory allocation statistics after execution:   (buckets 8..65536)
   17616 free:     0   121     4    15    16   3   1     1   1 0 1 0 0 0
  713520 used:     0 10119 10236   177    16   5   3   131   0 0 1 0 0 1
Total sbrk():   731496. Odd ends: sbrk():     360, malloc():       0 bytes.

The following patch fixes it:

p5p-msgid: 1997Apr1.113438.1913905@hmivax.humgen.upenn.edu

Don't use a completely empty macro parameter

Improve definition of Sock_size_t

Don't use setjmp() and longjmp() in complex exprs

[differences between cumulative patch application and perl-5.003_96]

[inseperable changes from patch from perl-5.003_95 to perl-5.003_86]

[editor's note: this commit was prepared manually so may differ in
minor ways to other inseperable changes commits]

 CORE LANGUAGE CHANGES

  Title:  "Support $ENV{PERL5OPT}"
   From:  Chip Salzenberg
  Files:  perl.c pod/perldiag.pod pod/perldelta.pod pod/perlrun.pod

  Title:  "Implement void context, in which C<wantarray> is undef"
   From:  Chip Salzenberg
  Files:  cop.h doop.c dump.c global.sym gv.c op.c op.h perl.c
          pod/perlcall.pod pod/perldelta.pod pod/perlfunc.pod
          pod/perlguts.pod pod/perlsub.pod pp.c pp_ctl.c pp_hot.c
          pp_sys.c proto.h

  Title:  "Don't look up &AUTOLOAD in @ISA when calling plain function"
   From:  Chip Salzenberg
  Files:  global.sym gv.c lib/Text/ParseWords.pm pod/perldelta.pod
          pp_hot.c proto.h t/op/method.t

  Title:  "Allow closures to be constant subroutines"
   From:  Chip Salzenberg
  Files:  op.c

  Title:  "Make C<scalar(reverse)> mean C<scalar(reverse $_)>"
   From:  Chip Salzenberg
  Files:  pp.c

  Title:  "Fix lexical suicide from C<my $x = $x> in sub"
   From:  Chip Salzenberg
  Files:  op.c

  Title:  "Make "Unrecog. char." fatal, and update its doc"
   From:  Chip Salzenberg
  Files:  pod/perldiag.pod toke.c

 CORE PORTABILITY

  Title:  "safefree() mismatch"
   From:  Roderick Schertler
 Msg-ID:  <21338.859653381@eeyore.ibcinc.com>
   Date:  Sat, 29 Mar 1997 11:36:21 -0500
  Files:  util.c

    (applied based on p5p patch as commit id 9b9b466fb02dc96c81439bafbb3b2da55238cfd2)

  Title:  "Win32 update (seven patches)"
   From:  Gurusamy Sarathy and Nick Ing-Simmons
  Files:  EXTERN.h MANIFEST win32/Makefile win32/perl.mak
          win32/perl.rc win32/perldll.mak win32/makedef.pl
          win32/modules.mak win32/win32io.c win32/bin/pl2bat.bat

 OTHER CORE CHANGES

  Title:  "Report PERL* environment variables in -V and perlbug"
   From:  Chip Salzenberg
  Files:  perl.c utils/perlbug.PL

  Title:  "Typo in perl.c: Printing NO_EMBED for perl -V"
   From:  Gisle Aas
 Msg-ID:  <199703301922.VAA13509@furubotn.sn.no>
   Date:  Sun, 30 Mar 1997 21:22:11 +0200
  Files:  perl.c

    (applied based on p5p patch as commit id b6c639e4b1912ad03b9b10ba9518d96bd0a6cfaf)

  Title:  "Don't let C<$var = $var> untaint $var"
   From:  Chip Salzenberg
  Files:  pp_hot.c pp_sys.c sv.h t/op/taint.t

  Title:  "Fix autoviv bug in C<my $x; ++$x->{KEY}>"
   From:  Chip Salzenberg
  Files:  pp_hot.c

  Title:  "Re: 5.004's new srand() default seed"
   From:  Hallvard B Furuseth
 Msg-ID:  <199703302219.AAA20998@bombur2.uio.no>
   Date:  Mon, 31 Mar 1997 00:19:13 +0200 (MET DST)
  Files:  pp.c

    (applied based on p5p patch as commit id d7d933a26349f945f93b2f0dbf85b773d8ca3219)

  Title:  "Re: embedded perl and top_env problem "
   From:  Gurusamy Sarathy
 Msg-ID:  <199703280031.TAA05711@aatma.engin.umich.edu>
   Date:  Thu, 27 Mar 1997 19:31:42 -0500
  Files:  gv.c interp.sym perl.c perl.h pp_ctl.c pp_sys.c scope.h util.c

    (applied based on p5p patch as commit id f289f7d2518e7a8a82114282e774adf50fa6ce85)

  Title:  "Define and use new macro: boolSV()"
   From:  Tim Bunce
  Files:  gv.c lib/ExtUtils/typemap os2/os2.c pp.c pp_hot.c pp_sys.c
          sv.c sv.h universal.c vms/vms.c

  Title:  "Re: strict @F"
   From:  Hallvard B Furuseth
 Msg-ID:  <199703252110.WAA16038@bombur2.uio.no>
   Date:  Tue, 25 Mar 1997 22:10:33 +0100 (MET)
  Files:  toke.c

    (applied based on p5p patch as commit id dfd44a5c8c8dd4c001c595debfe73d011a96d844)

  Title:  "Try harder to identify errors at EOF"
   From:  Chip Salzenberg
  Files:  toke.c

  Title:  "Minor string change in toke.c: 'bareword'"
   From:  lvirden@cas.org
 Msg-ID:  <1997Mar27.130247.1911552@hmivax.humgen.upenn.edu>
   Date:  Thu, 27 Mar 1997 13:02:46 -0500 (EST)
  Files:  toke.c

    (applied based on p5p patch as commit id 9b56c8f8085a9e773ad87c6b3c1d0b5e39dbc348)

  Title:  "Improve diagnostic on \r in program text"
   From:  Chip Salzenberg
  Files:  pod/perldiag.pod toke.c

  Title:  "Make Sock_size_t typedef work right"
   From:  Chip Salzenberg
  Files:  perl.h pp_sys.c

 LIBRARY AND EXTENSIONS

  Title:  "New module constant.pm"
   From:  Tom Phoenix
  Files:  MANIFEST lib/constant.pm op.c pp.c t/pragma/constant.t

  Title:  "Remove chat2"
   From:  Chip Salzenberg
  Files:  MANIFEST lib/chat2.inter lib/chat2.pl

  Title:  "Include CGI.pm 2.32"
   From:  Chip Salzenberg
  Files:  MANIFEST eg/cgi/* lib/CGI.pm lib/CGI/Apache.pm
          lib/CGI/Carp.pm lib/CGI/Fast.pm lib/CGI/Push.pm
          lib/CGI/Switch.pm

 UTILITIES

  Title:  "Tom C's Pod::Html and html tools, as of 30 March 97"
   From:  Chip Salzenberg
  Files:  MANIFEST installhtml lib/Pod/Html.pm pod/pod2html.PL

  Title:  "Fix path bugs in installhtml"
   From:  Robin Barker <rmb1@cise.npl.co.uk>
 Msg-ID:  <3180.9703270906@tempest.cise.npl.co.uk>
   Date:  Thu, 27 Mar 97 09:06:14 GMT
  Files:  installhtml

  Title:  "Make perlbug say that it's only for core Perl bugs"
   From:  Chip Salzenberg
  Files:  utils/perlbug.PL

 DOCUMENTATION

  Title:  "Document autouse and constant; update diagnostics"
   From:  Chip Salzenberg
  Files:  pod/perldelta.pod

  Title:  "Suggest to upgraders that they try '-w' again"
   From:  Hallvard B Furuseth
 Msg-ID:  <199703251901.UAA15982@bombur2.uio.no>
   Date:  Tue, 25 Mar 1997 20:01:26 +0100 (MET)
  Files:  pod/perldelta.pod

    (applied based on p5p patch as commit id 4176c059b9ba6b022e99c44270434a5c3e415b73)

  Title:  "Improve and update documentation of constant subs"
   From:  Tom Phoenix <rootbeer@teleport.com>
 Msg-ID:  <Pine.GSO.3.96.970331122546.14185C-100000@kelly.teleport.com>
   Date:  Mon, 31 Mar 1997 13:05:54 -0800 (PST)
  Files:  pod/perlsub.pod

  Title:  "Improve documentation of C<return>"
   From:  Chip Salzenberg
  Files:  pod/perlfunc.pod pod/perlsub.pod

  Title:  "perlfunc.pod patch"
   From:  Gisle Aas
 Msg-ID:  <199703262159.WAA17531@furubotn.sn.no>
   Date:  Wed, 26 Mar 1997 22:59:23 +0100
  Files:  pod/perlfunc.pod

    (applied based on p5p patch as commit id 35a731fcbcd7860eb497d6598f3f77b8746319c4)

  Title:  "Use 'while (defined($x = <>)) {}', per <gnat@frii.com>"
   From:  Chip Salzenberg
  Files:  configpm lib/Term/Cap.pm perlsh pod/perlipc.pod pod/perlop.pod
          pod/perlsub.pod pod/perlsyn.pod pod/perltrap.pod
          pod/perlvar.pod win32/bin/search.bat

  Title:  "Document and test C<%> behavior with negative operands"
   From:  Chip Salzenberg
  Files:  pod/perlop.pod t/op/arith.t

  Title:  "Update docs on $]"
   From:  Chip Salzenberg
  Files:  pod/perlvar.pod

  Title:  "perlvar.pod patch"
   From:  Gisle Aas
 Msg-ID:  <199703261254.NAA10237@bergen.sn.no>
   Date:  Wed, 26 Mar 1997 13:54:00 +0100
  Files:  pod/perlvar.pod

    (applied based on p5p patch as commit id 0aa182cb0caa3829032904b9754807b1b7418509)

  Title:  "Fix example of C<or> vs. C<||>"
   From:  Chip Salzenberg
  Files:  pod/perlsyn.pod

  Title:  "Pod usage and spelling patch"
   From:  Larry W. Virden
  Files:  pod/*.pod

  Title:  "Pod updates"
   From:  "Cary D. Renzema" <caryr@mxim.com>
 Msg-ID:  <199703262353.PAA01819@macs.mxim.com>
   Date:  Wed, 26 Mar 1997 15:53:22 -0800 (PST)
  Files:  pod/*.pod

    (applied based on p5p patch as commit id 5695b28edc67a3f45e8a0f25755d07afef3660ac)

Pod updates

Here are some fixes for the pod files.

p5p-msgid: <199703262353.PAA01819@macs.mxim.com>

perlvar.pod patch

p5p-msgid: 199703261254.NAA10237@bergen.sn.no

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

perlfunc.pod patch

This patch contains various minor corrections and improvements to the
perl5.003_95 perlfunc POD text:

p5p-msgid: 199703262159.WAA17531@furubotn.sn.no

Patch for perl.pod

(this is the same change as commit 69cddaa00596e831c0492189df41823d75a1b069, but as applied)

Patch for perl.pod

This didn't make it into 95.

p5p-msgid: 199703262305.PAA13121@ducks

Suggest to upgraders that they try '-w' again

Tom Christiansen wrote:

>>-w is removed from a lot of installed scripts, to
>>get rid of annoying warnings about legitimate code.
>
> Hm... I kinda think this is a bad idea. If there are too
> many warnings, something should be fixed.  Historically,
> -w has at time been too noisy, and we've fixed it.

Right.  Let's add a note somewhere (perlrun? perldelta? INSTALL?):

p5p-msgid: 199703251901.UAA15982@bombur2.uio.no

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Minor string change in toke.c: 'bareword'

The only place I found in all of perl 5.003095 that used the phrase
"Bare word" instead of "bareword" or "Bareword" was here:

p5p-msgid: 1997Mar27.130247.1911552@hmivax.humgen.upenn.edu

INSTALL-1.11

(this is the same change as commit a5d126c22eb526701c899be27a05a7d0d93dff97, but as applied)

INSTALL-1.11

On March 25, I wrote:

> I'll try to take various comments into account and eliminate unnecessary
> markup in INSTALL.  (I will, however, leave in what I consider to be
> necessary or useful markup.)

Here's a patch to bring you version 1.11 of the INSTALL file.  This patch
is relative to the version in 5.003_95.

By far the biggest part of the patch is removing unnecessary markup in the
file.  There actually wasn't all that much anyway, but most of it wasn't
necessary for clarity, so I just removed it.  There are now just 13 uses
of C<> and B<>.  (These too are debatable, but I have no interest in
debating them.  I've already decided to keep them for now.)

I've included Chip's suggestion about 'splain and diagnostics.pm and added
a little more info about the pod format.

There are also some minor rewordings here and there, all aiming to enhance
clarity.  I hope it didn't regress instead :-)

At this point, I don't see any reason to include a separate INSTALL.txt
version in the distribution.  If we want to

mv INSTALL INSTALL.pod

I won't argue much against it.

p5p-msgid: Pine.SOL.3.95q.970326140905.10178A-100000@fractal.lafayette.edu

Re: strict @F

According to Chip Salzenberg:

>        sprintf( tmpbuf1, "@F=split('%s');", splitstr );

Oh, that reminds me:  Splits like  perl -F"/"  and  perl -F",'"  fail.
Of course, these might be considered user errors since they conflict
with the -F doc.  However, the -F doc is incorrect anyway: It says that
the pattern will be quoted unless it is *surrounded* by the delimiter.
Perl uses quotes if it *starts* with the delimiter.  Which is sometimes
better because it allows options: -F/foo/i.

Anyway, here is a fix. 1st part allows things like `-F/' according to
the doc.  2nd part, if you want it, (attempts to) allow -F",'" in
conflict with the doc, which implies -F",'" is an error.

BTW, note that it's too late to obey the current doc exactly.
That would forbid options (-F/foo/i) or expressions (-F'"" + $i++').
Currently, these work - and might be in use somewhere.

p5p-msgid: 199703252110.WAA16038@bombur2.uio.no

Tiny doc fix for AutoSplit.pm

Seems that the C<.al> construct by itself causes pod2man to lose about half of
the line, which confuses the explanation of the argument in question:

p5p-msgid: rjray-9702272117.AA001223633@snakepit.ecte.uswc.uswest.com

Re: embedded perl and top_env problem

On Mon, 24 Mar 1997 17:29:29 EST, Ken Fox wrote:
>Gurusamy Sarathy wrote:
>> >> Ken Fox wrote:
>> >> > The trouble with die happens in the longjmp to top_env ...
>> Testcase?
>
>Here's a good example that demonstrates both of my longjmp related
>problems.  I'm using 5.003_94 on Solaris 2.5.1 (more info at
>bottom).  I think that the perl_call_* API is being used correctly.
>
>---------------------------------------- BEGIN crash.c
>#include <EXTERN.h>
>#include <perl.h>
>static PerlInterpreter *my_perl;
>
>int call_sub(SV *sub)
>{
>    int result = -1;
>    int count;
>    dSP;
>
>    ENTER;
>    SAVETMPS;
>
>    PUSHMARK(sp);
>    XPUSHs(sv_2mortal(newSViv(1)));
>    PUTBACK;
>    count = perl_call_sv(sub, G_SCALAR);
>    SPAGAIN;
>    if (count == 1) result = POPi;
>    PUTBACK;
>
>    FREETMPS;
>    LEAVE;
>    return result;
>}
>
>int main(int argc, char *argv[], char *envp[])
>{
>    char *perl_args[] = { 0, "-e",
>              "sub ok { $_[0] + 1; } sub crash { die 'crash\n'; }", 0 };
>    my_perl = perl_alloc();
>    perl_construct(my_perl);
>    perl_parse(my_perl, 0, 3, perl_args, 0);
>    perl_run(my_perl);
>
>    /* this call works fine -- no error */
>    printf("   sub ok: return = %d\n", call_sub((SV *)perl_get_cv("ok", FALSE)));
>    /* this call eventually inokes die() which mangles the C stack with long jump */
>    printf("sub crash: return = %d\n", call_sub((SV *)perl_get_cv("crash", FALSE)));
>    /* this call is bogus but perl mangles the C stack with long jump trying to
>       tell me about it. */
>    printf(" sv_undef: return = %d\n", call_sub(&sv_undef));
>    perl_destruct(my_perl);
>    perl_free(my_perl);
>    return 0;
>}
>---------------------------------------- END crash.c
>
>I don't expect either of these cases to trap the error and go on -- I'd
>have used G_EVAL to do that.  What I do expect is that the C stack isn't
>scrambled when the error occurs -- that makes it virtually impossible to
>catch in a debugger:

Here's a patch for the above problem, which is symptomatic of larger
problems with perl_call_*() calls that happen outside perl_run() or
perl_parse().  Perl invokes longjmp() without checking if an associated
setjmp() exists.  This is likely to cause coredumps galore for all the
perl embedfellows out there.

Note the size of this patch is mostly due to the conversion of the
DOCATCH() business to macros in order to give it a semblance of
order.  It also does away with redundant calls to setjmp() (the
:restart branch in perl_call_sv()), and uses the C stack instead of
Copy().

I finished this patch yesterday, and gave it a day with my production
embeded app, so I'm fairly sure it don't have no bugs. :-)

p5p-msgid: 199703280031.TAA05711@aatma.engin.umich.edu

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Re: 5.004's new srand() default seed

In the remote past, Roderick Schertler wrote:
> I posted a message to clpm asking for comments on Perl's new srand()
> default seed and Dean Inada replied.  Here are his observations.  I'm
> just a conduit, would somebody who knows what they're talking about
> please step in?

Sorry to be late:

I believe I'm the one who inserted the new code.  I browse clpm very
infrequently - and skip large parts of p5p too, for that matter.

I'll freely admit it's not particularly well tuned.  Since I don't know
much about randomness, anyone who do could do a better job, and I
suggested (on p5p) that someone might give it a try.  My change was just
to grab a few more garbage values (pointer addresses, time & pid) and
multipliers that shold at least never produce worse results than the
original code.

The multipliers
 - are prime numbers, just in case that makes a difference:-)
 - have few 1 bits at the beginning in binary, to distribute values
   varying in a small range "not worse than the old version did",
   or something like that.  I don't quite remember.

If you improve it, just remember:

 - *every* input value (time, pid & so on) may vary within a very narrow
   range and/or with a constant multiplier in some instances - or not
   vary at all.
 - cast things to a "large enough" unsigned and to avoid overflow
   exception and/or warning on some compilers.  And don't trust a
   variable/function to be unsigned just because some standard says
   that it should be.

>> Using ^ here seems pretty silly.  It again invites identical seeds
>> every 1000001 microseconds.  A much more natural seed would seem to be
>>
>>  tv_sec*1000000 + tv_usec
>>
>> Which at least will never repeat on different ticks.

Unless int is small, which gives faster wraparound.

>> But (...) some round tv_usec to multiples of 10000 microseconds,

Ah, yes.  That's why I didn't multiply tv_sec with anything.

Better fix:  Replace 1000000 above with some uneven larger number.

>> it would still be useful to mix in a getpid().

Which I did.

>>> seed ^= ( (  269 * (U32)getpid())
>>>         ^ (26107 * (U32)&when)
>>>         ^ (73819 * (U32)stack_sp));
>>
>> Since you're using primes here, why not use the addition operator from
>> the same field that the primes are in, which would generate a group
>> the size of the product of those primes for avoiding repetitions?

Fine.  Someone said xor, but not with any arguments that I can rember.

>> Are you still using rand(3), rather than the better random(3)?  If so,
>> there may be the additional issue that small changes in the seed tend
>> to produce small changes in the sequence.  In that case, something
>> like seed*32769 (i.e. seed + (seed<<15)) may help.  (though a prime
>> like 32771 might be better.)

INSTALL suggests -Drand=random -Dsrand=srandom if one wants larger
period.  Which means the period could be anything.  However,
#if RANDBITS > 32 ... #else #if RANDBITS > 16 ... #else ...
should allow us to tune this for the most common seed sizes.

Anyway, what should be used is a *real* hash function which spreads the
effect of every bit over a whole 1<<RANDBITS, so truncating to 32, 48 or
16 bits will all work.  Multiplication with primes is not good enough,
because changes in high bits do not affect low bits of the seed.
However, I can't do that without checking some book, I don't know what
code to avoid which could cause recurring patterns instead...

Anyway, here is a starting point - slightly improved from your version:

[included code block applied as patch - ed]

Oh, also note:

Some time ago, Chip Salzenberg wrote:
>According to Fabien TASSIN:
>>> warning(1412): destination type of cast is too small to
>>>           hold all pointers: truncation possible
>>>            ^ (26107 * (U32)&when)
>>>                       ^
>>
>> this one is interesting for all 64bit OSs..
>
> It's on purpose.  The value of "&when" is just a presumably large,
> difficult-to-predict value; converting it to U32 is the Right Thing,
> even on 64-bit machines.

Well,
(U32)(unsigned_with_same_size_as_pointers_t)&when
wouldn't hurt, if the latter type exists:-) And the same for
(U32)stack_sp, of course.

p5p-msgid: 199703302219.AAA20998@bombur2.uio.no

Patch for Benchmark.pm

(this is the same change as commit 3f1bea595935e4179e5648faacfa5b549f2d7e03, but as applied)

Patch for Benchmark.pm

This patch is a cleanup for the Benchmark module. It documents all the
stuff that wasn't, including my recent patch to allow code references;
it removes the old perl-comment docs that duplicate the POD; it fixes
some minor bugs (mostly of the '$arg ||= $default' instead of
'$arg = $default unless defined $arg' variety) and generally tidies
things up a bit.

Let me know if any of this causes problems,

p5p-msgid: 199703291504.PAA01596@crypt.compulink.co.uk
Signed-off-by: Hugo van der Sanden <hv@crypt.compulink.co.uk>

Typo in perl.c: Printing NO_EMBED for perl -V

p5p-msgid: 199703301922.VAA13509@furubotn.sn.no

C<new SelectSaver $fh> doesn't always restore

This is a bug report for perl from spider@Orb.Nashua.NH.US,

If you're lucky enough to get a signal (such as ALRM) which is handled
with die() while in a SelectSaver->new($fh) call, your previous output
filehandle is not restored.  It violates the basic rule of 'save and
restore' handling, in that it modifies the state it wants to restore
I<before> it has ensured that the prior state will be restored.  Patch:

p5p-msgid: 199703291906.OAA07232@Orb.Nashua.NH.US

safefree() mismatch

The declaration of safefree() in proto.h disagrees with the definition
in util.c.

p5p-msgid: 21338.859653381@eeyore.ibcinc.com

Re: $whoami calculation in Sys::Syslog.pm should not be greedy

On Fri, 28 Mar 1997 16:42:46 -0600 (CST), mer@world.evansville.net (Marc Rouleau) said:
>
> I suggest replacing
>
>     if (!$ident && $mask =~ /^(\S.*):\s?(.*)/) {
>
> with
>
>     if (!$ident && $mask =~ /^(\S.*?):\s?(.*)/) {
>
> at about line 157.  Otherwise, syslog'ing text containing a colon
> doesn't work right.

I think it's a reasonable tradeoff (it'll prevent "foo::bar: message"
from working but it'll allow "foo: can't do x: message").  The first
probably doesn't work properly with most syslogds anyway, one here would
log it as

    foo:<17.6>:bar[21244]: message

p5p-msgid: pz4tdu7j57.fsf@eeyore.ibcinc.com

Re: Pod problems & fixes

> Couldn't we please just make it program options?

Right.  Well, here is a simple version.  The output of
perl -d -MPod::Text -e 'pod2text(@ARGV)' -- -a -72 INSTALL
follows, then the Text.pm patch.  What say?

Needs a few details - like L<> output, but that can wait until the
relevant people say yes/no.

    =head1 foo  ->  ==== foo ====
    =head2 foo  ->  ==   foo   ==
    =item  foo  ->  :    foo             (i.e. s/^  /: /, so a search
                                          for /^:/ finds next =item)

    B<foo>      ->     ``foo''           (was unquoted)
    C<foo>      ->     ``foo''           (was `foo')
    F<foo>      ->      "foo"            (was unquoted)
    I<foo>      ->      *foo*
    L<foo>      -> the section on "foo"  (details here must be fixed.
  Later.)

The =items look a little strange, but OK.  Anyone got a better
suggestion?  But remember:

> From: Andy Dougherty <doughera@fractal.phys.lafayette.edu>
>
> Mostly, they can just use /^=/ in their favorite pager and find their way
> around the file.  If we remove the =head and =item markers, this sense of
> where you are in the whole file gets lost.  So I'm not going to do that.

BTW, is it a point to have just one string to search for?  If so, s/^:/=/.

Indentation: Have not checked exactly, but apparently =head* sets indent
to 4, =item adds 4.  Some verbatim paragraphs get too indented.  One fix
might be *not* to indent things under =head* that are not =items,
another would be to edit INSTALL a bit.

Also did

    s/B<(Note:?|before|not)>/I<$1>/gi; # correct, I think

    s/B<(ARCH|VERSION)>/$1/g; # looked a bit silly in ``quotes'',
# and after all they are already
# in uppercase.

p5p-msgid: 199703261829.TAA17015@bombur2.uio.no

Fix C<print $_> in debugger

private-msgid: 199703312355.SAA01068@monk.mps.ohio-state.edu

Allow for coexistence of various versions of perldiag.pod

Eliminate unused dummy variable

private-msgid: 199703270123.UAA25454@postman.osf.org

hints/freebsd.sh update (don't use -lmalloc)

Here's an update for hints/freebsd.sh. Configure should not try to use
-lmalloc, since it's very likely an old malloc from the compatibility
package compat1.x.

p5p-msgid: 199703311417.QAA04162@cabulja.herceg.de

Die on patterns that will match empty string forever

Subject: Re: Segementation fault in perl5.001 and 5.003

Strange sunspot activity caused =?iso-8859-1?Q?Markus_Thei=DFinger?= <Markus.Th
eissinger@gmd.de> to write:
| Hi,
|
| perl -e '$_=3D" 2"; print STDOUT /^(\s*(\))*)+$/;'
|
| produces a segmentation fault [snips]

Confirmed on 3_95.  I'm surprised this kind of thing lasted this long.
Actually, I could have sworn someone fixed this awhile back.  I suppose one
of the regulars could probably provide a better patch.

Works fine on 4.036, this patch returns it to 4.036 functionality.

p5p-msgid: 199703282138.PAA28311@psa.pencom.com

[differences between cumulative patch application and perl-5.003_95]

[inseparable changes from match from perl-5.003_94 to perl-5.003_95]

 CORE LANGUAGE CHANGES

Subject: Don't compile scalar mods of aggregates, like C<@a =~ s/a/b/>
From: Chip Salzenberg <chip@perl.com>
Files: op.c t/op/misc.t

Subject: Warn about undef magic values just like non-magic
From: Chip Salzenberg <chip@perl.com>
Files: ext/Opcode/Safe.pm sv.c t/lib/db-btree.t t/lib/db-hash.t t/lib/db-recno.t t/pragma/locale.t

 CORE PORTABILITY

Subject: Win32 update (five patches)
From: Gurusamy Sarathy <gsar@engin.umich.edu>
Files: MANIFEST README.win32 doio.c dosish.h pp_sys.c lib/ExtUtils/Command.pm t/comp/multiline.t t/op/magic.t t/op/mkdir.t t/op/runlevel.t t/op/stat.t t/op/write.t win32/Makefile win32/config.H win32/config.w32 win32/win32.c win32/win32.h win32/win32aux.c win32/*.mak win32/VC-2.0/*.mak

 DOCUMENTATION

Subject: INSTALL-1.8 to INSTALL-1.9 updates
Date: Tue, 25 Mar 1997 13:52:53 -0500 (EST)
From: Andy Dougherty <doughera@fractal.phys.lafayette.edu>
Files: INSTALL
Msg-ID: Pine.SOL.3.95q.970325135138.3374A-100000@fractal.lafayette.e

    (applied based on p5p patch as commit 9b1ae96a0b4301a9588f62b3175bc0312302f4b9)

Subject: Document possible problems with -Mdiagnostics after upgrade
From: Chip Salzenberg <chip@perl.com>
Files: INSTALL

Subject: Mention perldelta in INSTALL
From: Chip Salzenberg <chip@perl.com>
Files: INSTALL

Subject: Describe pod format at top of INSTALL
From: Chip Salzenberg <chip@perl.com>
Files: INSTALL

Subject: Document C</a *b/x> fix
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod

Subject: pods for subroutine argument autovivication
Date: Mon, 24 Mar 1997 07:25:21 +0000
From: "M.J.T. Guy" <mjtg@cus.cam.ac.uk>
Files: pod/perldelta.pod pod/perlsub.pod
Msg-ID: E0w9489-0005YT-00@ursa.cus.cam.ac.uk

    (applied based on p5p patch as commit db8878faa51a8a1541a40745a8613adb5db155e4)

Subject: Missing item in perldiag
Date: Sun, 23 Mar 1997 09:24:09 +0000
From: "M.J.T. Guy" <mjtg@cus.cam.ac.uk>
Files: pod/perldiag.pod
Msg-ID: E0w8jVZ-0005va-00@ursa.cus.cam.ac.uk

    (applied based on p5p patch as commit c00a529017138505fcbe538b74c7884abe1d18e1)

Subject: Pod problems & fixes
Date: Mon, 24 Mar 1997 21:31:51 +0100 (MET)
From: Hallvard B Furuseth <h.b.furuseth@usit.uio.no>
Files: INSTALL lib/Term/Complete.pm lib/subs.pm pod/perlcall.pod pod/perldata.pod pod/perldiag.pod pod/perlembed.pod pod/perlguts.pod pod/perlmod.pod pod/perlop.pod pod/perlpod.pod pod/pod2html.PL
Msg-ID: 199703242031.VAA14997@bombur2.uio.no

    (applied based on p5p patch as commit 55a864fe4cea1a0586891b83d359ba71e0972da5)

Subject: FAQ update
From: Nathan Torkington <gnat@prometheus.frii.com>
Files: pod/perlfaq*.pod

 OTHER CORE CHANGES

Subject: Improve 'prototype mismatch' warning
From: Chip Salzenberg <chip@perl.com>
Files: global.sym op.c pod/perldiag.pod proto.h sv.c t/comp/redef.t

Pod problems & fixes

Files: pod/perldiag.pod
Subject: pod2text expands B<-i>C<.bak> to -i`.bak'.  With a quote in
         the middle, it looks like it should be typed in verbatim.
         `-i.bak' is better.

Files: pod/pod2html.PL
Subject: "mailto:" is case-sensitive in URLs.

Files: lib/Term/Complete.pm lib/subs.pm pod/perlop.pod pod/perlembed.pod
       pod/perlguts.pod
Subject: Missing empty lines

Files: INSTALL pod/perlguts.pod
Subject: change `the section on L<..>' to `L<..>', because pod2*
         inserts the "the section on".

Files: pod/perlmod.pod pod/perlcall.pod
Subject: "perl5.00X" -> "perl5.00X or higher"

Files: pod/perldata.pod pod/perldiag.pod pod/perlpod.pod
Subject: "blank line" -> "empty line" where spaces are not ignored

DB_File documentation fix

  Title:  "Regularize headings in DB_File documentation"
   From:  Chip Salzenberg
  Files:  ext/DB_File/DB_File.pm
  [see commit 68dc074516a6859e3424b48d1647bcb08b1a1a7d]

You forgot to fix the links to the sections titles you changed.

p5p-msgid: 9703240854.AA08401@claudius.bfsec.bt.co.uk

Missing item in perldiag

An omission from perldiag:

p5p-msgid: E0w8jVZ-0005va-00@ursa.cus.cam.ac.uk

Mention and discourage use of term 'soft reference'

pods for subroutine argument autovivication

Here are pod updates for subroutine argument autovivication.
I'll also try to do some additions to the tests.

One small detail noted:

       perl -we 'sub f { print @_ }; f $a[0]'

produces

       Use of uninitialized value at -e line 1.

under Perl 5.003 but is silent under Perl5.003_94.    Do we care?

p5p-msgid: E0w9489-0005YT-00@ursa.cus.cam.ac.uk

Improve pod2man diagnostic when NAME is invalid

INSTALL-1.8 to INSTALL-1.9 updates

A few more updates to INSTALL, inspired by a note here about -DDEBUGGING
and by a few recent posts to comp.lang.perl.misc about problems Solaris
folks were having with nm extraction.

p5p-msgid: Pine.SOL.3.95q.970325135138.3374A-100000@fractal.lafayette.edu
private-msgid: Pine.SOL.3.95q.970325135138.3374A-100000@fractal.lafayette.e

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Reduce memory footprint of complex.t

(this is the same change as commit d26eb0becc8c51ffd352f1667ada71b0e03e9b19, but as applied)

Reduce memory footprint of complex.t

Over the weekend, I said:
>Passes all expected tests on MachTen 4.0.3, EXCEPT...
>
>lib/complex fails to run because it wants more virtual memory than my
>system can provide.  My system can provide 22 megs, which is not vast, but
>should be adequate to run a test, so I think lib/complex is being greedy.
>I'm pretty sure that the cause is repeated use of .= or similar on a
>scalar: the system malloc() which perl has to use on MachTen does not
>appear to coalesce free()d chunks, so behaves very badly when a scalar
>grows repeatedly.  Anyway, I'll delve deeper and probably post a patch.

Here's that patch.  It saves 2,861 (give or take) of those realloc()s my
system's native malloc() package fields so badly.  Beware long lines.  Hope
they reach you unmangled.  (If not, ask me to send it uuencoded, or as a
MIME attachment or something.)  You'll also need to hand patch a
--ignore-whitespace option: tabs will have been munged into spaces.

p5p-msgid: v03020902af5d8e03c5ab@[194.51.248.84]

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Term::Readline patch for AmigaOS

(this is the same change as commit c6f23515cbc613899d8b79910cc2429dea847fde, but as applied)

Term::Readline patch for AmigaOS

I stumbled upon this when trying to get CPAN working.

p5p-msgid: 77724797@Armageddon.meb.uni-bonn.de

Exporting UNIVERSAL::can

UNIVERSAL allows the export of 'isa' but not 'can'.    Since it
is useful to be able to apply 'can' to non-references (to avoid having
to do redundant tests), I offer the following tiny patch.

This also updates the pod to make it slightly clearer that both
functions can be applied to arbitrary values, not just references.

p5p-msgid: E0w9DwX-0000Zr-00@taurus.cus.cam.ac.uk

Extraneous blank lines from Pod::Text

I get the impression that eventually all of the Pod stuff currently
distributed with Perl is going to be phased out in favor of something new,
but in the meantime pod2text has always generated an extra blank line
after literal text (indented text).  The following patch to Pod::Text
appears to fix that, although I may be missing something since I don't
understand why the removed line was ever there to begin with.

p5p-msgid: qumend4qq08.fsf@cyclone.stanford.edu

Fix C<require> in Getopt::Long to work with 5.003

In perlio, fix vprintf() definition and define vfprintf()

Fix botch with G_NOARGS; PUSHMARK *is* required

Another MachTen Patch

private-msgid: Pine.GSO.3.96.970324152150.20610P-100000@kelly.teleport.com

Remove redundant patch to hints/bsdos.sh

Subject: hints/bsdos.sh wrong in _94 (Re: Perl 5.003_94 is available)

>> So use his patch instead of mine.

Seems to be wrong. Please apply following patch against _94

p5p-msgid: 19970322222244K.shigeya@foretune.co.jp

If C<perl -a>, do equivalent of C<use vars '@F'>

Refine modulus ("%") per suggestion of Tim Goodwin

Automatically flush on C< $| = 1 >

[differences between cumulative patch application and perl-5.003_94]

[inseparable changes from match from perl-5.003_93 to perl-5.003_94]

 BUILD PROCESS

Subject: Don't use db 2.x, we're not yet ready for it
From: Paul Marquess <pmarquess@bfsec.bt.co.uk>
Files: Configure

Subject: Warn if #! command is longer than 32 chars
From: Chip Salzenberg <chip@perl.com>
Files: Configure

Subject: patches re perl -wc install{perl,man}
Date: Tue, 11 Mar 97 13:13:16 GMT
From: Robin Barker <rmb1@cise.npl.co.uk>
Files: installman installperl

    I got the new installhtml from CPAN
    (TOMC/scripts/pod2html-v2.0beta.shar.gz)

    I had problems getting the system call to splitpod at line 376 to work.

    1. splitroot was not being found
    2. splitroot was not finding its library
    3. I changed htmlroot to podroot at line 175 to match the documentation.

    p5p-msgid: 3180.9703270906@tempest.cise.npl.co.uk
    private-msgid: 21544.9703111313@tempest.cise.npl.co.uk

Subject: 3_93 doesn't install pods
Date: Sun, 16 Mar 1997 02:21:35 -0500
From: Spider Boardman <spider@orb.nashua.nh.us>
Files: installperl
Msg-ID: 199703160721.CAA08339@Orb.Nashua.NH.US

    (applied based on p5p patch as commit 43506a616735d616e03d277d64fbae1e864024bf)

Subject: When installing, use File::Copy instead of `cp`
From: Chip Salzenberg <chip@perl.com>
Files: installperl

Subject: Make hint files' warnings more visible
Date: Thu, 20 Mar 1997 23:18:03 +0100 (MET)
From: Hallvard B Furuseth <h.b.furuseth@usit.uio.no>
Files: hints/3b1.sh hints/apollo.sh hints/cxux.sh hints/dcosx.sh hints/dgux.sh hints/esix4.sh hints/freebsd.sh hints/hpux.sh hints/irix_4.sh hints/mips.sh hints/next_3_0.sh hints/os2.sh hints/qnx.sh hints/sco_2_3_3.sh hints/sco_2_3_4.sh hints/solaris_2.sh hints/ultrix_4.sh hints/utekv.sh

    private-msgid: 199703202218.XAA09041@bombur2.uio.no

 CORE LANGUAGE CHANGES

Subject: Defer creation of array and hash elements as parameters
From: Chip Salzenberg <chip@perl.com>
Files: dump.c global.sym mg.c op.c op.h perl.h pp.c pp_hot.c proto.h sv.c

Subject: New special literal: __PACKAGE__
From: Chip Salzenberg <chip@perl.com>
Files: keywords.pl pod/perldata.pod toke.c

Subject: Abort compilation at C<BEGIN{}> or C<use> after errors
From: Chip Salzenberg <chip@perl.com>
Files: op.c pod/perldiag.pod t/pragma/subs.t

Subject: allow C<substr 'hello', -10>
Date: Mon, 10 Mar 1997 15:55:44 -0800
From: David Dyck <dcd@tc.fluke.com>
Files: pp.c
Msg-ID: 97Mar10.155517pst.35716-2@gateway.fluke.com

    (applied based on p5p patch as commit 77f720bf92f3d0100352416caeedd57936807ff2)

Subject: Regularize C<x % y>, esp. when y is negative
From: Chip Salzenberg <chip@perl.com>
Files: pp.c

Subject: Flush before C<flock(FOO, LOCK_UN)>
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod pod/perlfunc.pod pp_sys.c

Subject: Close loopholes in prototype mismatch warning
From: Chip Salzenberg <chip@perl.com>
Files: op.c sv.c toke.c

Subject: Warn on C<while ($x = each %y) {}>
From: Chip Salzenberg <chip@perl.com>
Files: op.c pod/perldiag.pod

Subject: Don't warn on C<print $fh func()>
From: Chip Salzenberg <chip@perl.com>
Files: toke.c

 CORE PORTABILITY

Subject: Don't say 'static var = 1'
Date: Sun, 9 Mar 1997 15:19:57 +0200 (EET)
From: Jarkko Hietaniemi <jhi@iki.fi>
Files: malloc.c

    private-msgid: 199703091319.PAA24714@alpha.hut.fi

Subject: HP/UX hint comments
Date: Fri, 21 Mar 1997 15:43:07 -0500 (EST)
From: Andy Dougherty <doughera@fractal.phys.lafayette.edu>
Files: hints/hpux.sh

    private-msgid: Pine.SOL.3.95q.970321153918.28770B-100000@fractal.lafayette.

Subject: VMS update
Date: Tue, 11 Mar 1997 22:00:55 -0500 (EST)
From: Charles Bailey <bailey@hmivax.humgen.upenn.edu>
Files: lib/ExtUtils/MM_VMS.pm lib/Test/Harness.pm t/op/taint.t utils/perlbug.PL vms/descrip.mms
Msg-ID: 1997Mar11.220056.1873182@hmivax.humgen.upenn.edu

    (applied based on p5p patch as commit 2b5725676da60b49978f38b85bb7f8ee20b4cb55)

Subject: vmsish.t and related patches
Date: Fri, 21 Mar 1997 01:32:47 -0500 (EST)
From: Charles Bailey <bailey@HMIVAX.HUMGEN.UPENN.EDU>
Files: MANIFEST perl.h vms/descrip.mms vms/ext/vmsish.t vms/vms.c

    private-msgid: 01IGQW3IP1KK005VFB@hmivax.humgen.upenn.edu

Subject: Win32 update (four patches)
From: Gurusamy Sarathy <gsar@engin.umich.edu>
Files: MANIFEST README.win32 lib/AutoSplit.pm lib/Cwd.pm lib/ExtUtils/Command.pm lib/ExtUtils/Install.pm lib/ExtUtils/MM_OS2.pm lib/ExtUtils/MM_Unix.pm lib/ExtUtils/MM_Win32.pm lib/ExtUtils/MakeMaker.pm lib/ExtUtils/Mksymlists.pm lib/File/Basename.pm lib/File/Path.pm mg.c t/comp/cpp.t t/comp/script.t t/harness t/io/argv.t t/io/dup.t t/io/fs.t t/io/inplace.t t/lib/filehand.t t/lib/io_dup.t t/lib/io_sel.t t/lib/io_taint.t t/op/closure.t t/op/exec.t t/op/glob.t t/op/goto.t t/op/magic.t t/op/misc.t t/op/rand.t t/op/split.t t/op/stat.t t/op/sysio.t t/op/taint.t t/pragma/strict.t t/pragma/subs.t t/pragma/warning.t util.c win32/*

 DOCUMENTATION

Subject: perlfaq.pod
Date: Mon, 17 Mar 1997 16:01:40 -0700
From: Tom Christiansen <tchrist@jhereg.perl.com>
Files: MANIFEST pod/Makefile pod/buildtoc pod/perl.pod pod/perlfaq*.pod pod/roffitall

    private-msgid: 199703172301.QAA12566@jhereg.perl.com

Subject: *.pod changes based on the FAQ
Date: Mon, 17 Mar 1997 09:50:14 -0700 (MST)
From: Nat Torkington <gnat@frii.com>
Files: pod/perldata.pod pod/perlfunc.pod pod/perlipc.pod pod/perlop.pod pod/perlre.pod pod/perlrun.pod pod/perlsec.pod pod/perlvar.pod
Msg-ID: 199703171650.JAA02655@elara.frii.com

    (applied based on p5p patch as commit 3c10ad8e31f7d77e71c048b1746912f41cb540f0)

Subject: Document that $. is not reset on implicit open
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod

Subject: Re: Embedding success with _93
Date: Tue, 11 Mar 1997 17:55:05 -0500
From: Doug MacEachern <dougm@opengroup.org>
Files: pod/perldelta.pod
Msg-ID: 199703112255.RAA22775@postman.osf.org

    (applied based on p5p patch as commit 63a6ff3a1dc8d86edb4d8a7ec1548205e32a7114)

Subject: Patch to document illegal characters
Date: Fri, 14 Mar 1997 09:08:10 -0800 (PST)
From: Tom Phoenix <rootbeer@teleport.com>
Files: pod/perldiag.pod pod/perltrap.pod

    private-msgid: Pine.GSO.3.96.970314090558.15346J-100000@kelly.teleport.com

Subject: Document trap with //o and closures
Date: Mon, 10 Mar 1997 18:08:08 -0500 (EST)
From: Charles Bailey <bailey@HMIVAX.HUMGEN.UPENN.EDU>
Files: pod/perltrap.pod
Msg-ID: 01IGCHWRNSEU00661G@hmivax.humgen.upenn.edu

    (applied based on p5p patch as commit a54cb1465fdb400848f23705a6f130bb5c34ab70)

Subject: Illegal character in input
Date: Mon, 10 Mar 1997 15:21:21 -0800 (PST)
From: Tom Phoenix <rootbeer@teleport.com>
Files: pod/perldiag.pod

    private-msgid: Pine.GSO.3.95q.970310151512.22489a-100000@kelly.teleport.com

Subject: Patch for docs Re: Lost backslash
Date: Wed, 19 Mar 1997 07:28:57 -0800 (PST)
From: Tom Phoenix <rootbeer@teleport.com>
Files: pod/perlop.pod

    private-msgid: Pine.GSO.3.96.970319071438.24834G-100000@kelly.teleport.com

Subject: XSUB's doc fix
Date: Mon, 10 Mar 1997 11:42:06 -0500
From: Roderick Schertler <roderick@argon.org>
Files: pod/perlcall.pod pod/perlguts.pod pod/perlxstut.pod
Msg-ID: 28804.858012126@eeyore.ibcinc.com

    (applied based on p5p patch as commit 5f43237038ea7a4151d3bf65aeeecd56ceb78a6a)

Subject: Document return from do FILE
Date: Tue, 18 Mar 1997 14:50:10 +0000
From: "M.J.T. Guy" <mjtg@cus.cam.ac.uk>
Files: pod/perlfunc.pod
Msg-ID: E0w70DK-0001yJ-00@ursa.cus.cam.ac.uk

    (applied based on p5p patch as commit ba8d5fb439878113de8abc9b52d2af237d30fb3c)

Subject: Document $^M in perlvar
Date: Thu, 20 Mar 97 21:08:33 GMT
From: Robin Barker <rmb1@cise.npl.co.uk>
Files: pod/perlvar.pod

    private-msgid: 6153.9703202108@tempest.cise.npl.co.uk

Subject: typos in pods of 5.003_93
Date: 19 Mar 1997 10:39:38 -0600
From: Jim Meyering <meyering@asic.sc.ti.com>
Files: pod/perlfunc.pod pod/perlguts.pod pod/perlre.pod pod/perltoot.pod pod/perlxs.pod
Msg-ID: wpgendbzvhx.fsf@asic.sc.ti.com

    (applied based on p5p patch as commit 76a9873e006cf8f48f57062b2a0dd40b5ed45a95)

Subject: Re: Updates to pod punctuations
Date: Fri, 14 Mar 1997 17:00:12 -0500
From: Larry W. Virden <lvirden@cas.org>
Files: pod/*.pod

    private-msgid: 9703141700.AA22911@cas.org

Subject: clarify example in perlfunc
Date: Thu, 20 Mar 1997 19:46:01 +0200 (EET)
From: Jarkko Hietaniemi <jhi@iki.fi>
Files: pod/perlfunc.pod

    private-msgid: 199703201746.TAA25195@alpha.hut.fi

Subject: Regularize headings in DB_File documentation
From: Chip Salzenberg <chip@perl.com>
Files: ext/DB_File/DB_File.pm

 LIBRARY AND EXTENSIONS

Subject: New module: autouse.pm
Date: Thu, 20 Mar 1997 19:34:30 -0500 (EST)
From: Ilya Zakharevich <ilya@math.ohio-state.edu>
Files: MANIFEST lib/autouse.pm
Msg-ID: 199703210034.TAA13469@monk.mps.ohio-state.edu

    (applied based on p5p patch as commit 6757905eccb6dd0440ef65e8128a277a20f7d943)

Subject: Refresh DB_File to 1.12
Date: Wed, 12 Mar 97 15:51:14 GMT
From: Paul Marquess <pmarquess@bfsec.bt.co.uk>
Files: ext/DB_File/DB_File.pm ext/DB_File/DB_File.xs
Msg-ID: 9703121551.AA07435@claudius.bfsec.bt.co.uk

    (applied based on p5p patch as commit b3deed9189f963e9994815307931f9084f60d1d9)

Subject: In File::Path, some systems can't remove read-only files
From: Chip Salzenberg <chip@perl.com>
Files: lib/File/Path.pm

Subject: Fix bugs revealed by prototype warnings
From: Chip Salzenberg <chip@perl.com>
Files: ext/Opcode/Opcode.pm lib/ExtUtils/MakeMaker.pm lib/Getopt/Long.pm

Subject: Problems with SKIP in makemaker
Date: Thu, 20 Mar 1997 23:13:31 -0500 (EST)
From: Ilya Zakharevich <ilya@math.ohio-state.edu>
Files: lib/ExtUtils/MM_Unix.pm
Msg-ID: 199703210413.XAA21601@monk.mps.ohio-state.edu

    (applied based on p5p patch as commit 970322a2e8024294ada6e8d1a027cb98f1f48ee3)

Subject: In Exporter, don't C<require Carp> at file scope
From: Chip Salzenberg <chip@perl.com>
Files: lib/Exporter.pm

Subject: fix for Exporter's $SIG{__WARN__} handler
Date: Thu, 13 Mar 1997 18:40:51 -0500
From: Roderick Schertler <roderick@argon.org>
Files: lib/Exporter.pm
Msg-ID: 2282.858296451@eeyore.ibcinc.com

    (applied based on p5p patch as commit 2768ea1aeef34f42d096f198fbe629c8374ca429)

Subject: Don't try to substr() refs in Carp
From: Chip Salzenberg <chip@perl.com>
Files: lib/Carp.pm

Subject: Re: NUL in die and other messages
Date: Fri, 21 Mar 1997 09:58:17 +0000
From: "M.J.T. Guy" <mjtg@cus.cam.ac.uk>
Files: lib/Carp.pm
Msg-ID: E0w815V-0005xs-00@ursa.cus.cam.ac.uk

    (applied based on p5p patch as commit 52a267c574cb66c4bc35601dcf148a1d7a3bc557)

 OTHER CORE CHANGES

Subject: Guard against buffer overflow in yyerror() and related funcs
From: Chip Salzenberg <chip@perl.com>
Files: toke.c

Subject: For bin compat, rename calllist() and he_{,delay}free
From: Chip Salzenberg <chip@perl.com>
Files: global.sym hv.c op.c perl.c pod/perlguts.pod proto.h

Subject: Fix C<print> on tied default handle
From: Chip Salzenberg <chip@perl.com>
Files: pp_hot.c

Subject: Fix C<local($a, undef, $b) = (1,2,3)>
From: Chip Salzenberg <chip@perl.com>
Files: op.c

Subject: Improve diagnostic on C<@a++>, C<--%a>, @a =~ s/a/b/
From: Chip Salzenberg <chip@perl.com>
Files: pp.c pp_hot.c

Subject: Don't warn on C<$x{y} .= "z"> when %x is tied
From: Chip Salzenberg <chip@perl.com>
Files: pp_hot.c

Subject: Eliminate 'unreachable code' warnings
From: Chip Salzenberg <chip@perl.com>
Files: ext/POSIX/POSIX.xs mg.c pp_ctl.c toke.c

Subject: printf format corrections for -DDEBUGGING
Date: Wed, 19 Mar 1997 12:42:50 -0500
From: Roderick Schertler <roderick@argon.org>
Files: doop.c malloc.c op.c pp_ctl.c regexec.c sv.c x2p/str.c x2p/util.c
Msg-ID: 26592.858793370@eeyore.ibcinc.com

    (applied based on p5p patch as commit e125f273e351a19a92b69d6244af55abbbf0a26d)

Subject: Warn about missing -DMULTIPLICITY if likely a problem
Date: Wed, 19 Mar 1997 18:45:53 -0500
From: Doug MacEachern <dougm@opengroup.org>
Files: perl.c
Msg-ID: 199703192345.SAA15070@postman.osf.org

    (applied based on p5p patch as commit 71aeea1753924e6e19c2461e241e3f7d8a570e90)

typos in pods of 5.003_93

This patch fixes one misspelling and several doubled words.

p5p-msgid: wpgendbzvhx.fsf@asic.sc.ti.com

Re: Inline PI function

private-msgid: Pine.GSO.3.95q.970310143125.22489V-100000@kelly.teleport.com

Document return from do FILE

I observe by experiment that you can use 'return' to exit from a 'do',
but this fact is not documented.

p5p-msgid: E0w70DK-0001yJ-00@ursa.cus.cam.ac.uk

Update site list

private-msgid: 9703111053.AA20051@cas.org
Signed-off-by: x2487 <lvirden@cas.org>

XSUB's doc fix

p5p-msgid: 28804.858012126@eeyore.ibcinc.com

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Document trap with //o and closures

Subject: Re: Possible bug: /o overeager in closure constructor

Chip Salzenberg <chip@atlantic.net> wrote:
|
| According to Charles Bailey:
| > OK, so eval "" is the current workaround (but not eval '', if some of
| > the lexicals come from a block scope :-)).  Should this be documented?
|
| IMO, it deserves an entry in perltrap.

How 'bout something like

=item * Regular Expression

Currently, if you use the /o qualifier on a regular expression within
an anonymous subroutine, I<all> closures generated from that anonymous
sub constructor will use the regular expression compiled the very
first time the constructor was called.  For instance, if you say

    sub build_match {
       my($left,$right) = @_;
       return sub { $_[0] =~ /$left stuff $right/o; };
    }

build_match will always return a sub which matches the contents of
C<$left> and <$right> from the first time it was called, not from
the current call.  This is probably a bug, and may change in future
versions of Perl.

It's a bit long, but I can't think of a more concise explanation
that's not confusing.

BTW, should we have a perlbugs.pod or somesuch as a home for things
like this, which aren't so much stable changes in the language as
problems we haven't been able to sort out yet?

p5p-msgid: 01IGCHWRNSEU00661G@hmivax.humgen.upenn.edu

INSTALL:  How to enable debugging

(this is the same change as commit bbf3737a130f2476a9fbd9397c661175a0027d33, but as applied)

INSTALL:  How to enable debugging

On Fri, 21 Mar 1997, Tom Christiansen wrote:

> BTW, why isn't there a makefile option to do this?  I looked in
> INSTALL, but really saw no obvious way to 'make me a perl with cc -g
> style debugging'.  There should be, or if there is, there should be
> clearer directions.

It's all spelled out for you when you run Configure interactively, of
course, but you already knew that :-)

p5p-msgid: Pine.SOL.3.95q.970321112326.1414A-100000@fractal.lafayette.edu
private-msgid: Pine.SOL.3.95q.970321112326.1414A-100000@fractal.lafayette.e

Re: Embedding success with _93

Chip Salzenberg <chip@atlantic.net> wrote:

> According to Doug MacEachern:
> > The obscure, untraceable failing of test 18 has gone away, my bet is
> > this from Changes: "Fix imbalanced ENTER/LEAVE from C<BEGIN{die}>".
> > fantastic, excellent work Chip!!!
>
> Thank you, but although I coded that patch, I wouldn't have known
> where to start if Sarathy hadn't given me a map and directions.

well then, thanks Sarathy!  But, I wasn't just saying thanks for that
fix, rather, _all_ the work you have done Chip, esp. _all_ the embedding
fixes.  I think perldelta should mention this somehow:

p5p-msgid: 199703112255.RAA22775@postman.osf.org

Re: bug in pod2man (5.00326): section=3 for .pm modules

On Tue, 11 Mar 1997 21:25:10 +0100 (MET), Slaven Rezic <eserte@cs.tu-berlin.de> said:
>
> pod2man does not recognize the proper section for .pm modules. You
> have to delete the "$section = $opt_section || $DEF_SECTION;" in line
> 378 in .../pod/pod2man.PL, since it overrides the proper setting in
> line 362.

Good catch.  Here's that fix plus code to use the man3 extension
specified to Configure (I use 3pm myself).

p5p-msgid: pzn2sat1hg.fsf@eeyore.ibcinc.com

*.pod changes based on the FAQ

After the faqqing dust has settled, it looks like a couple of the
things in the FAQ aren't mentioned in the pods and should be.  I came
up with a list of possible changes, and have implemented all but:
 - Need a discussion of optimising for speed/size, including compiling,
   autosplitting, etc.
 - The buffering discussion from part5 belongs somewhere.
 - The explanation of C<..> in perlop is confusing.  Then again, C<..> is
   confusing.

p5p-msgid: 199703171650.JAA02655@elara.frii.com

Fix typos in IO::Socket documentation

At line 156, IO::Socket::configure reads

    croak "IO::Socket: Cannot configure socket in domain '$domain'"
        unless ref($fh) eq "IO::Socket";

Doesn't this mean that IO::Socket fails the 'empty subclass' test?
Should the condition be replaced with 'isa' or something?

And the following patch mends a few minor typos in the pod.

p5p-msgid: E0w75po-0003yh-00@taurus.cus.cam.ac.uk

Re: NUL in die and other messages

There has been no response to this on p5p, Chip hasn't included it
in his "More seeds of _94" and I can't find it on the archive.
So I suppose it got lost.

I note that the patch needs to be merged with a more recently posted
one handling references.

p5p-msgid: E0w815V-0005xs-00@ursa.cus.cam.ac.uk

Add entry for prototype() in Pod::Functions

fix for Exporter's $SIG{__WARN__} handler

Exporter's $SIG{__WARN__} handler is too zealous.  It fails here:

    $ cat t
    require Carp;
    package Foo;
@ISA = qw(Exporter);
@EXPORT_OK = @EXPORT_FAIL = qw(foo);
sub export_fail {
    my $self = shift;
    Carp::carp("carp from export_fail");
    return ();
}
    package main;
import Foo 'foo';
    $ perl5.00393 t
    carp from export_fail at t line 16
     at t line 16

This is because the carp() inside export_fail triggers Exporter's
__WARN__ handler which calls carp() a second time which adds the second
" at t line 16".

I was surprised to learn that carp() adds its string to an error message
which ends with a newline, I thought it followed warn()'s lead on that.
I checked 5.003 and it was the same there, too, though.

Also, shouldn't Exporter's __WARN__ handler increment $Carp::CarpLevel
rather than setting it to 1?  I didn't include that in the patch because
I'm not sure, but it seems the right thing to do to me.

p5p-msgid: 2282.858296451@eeyore.ibcinc.com

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

Problems with SKIP in makemaker

The example in perlxstut (which I created with a lot of pain) works by
coincidence only:

It has

WriteMakefile(
    NAME      => 'Mytest2::mylib',
    SKIP      => [qw(all static static_lib dynamic dynamic_lib)],
    clean     => {'FILES' => 'libmylib$(LIB_EXT)'},
);

sub MY::top_targets {
'
all :: static

static ::       libmylib$(LIB_EXT)

libmylib$(LIB_EXT): $(O_FILES)
$(AR) cr libmylib$(LIB_EXT) $(O_FILES)
$(RANLIB) libmylib$(LIB_EXT)

';
}

and work only because $self->MM::top_targets is not called. The reason is
that 'all' chunk is written anyway not depending on the value of SKIPHASH.

In my eText package I do $self->MM::top_targets inside
MY::top_targets, and this bombs.

Patch follows (only for 'all', I did not check any other target):

(The alternative is to patch perlxstut, but this may break some other
programs, not only mine...)

Enjoy,

p5p-msgid: 199703210413.XAA21601@monk.mps.ohio-state.edu

Fix typo in -l*perl* pattern

(this is the same change as commit ddab96b77391e288333a995edd0cbe8bc02d2481, but as applied)

Fix typo in -l*perl* pattern

one tiny Embed.pm patch for libperlm and friends

p5p-msgid: 199703110400.XAA20694@sinistar.idle.com
private-msgid: 199703110414.XAA12884@berlin.atlantic.net

Refresh DB_File to 1.12

>   Title:  "Regularize headings in DB_File documentation"
>    From:  Chip Salzenberg
>   Files:  ext/DB_File/DB_File.pm

Could you merge this patch please. It documents the fact that DB_File
will not yet work with Berkeley DB version 2.

p5p-msgid: 9703121551.AA07435@claudius.bfsec.bt.co.uk

In debugger, don't reference %{$f{$g}} if $f{$g} doesn't exist

New module: autouse.pm

Subject: Newer autouse.pm

I included support for prototypes (and some warnings in POD) into the
package, but cannot fully check them, since they trigger a lot of bugs
in support of prototypes in Perl. I hope that when the bugs are
corrected, this will work better.

Enjoy,

p5p-msgid: 199703210034.TAA13469@monk.mps.ohio-state.edu

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

3_93 doesn't install pods

My patch (which is in _93) broke installing .pod files.  At least,
I think it's my fault.  Anyway, here's the fix.

p5p-msgid: 199703160721.CAA08339@Orb.Nashua.NH.US

New subroutine Symbol::qualify_to_ref()

(this is the same change as commit 578b087ab63db59886b8f9a1e8bebc8524523fa5, but as applied)

New subroutine Symbol::qualify_to_ref()

Subject: Re: select under use strict

On Tue, 11 Mar 1997 16:36:25 -0500 (EST), Trevor Blackwell <tlb@viaweb.com> said:
>
>   use strict;
>   syswrite(select,"",0) || warn("$!");
[...]
> yields:
>
>   Can't use string ("main::STDOUT") as a symbol ref [...]

It seems a reasonable candidate for a new function in Symbol.pm, a
function just like qualify() which returns a globref.  Here's an
implementation.  I'll send this in again after 5.004.  In the meanwhile
you could just put something like it in your own code.

Usage would be like

    syswrite ref_qualify(select), "foo\n", 4 or die $!;

p5p-msgid: pzlo7ut03b.fsf@eeyore.ibcinc.com

Warn about missing -DMULTIPLICITY if likely a problem

Subject: Re: multiple embedded interpreter example in perlembed.pod fails

Ken Fox <kfox@ford.com> wrote:
> I wrote:
>
> > Multiple embedded interpreters don't work.  Here's a transcript:
> ...
> >     ccflags =''
>
> Ugh.  Stupid user error.  I ran Configure with -DMULTIPLICITY instead
> of -Dccflags='-DMULTIPLICITY'.  Sorry for the confusion.

you can also 'make LIBPERL=libperlm.a', libperld, libperldm, etc., or
edit cflags by hand after Configure.

> Could the
> runtime error message be improved to let people know when they've made
> this mistake?

good idea, something like the patch below?  I'm not sure of other
cases where e_fp would be bogus.

p5p-msgid: 199703192345.SAA15070@postman.osf.org

Math::Complex update

printf format corrections for -DDEBUGGING

Here are some more printf format fixes.  These are all in -DDEBUGGING
code.

p5p-msgid: 26592.858793370@eeyore.ibcinc.com

Don't use $(LIBS) when creating shared libperl

VMS update

Subject: Re: _93 is a keeper

In article <199703112146.QAA12455@nielsenmedia.com>, Chip Salzenberg <salzench@nielsenmedia.com> writes:
> Based on feedback so far, I think we can release _93 as the first beta.
> ("And there was much rejoicing." "yeah") However, the announcement will
> refer to the Win32 support as "not yet ready"; that will wait for _94.

Here's my $0.02, just in from the field :-):

5.003_93 unchanged:
VMS hmivax.humgen.upenn.edu 6.0 MicroVAX 3400 Series
All tests successful.
u=1649.55  s=0  cu=0  cs=0  files=120  tests=3337

5.003_93 with minor patches:
VMS ssrl.slac.stanford.edu 6.2 AlphaServer 2100 4/275:
All tests successful.
u=352.57  s=0  cu=0  cs=0  files=118  tests=3328

I've appended a few patches below, some necessary for the AXP build,
and others just cleaning up the last remnants of old VMS subprocess
status code and some other nits.

If you're just going to rename _93 on CPAN, don't worry about this stuff.
OTOH, if you're planning a new kit, it'd be nice if you could sneak in the
vms/descrip.mms patch (necessary for build on some systems) and the
utils/perlbug.PL patch (necessary for perlbug to work on all systems).

Thanks again for all the work!

Off to the docs . . .

p5p-msgid: 1997Mar11.220056.1873182@hmivax.humgen.upenn.edu

More MachTen hints

private-msgid: Pine.GSO.3.95q.970316133852.27997A-100000@kelly.teleport.com

allow C<substr 'hello', -10>

Subject: patch substr to fetch rightmost n characters

This is not a 'porting' issue, but I've
cc'd the list since many of the experts are there.

to extract the the first 3 (or less characters in a
string one can say

$ perl -le '$x="abcdefg"; print substr($x , 0, 3)'
abc
$ perl -le '$x="ab"; print substr($x , 0, 3)'
ab

but to print the last 3 characters (or less)
the analogy doesn't work.

$ perl -le '$x="abcdefg"; print substr($x , -3)'
efg
$ perl -le '$x="ab"; print substr($x , -3)'

I was trying to let a string grow, but keep
it shorter than some maximum length.

Of course a work around is to check the length of
the string, eg

$ perl -le '$x="ab"; print length($x)<3?$x:substr($x , 0, 3)'
ab

but this doesn't seem reasonable.

Can anyone think of a reason against changing substr
to allow this feature.  I had expected it to work this way.
(as it does with the following patch)

$ ./perl -wle '$x="ab"; print substr($x , -3)'
ab

p5p-msgid: 97Mar10.155517pst.35716-2@gateway.fluke.com

[dummy merge]

This merge exists so that the p5p version of the patch and the applied
version are both in the history

BSD/OS 3.0 hints

(this is the same change as commit 077b59947527f35fc97006c59d4f42e5fbe0b977, but as applied)