[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)

[dummy merge]

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

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

[dummy merge]

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

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

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

[dummy merge]

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

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>

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

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)

BSD/OS 3.0 hints

These are based on the 2.1 hints and the config.sh that BSDI used to build
their "perl5" executable.  It compiles and passes "make test" but has not
been tested extensively.

p5p-msgid: w47mjakw5t.fsf@loiosh.kei.com

Ignore whitespace before +*? in //x

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

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

 BUILD PROCESS

Subject: Fix for Unisys UNIX and libperl.so
Date: Thu, 6 Mar 97 16:28 GMT0
From: Alan Burlison <aburlison@cix.compulink.co.uk>
Files: Configure
Msg-ID: memo.147328@cix.compulink.co.uk

    (applied based on p5p patch as commit 2f525a329506abe067c4ec9d4c7ae13d8b223081)

Subject: Allow './Configure -Uoptimize'
Date: Thu, 06 Mar 1997 11:15:47 -0500 (EST)
From: Andy Dougherty <doughera@fractal.phys.lafayette.edu>
Files: Configure
Msg-ID: Pine.SOL.3.95q.970306110532.11070A-100000@fractal.lafayette.

    (applied based on p5p patch as commit 59ae47780c168857b216412f8354d10ae6dd0b61)

Subject: Use 'test -f', not 'test -x'
Date: Fri, 7 Mar 1997 19:53:00 -0500
From: Spider Boardman <spider@web.zk3.dec.com>
Files: Configure
Msg-ID: 199703080053.TAA13943@web.zk3.dec.com

    (applied based on p5p patch as commit 64b4562546c4e74f87c21f65a76ec05e96a1b74f)

 CORE LANGUAGE CHANGES

Subject: Don't autovivify array and hash elements in sub parameters
Date: Thu, 06 Mar 1997 14:12:09 -0500
From: Gurusamy Sarathy <gsar@engin.umich.edu>
Files: op.c pod/perldelta.pod pod/perlsub.pod pod/perltrap.pod
Msg-ID: 199703061912.OAA20606@aatma.engin.umich.edu

    (applied based on p5p patch as commit 0ffc6623ceb5acc7b954e8cdbaeb8ba319474d7b)

Subject: Support READ and GETC for tied handles
Date: Sat, 08 Mar 1997 19:19:38 -0500
From: Doug MacEachern <dougm@opengroup.org>
Files: pod/perldelta.pod pod/perltie.pod pp_sys.c t/op/misc.t
Msg-ID: 199703090019.TAA32591@postman.osf.org

    (applied based on p5p patch as commit b06b64f805517c26cbd7c4d2f74efd5f36b4692c)

Subject: Warn on C<@x =~ /a/> and C<%x =~ s/a/b/>
From: Chip Salzenberg <chip@perl.com>
Files: op.c pod/perldiag.pod

 CORE PORTABILITY

Subject: VMS update
Date: Fri, 07 Mar 1997 22:49:46 -0500 (EST)
From: Charles Bailey <bailey@HMIVAX.HUMGEN.UPENN.EDU>
Files: lib/ExtUtils/MM_VMS.pm vms/descrip.mms vms/gen_shrfls.pl vms/sockadapt.h

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

 DOCUMENTATION

Subject: Consolidated INSTALL updates since _92
Date: Sat, 08 Mar 1997 13:21:22 -0500 (EST)
From: Andy Dougherty <doughera@fractal.phys.lafayette.edu>
Files:
Msg-ID: Pine.SOL.3.95q.970308131806.23766F-100000@fractal.lafayette.

    (applied based on p5p patch as commit e6834c60cd85866fc530e8b4bb831af6186bad4d)

Subject: PODs corrections
Date: Fri, 7 Mar 1997 21:53:04 -0500 (EST)
From: Ilya Zakharevich <ilya@math.ohio-state.edu>
Files: ext/DB_File/DB_File.pm ext/Socket/Socket.pm lib/Class/Template.pm lib/ExtUtils/Embed.pm lib/ExtUtils/MM_VMS.pm lib/ExtUtils/Mksymlists.pm lib/File/Basename.pm lib/File/stat.pm lib/Time/gmtime.pm lib/Time/localtime.pm lib/Time/tm.pm lib/User/grent.pm lib/User/pwent.pm pod/perlcall.pod pod/perldebug.pod pod/perlfunc.pod pod/perlguts.pod pod/perllocale.pod pod/perlop.pod pod/perlsub.pod
Msg-ID: 199703080253.VAA24975@monk.mps.ohio-state.edu

    (applied based on p5p patch as commit 72451f4af0d31f24ef5b12bc5d034e3e8b35d43d)

 OTHER CORE CHANGES

Subject: Fix imbalanced ENTER/LEAVE from C<BEGIN{die}>
From: Chip Salzenberg <chip@perl.com>
Files: op.c perl.c proto.h

Subject: perl -P path patch
Date: Sat, 08 Mar 1997 12:45:08 -0500 (EST)
From: Andy Dougherty <doughera@fractal.phys.lafayette.edu>
Files: config_H config_h.SH perl.c plan9/config.plan9 t/comp/cpp.t vms/config.vms win32/config.H
Msg-ID: Pine.SOL.3.95q.970308120242.23766D-100000@fractal.lafayette.

    (applied based on p5p patch as commit bba014945c609b5474f61f5e82ed2ff3e83a6e47)

PODs corrections

Below I fix misfeatures of PODs found by pod2ipf. Just for fun note that it
auto-recognizes hyperlinks to WWW now.

p5p-msgid: 199703080253.VAA24975@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

Consolidated INSTALL updates since _92

I've incorporated the various suggestions for INSTALL.  Here's
the current version.  (I took the opportunity to regularize some
of the malloc-related sections as well as add the appropriate
info.)

Note:  There's one error here:  I refer users to L<perlvar> for
the description of $^M, but I don't see it there!

p5p-msgid: Pine.SOL.3.95q.970308131806.23766F-100000@fractal.lafayette.edu
private-msgid: Pine.SOL.3.95q.970308131806.23766F-100000@fractal.lafayette.

OS/2 doc update

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

OS/2 doc update

The patch below fixes some other goofs in README.os2 and INSTALL
discovered by pod2ipf (again, broken links + minor updates to OS/2).

p5p-msgid: 199703080537.AAA25157@monk.mps.ohio-state.edu

Use 'test -f', not 'test -x'

Subject: 3_92 get "test: argument expected" during Configure

This is a bug report for perl from spider@web.zk3.dec.com,
generated with the help of perlbug 1.16 running under perl 5.00392.

p5p-msgid: 199703080053.TAA13943@web.zk3.dec.com

Warn about '.' terminating E-Mail

Allow './Configure -Uoptimize'

Subject: Re: miniperl core dumps during build of 5.003_91 on Unisys SVR4

On Thu, 6 Mar 1997, Alan Burlison wrote:

> In-Reply-To: <memo.119650@cix.compulink.co.uk>
> > miniperl dumps core during the build on Unisys SVR4 version 1.4.

> Apparently there is a bug in the C compiler optimiser in this version
> of the OS.  I'll attribute this problem to that, & just turn off

Our record in this regard is mixed, at best, I think.  (Some
problems that appeared to be optimizer problems have been made to go
away by fixing possibly-related bugs in the perl source.)  Still, if it
works . . . .

> debugging. I am using Configure -des -Doptimize=' ' to do that.  Is
> this the best way?  -Uoptimize causes Configure to die.

Oops.  That's not nice.  The way I do this is

sh Configure -Doptimize=none

though your way is quite fine too.

In general, there's no particular reason to expect optimize='undef' to
do what you want, but it's not hard to handle it gracefully either, so
we could apply this low-urgency but low-risk patch:

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

Fix more E-Mail addresses in pods

Fix for Unisys UNIX and libperl.so

Subject: Re: Why libperl.a instead of libperl.so in 5.003_91? - A PATCH

In-Reply-To: <memo.141901@cix.compulink.co.uk>
> On the hunt of the elusive cause of the dynamic linker errors I am
> getting in 5.003_91, I have noticed that unlike every other vesion of
> perl5 prior to 5.002 that I have built on this platform, Configure
> now builds a libperl.a instead of a libperl.so.  Why?  I also note
> that the -Kpic flag has disappeared from the cc command lines.  Why?

The following patch to Configure solves the problem.  Do I win the prize for
the smallest ever patch to Perl?

p5p-msgid: memo.147328@cix.compulink.co.uk

Quote pathname before using as pattern

perl -P path patch

On Fri, 7 Mar 1997, Robin Barker wrote:

> This is a bug report for perl from rmb1@npl.co.uk,
> generated with the help of perlbug 1.16 running under perl 5.00392.
>
>
> -----------------------------------------------------------------
> [Please enter your report here]
>
> I can't get perl -P to work.
>
> In particular
> % perl -P t/comp/cpp.aux
> sh: /home/rmb1/local/perl/bin/cppstdin: not found
>
> the make process constructs cppstdin in the src directory
> and would copy that to $installbin
> but both t/comp/cpp.t and the perl binary look for a cppstdin
> executable in $scriptdir.

Thanks for the report.  This is a bug.  cppstdin belongs in $installbin,
not $scriptdir.

Why?  Because cppstdin is architecture-dependent.  It depends, in detail,
on the particular compiler required for that architecture.  True, we could
rewrite it in portable perl to use all the appropriate Config.pm
variables, but really, why bother?  It's a tiny script that is rarely
used, and I don't want to further encourage its use.

Here's a patch.  Hmm.  It's a bit longer than I first imagined because I
need to use BIN_EXP instead of BIN, and since perl currently doesn't use
BIN_EXP, metaconfig hadn't stuck it in config.h.

Alternatively, we could have put cppstdin in $installarch or something
like that, but we'd better keep it in $bin just in case some-one's been
relying on that.

Ok.  Here it is.  (Mind you, I haven't yet *tested* this on a machine that
needs cppstdin :-).

p5p-msgid: Pine.SOL.3.95q.970308120242.23766D-100000@fractal.lafayette.edu
private-msgid: Pine.SOL.3.95q.970308120242.23766D-100000@fractal.lafayette.

Ignore backup files in strict.t and warning.t

Support READ and GETC for tied handles

Subject: Re: Seeds of _93: planting TIEHANDLE/READ

Ilya Zakharevich <ilya@math.ohio-state.edu> wrote:

> Doug MacEachern writes:
> >
> > Chip Salzenberg <salzench@nielsenmedia.com> wrote:
> >
> > > Here's what I have for _93.  Speak now, etc.
> >
> > sorry to plant this seed so late, but I think it's important for the
> > growth of young TIEHANDLE.  We have PRINT and READLINE, why no READ?
>
> If you added READ, where is getc? Or is it covered by the patch?

sorry, I was being selfish, I don't care about getc :-)  new patch
against fresh _92 below.  I know this all came up in the past, there
are more missing, why where they not covered before?

p5p-msgid: 199703090019.TAA32591@postman.osf.org