pod2man produces broken pages

Georg Moritz <gm@mgm-net.de> wrote:

>A single quote in a pod file beginning a line, translated to \*(L'
>by B<pod2man> lets the formatter choke, i.e. the line is (in the best
>case) treated as a comment.

I think it would be better to leave the pods alone, and fix pod2man:

p5p-msgid: 1997May25.192350.2055977@hmivax.humgen.upenn.edu
Signed-off-by: Hans Mulder <hansm@icgned.nl>

pod2man produces broken pages

Georg Moritz <gm@mgm-net.de> wrote:

>A single quote in a pod file beginning a line, translated to \*(L'
>by B<pod2man> lets the formatter choke, i.e. the line is (in the best
>case) treated as a comment.

I think it would be better to leave the pods alone, and fix pod2man:

p5p-msgid: 1997May25.192350.2055977@hmivax.humgen.upenn.edu
private-msgid: 199705310447.AAA15721@obelix.cs.Buffalo.EDU
Signed-off-by: Hans Mulder <hansm@icgned.nl>

perlguts caveats

I've planted more warning signs per Ilya request.

p5p-msgid: 199705301341.JAA05204@aatma.engin.umich.edu
Signed-off-by: Ilya Zakharevich <ilya@math.ohio-state.edu>

perlguts caveats

Subject: Re: perlguts additions

On Sat, 17 May 1997 21:35:50 EDT, Spider Boardman wrote:
>Your first referenct to `mg_get', here:
>
>+a tied array, the caller will usually need to call C<mg_get(val)> to
>
>should be to `mg_set'.
>

Oops, thanks.

p5p-msgid: 199705180202.WAA22826@aatma.engin.umich.edu
Signed-off-by: Ilya Zakharevich <ilya@math.ohio-state.edu>

perlguts caveats

Subject: perlguts additions

Here are some additions that describe tied hash and array access.

p5p-msgid: 199705180052.UAA22066@aatma.engin.umich.edu
Signed-off-by: Ilya Zakharevich <ilya@math.ohio-state.edu>

Patch to show @INC when require dies

When 'require' dies because it can't find the file in @INC, it would
be helpful if perl printed out the contents of @INC, to help debu
the problem (especially when perl is invoked in devious ways, such
as via a C application in which perl is embedded with funny secret
-I args passed to perl_parse!).

I would like to contribute a patch to 5.004 to do just that.

p5p-msgid: 9705230121.AA27872@membrane.hal.com

ENV leaks on win32 (was Re: Comments on ENV patch sought)

Subject: [PATCH] for NETaa13787: %ENV=(); doesn't clear the environment

Perl maintains two representations of the environment:

(A) a hash named %ENV, used by the perl script
(B) a char** named environ, which is passed to child processes

Obviously, the intent is to keep tho two in sync.
This fails in two situations:

(1) A list assignment to %ENV clears (A) but not (B);
(2) Assigning to $0 has the side effect of deleting the key
NoNeSuCh form (B) but not from (A).

$ perl -e '%ENV=(); print "home\n" if exists $ENV{HOME}; exec "echo \$HOME";'
/Users/hansm
$ perl -e '$ENV{NoNeSuCh} = "foo"; $0 = "bar"; exec "echo \$NoNeSuCh";'

$ perl -e '$ENV{NoNeSuCh} = "foo"; exec "echo \$NoNeSuCh";'
foo
$

I've complained about rpoblem (1) before; and Larry assigned
it bug ID NETaa13787 when he entered it into DDTS.

The patch below attempts to remedy both problems, at least on
Unix platforms.  I don't know how to handle the environment
on VMS and WIN32; my code simply calls DIE('unimplemented"),
which is honest but won't make users on those plaforms happy.

p5p-msgid: 199705292240.AAA01135@mail.euronet.nl
Signed-off-by: Peter Prymmer <pvhp@forte.com>

No DESTROY on untie. Tie memory leak fixed.

Subject: Re: Bug w/ DB_File: no flush on untie

On Sat, 17 May 1997 16:06:26 BST, Paul Marquess wrote:
>
>Good bug report Jay. Thanks.

I'll say!

>Turns out this isn't a DB_File problem but a tied hash/array problem.
>Running this script:
>
>    package fred ;
>    sub TIEHASH { return bless [] }
>    sub TIEARRAY { return bless [] }
>    sub FETCH { print "FETCH\n"}
>    sub STORE { print "STORE\n"}
>    sub CLEAR { print "CLEAR\n"}
>    sub DESTROY { print "DESTROY\n" }
>
>    package main ;
>
>    tie %x, 'fred' ;
>    %x = (1,2,3,4) ;
>    $x{2} = 3 ;
>    untie %x ;
>    print "untied\n" ;
>
>I got
>
>    CLEAR
>    STORE
>    STORE
>    STORE
>    untied
>    DESTROY
>
>The tied object isn't getting destroyed until global destruction at the
>end. That is a bug. I'd guess that something in the logic to do array
>assignments is holding on to the tied object and not letting go.
>
>The story is the same for tied arrays.
>
>Who said they were going to take on the tied stuff post 5.004?

That's partly on my plate.

This bug (a memory leak, actually) has been around since the beginning
of time, and I'm thoroughly stupefied that it hasn't been noticed before.

Here's a fix.  People who have made noises before about ties being
memory hogs should give this patch a try.

p5p-msgid: 199705172156.RAA20561@aatma.engin.umich.edu
Signed-off-by: Jay Rogers <jay@rgrs.com>
Signed-off-by: Paul Marquess <pmarquess@bfsec.bt.co.uk>

Regex Bug in 5.003_26 thru 003_99a

According to Tom Christiansen:
> I just *knew* I should have included stuff from my FMTEYEWTK on regexen
> in the regression suites.   You'll note that you've now rendered p71 of
> the Camel a liar.  This is considered Very Naughty.

*sigh*  Well, without a bug report, what I could I do?...

> I'd say this is a must-fix.

Here's a patch.  I suppose this should go into _01.

p5p-msgid: 199705161915.PAA18721@rio.atlantic.net
Signed-off-by: Chip Salzenberg <chip@atlantic.net>

PATCH: bug in perlbug w.r.t. environment variables

Here is patch for the problem, this adds sorting all of the environment
(I see little point in sorting just some).

p5p-msgid: 199705191857.VAA09154@alpha.hut.fi
Signed-off-by: Jarkko Hietaniemi <jhi@iki.fi>

h2xs missing from utils/Makefile

Re: Using undef to ignore values returned from split

More simple regexp tests and test docs

[dummy merge]

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

op/groups test fails on Linux (groups in /bin)

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

op/groups test fails on Linux (groups in /bin)

The test op/groups checks for groups in /usr/bin and /usr/ucb.
This fails on some Linux distributions that has groups in /bin.

A better test would be to just run groups (take whatever is in the
path) and see if it outputs a list that includes the current
group.  Possibly you could prepend /bin:/usr/bin:/usr/ucb to the
current path.  Something like this.

p5p-msgid: 199705191120.NAA08130@ostrich.gaia.swipnet.se

SVR4 hints for DDE SMES Supermax Enterprise Server

misc perl5.004 doc fixes

here are a few doc changes that fix a few typos, etc.

p5p-msgid: 199705160419.AAA16317@cas.org

(NEXT|OPEN)STEP hints

pathname bug in xsubpp on win32

If xsubpp is run with the argument "c:\i.xs", it will
generate bad #line directives, like:

 #line 1 "c:\i.xs"

which will cause VC++ to barf over a bad "\i"
escape sequence.

p5p-msgid: 199705230126.SAA23401@clamp.netlabs.com

Pod::Text nit for Win32

Re: Term::ReadKey on Win32: set console

clean up perlocal.pod output on VMS

[dummy merge]

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

perl5.004 on AIX: Patches

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

perl5.004 on AIX: Patches

I took a further look at the problems which I described in my previous
post, and managed to make a patch for the -Duseperlio problem. [this]
makes both -Duseperlio and -Dshrplib work [...]

Should have spotted this earlier, but hey...

p5p-msgid: Pine.A32.3.93.970519163700.25188A-100000@junior.uwc.ac.za

[dummy merge]

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

[PATCH] Harness.pm bug w/perl5.004 & VMS

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

[PATCH] Harness.pm bug w/perl5.004 & VMS

Harness.pm's got a bug under VMS. $estatus is my'd and assigned to at the
same time--unfortunately the assignment's a trinary conditional that uses
$estatus, presumably before the my context is fully established. It
generates an estatus doesn't exist error message for the first test only,
and, after all the t/*.t tests are through, kills perl with an ACCVIO.

The following patch just splits the my and assignment into two separate
statements, which makes perl much happier.

p5p-msgid: 3.0.1.32.19970530102300.008a2730@stargate.lbcc.cc.or.us

Patch to CPAN.pm (perl5.004) for ncftp

  I found a minor bug in CPAN.pm and swatted it.  When I perform "perl
-MCPAN -e 'install "Net::FTP", my system does not have LWP installed,
nor "lynx", but I do have "ncftp" version 2.3.0 (December 5, 1995).
Attempts to redirect standard output of "ncftp" failed, because the
CPAN.pm command causes "ncftp" to directly create the file and nothing
is sent to standard output.  I have included a patch that adds the "-c"
flag so that the file is instead sent to standard output.

p5p-msgid: 337FBAC8.167EB0E7@monmouth.com

Memory Consumption of autosplit_lib_modules/sv_gets (workaround)

LWP and SIG __DIE__ traps not playing well together!

sdbm can fail if a config.h exists in system directories

5.004 removed deprecated %OVERLOAD support silently

Reported-by: Jonathan Biggar <jon@sems.com>
p5p-msgid: 199705232319.QAA28388@clamp.netlabs.com

perlembed Win32 update

-w interacts badly with -Dt

[differences between cumulative patch application and perl5.004]

[inseparable changes from match from perl-5.003_99a to perl5.004]

 BUILD PROCESS

Subject: Don't use 'unset' in Configure
From: Chip Salzenberg <chip@perl.com>
Files: Configure

Subject: Protect against having no such command as 'cc'
Date: Mon, 12 May 1997 16:35:34 -0400 (EDT)
From: Hans Mulder <hansm@icgned.nl>
Files: Configure
Msg-ID: 1997May12.163534.2006434@hmivax.humgen.upenn.edu

    (applied based on p5p patch as commit 3bf198a5e20d135d4136d3233d58cf49a70772d9)

Subject: minor wording enhancement for Configure
Date: Sat, 10 May 1997 13:38:31 +0300 (EET DST)
From: Jarkko Hietaniemi <Jarkko.Hietaniemi@cc.hut.fi>
Files: Configure

    private-msgid: 199705101038.NAA00471@alpha.hut.fi

 CORE LANGUAGE CHANGES

Subject: Make C<m//g> reset pos on failure; make C<m//gc> not reset
From: Chip Salzenberg <chip@perl.com>
Files: dump.c op.c op.h pod/perldelta.pod pod/perlfaq6.pod pod/perlop.pod pod/perlre.pod pp_ctl.c pp_hot.c regcomp.c t/op/pat.t toke.c

Subject: SECURITY: Forbid exec() if $ENV{BASH_ENV} is tainted
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod pod/perlrun.pod pod/perlsec.pod t/op/taint.t taint.c

Subject: Allow exec() if $ENV{TERM} is tainted but innocuous
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod pod/perlrun.pod pod/perlsec.pod t/op/taint.t taint.c

Subject: Allow globbing when tainted under VMS (no external program)
From: Chip Salzenberg <chip@perl.com>
Files: pp_sys.c t/op/taint.t

 CORE PORTABILITY

Subject: Win32 update (three patches)
From: Gurusamy Sarathy <gsar@engin.umich.edu>
Files: README.win32 perl.c win32/Makefile win32/config.H win32/config_h.PL win32/config_sh.PL win32/makedef.pl win32/win32.c win32/win32.h win32/win32io.c win32/win32io.h win32/win32iop.h

Subject: Don't require executable bit on perl -S if DOSISH
Date: Fri, 09 May 1997 12:33:18 -0400
From: Danny Sadinoff <sadinoff@olf.com>
Files: perl.c
Msg-ID: 337351CE.79B28DE3@olf.com

    (applied based on p5p patch as commit 7596f71a28f72f9e3abd6d3962d29a7752cd9303)

 DOCUMENTATION

Subject: Tweaks for perldelta
Date: Sun, 11 May 97 01:46:00 +0200
From: Unknown Contributor <hansm@euronet.nl>
Files: pod/perldelta.pod
Msg-ID: 199705102346.BAA17300@mail.euronet.nl

    (applied based on p5p patch as commit 3e10809228cc961223b894e1639b44f8e2b64de0)

Subject: Mention perlfaq.pod and perlmodlib.pod in perldelta.pod
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod

Subject: Fix example of use of lexicals with formats
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod

 OTHER CORE CHANGES

Subject: In C<eval &func>, always call &func in scalar context
From: Chip Salzenberg <chip@perl.com>
Files: op.c

Subject: Fix recursive substitution
From: Chip Salzenberg <chip@perl.com>
Files: cop.h global.sym pp_ctl.c proto.h scope.c

Subject: Fix core dump from get*() functions returning no alias array
From: Chip Salzenberg <chip@perl.com>
Files: pp_sys.c

Subject: Fix typo
Date: Sat, 10 May 1997 17:28:35 -0500
From: Mark K Trettin <mkt@lucent.com>
Files: pp_sys.c

    private-msgid: 199705102228.RAA11163@gv18c.ih.lucent.com

Tweaks for perldelta

Here are a few more doc fixes.

The last one merely reformats a paragraph, so that a C<...> construct
is no longer spread across a line boudary.  The perlpod page suggests
this is allowed, but does not actually say so.  However, pod2html can't
handle it and all other instaces have been fixed recently (which would
suggest that it' not allowed).

p5p-msgid: 199705102346.BAA17300@mail.euronet.nl

Protect against having no such command as 'cc'

ilya@math.ohio-state.edu (Ilya Zakharevich) wrote:

>> At some stage Configure asks "Which memory models are supported?"
>> In order to find the default to this question, Configure compiles
>> and runs a little test program.  To compile this test program,
>> Configure uses straigt "cc", not "$cc", presumably because it
>> doesn't know $cc at that point (that's the next question).

>This is very suspicious, since I do not have cc at home (OS/2), but
>no failure of Configure happens.  Or did you imply that Configure just
>ignores the failure, or runs it on some platforms only?

It ignores the error.  On my unix box, I get a message

Configure: cc: not found

You could suppress that message with this patch:

p5p-msgid: 1997May12.163534.2006434@hmivax.humgen.upenn.edu

More detailed IO::Socket documentation

private-msgid: 199705141456.IAA19061@jhereg.perl.com

Don't require executable bit on perl -S if DOSISH

update to previous bugreport regarding the -x filetest and running
perl -S filename.

I misstated the patch necessary for turning off the executability check
for the -S option.  It should be:

p5p-msgid: 337351CE.79B28DE3@olf.com

[dummy merge]

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

Note that DATA filehandle is unavailable during BEGIN {}

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

Note that DATA filehandle is unavailable during BEGIN {}

Subject: DOC PATCH: restriction on DATA filehandle?

This is a very minor patch to add in a clarification on the use of DATA
within a BEGIN block. Thanks to Chip for confirming this.

p5p-msgid: 199705121227.NAA29718@tardis.cre.canon.co.uk

[dummy merge]

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

Explain that destruction order is not defined

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

Explain that destruction order is not defined

Subject: Re: perl debugger problem with object destructors?

On Wed, 14 May 1997 15:12:38 MDT, Tom Christiansen wrote:
>
>Actually, deterministic destruction/finalization is oft-deemed
>a feature.   If you could check what perltoot has to say about destructors,
>gsar, and suggest an appropriate patch if necessary, I'd appreciate it.

I'd say something like this:

p5p-msgid: 199705150600.CAA13550@aatma.engin.umich.edu

h2xs and @EXPORT_OK

Currently, h2xs emits the line:

use vars qw($VERSION @ISA @EXPORT);

Should @EXPORT_OK also be added to this list?

p5p-msgid: 199705092348.AA057881699@hpcc123.corp.hp.com

Fix sleep test: sleep(N) is defined to allow sleeping N-1

> But I found minor problem here. In some situation, BSD/OS sleep does
> not sleep two seconds (at least in my configuration) and it says
> op/sleep.t failure. If I ran the test suite again, it passed and show
> me 100% OK result.

I just read over t/op/sleep.t.  Frankly, I'm suprised I haven't seen
it fail on HPUX also.  On HPUX, SIGALRM is delivered only _on_ the
second.  Thus, sleep(1) waits until the next even second, sleep(2)
waits until the next even second after that, etc.

The side effect of this is that sleep(1) causes a delay of 0-1 second,
sleep(2) causes a delay of 1-2 seconds, etc.  This *should* cause
intermittant failure of the sleep test as currently written.  I don't
have access to a BSD system, but something similar could be happening
there.

You could argue that this is a bug in the OS sleep().  However, it
means that a loop like...

while (foo()) {
bar();
sleep();
}

...will cycle once-per-second (as long as bar() executes in < 1
second) instead of cycling once-per-(second + bar()-delay).  This
could be construed as a feature.

p5p-msgid: 199705151735.KAA01143@palrel1.hp.com

Make rand.t vanishingly unlikely to give false failure

On Wed, 7 May 1997, Larry Schwimmer wrote:

> Subject: FYI: perl5.00399/t/op/rand.t test 7

>  I know this sounds perverse, but it did happen to fail test 7
> of op/rand.t the very first time I ran make test on a Solaris 2.5.1
> machine, and the test does say to mail the developers if that
> happened.  (-:

And thank you for doing so. Ya done good. :-)

When I wrote that test, I had thought (erroneously, as it turns out) that
that test would never fail, or virtually never. Actually, on Solaris, it
can report a false positive about one time in two-to-the-15th tests.

That test attempts to ensure that srand's default seed isn't the same
twice in a row, which it shouldn't be. But was your test result falsely
positive, or was it a bug for real? We have no way to know.

> It worked fine the next 100 times I ran it and on the other seven
> builds,

Okay, if you had success the next 100 times, it's _probably_ a fluke.
There's no way to know for sure, though, short of finding a bug in the
srand code. :-(

I'm supplying a patch which makes the test more reliable without reducing
the sensitivity to bugs. This should effectively eliminate this problem,
except for unavoidable coincidences.

> but it might be nice to run the test file multiple times to
> reduce the likelihood of a false failure while still catching errant
> builds.

Actually, that wouldn't do the trick. If we ran it five times, and one of
those attempts gets the same srand seed twice, that's _still_
unacceptable. The program has to notify a human, since recompiling perl,
checking the source, and asking for advice are things that humans still do
better than machines. But this patch will make the machine a little better
at knowing when to cry "Wolf!" :-)

Thanks!

p5p-msgid: Pine.GSO.3.96.970510190846.23340K-100000@kelly.teleport.com

Fix core dump on IO::Seekable::setpos($fh, undef)

In IO::File::open, prepend './' less often (for Win32 et al)

Refresh CGI.pm to 2.36

[dummy merge]

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

Make read with <> from a TTY notice EOF

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

Make read with <> from a TTY notice EOF

The patch I just sent in wasn't quite correct.  I should have tested
it more before sending it :-).  Here's a correct patch.

p5p-msgid: 199705121147.HAA03845@jik.saturn.net

Fix recursive substitution [test]

VMS update, including socket support (four patches)
Signed-off-by: Peter Prymmer <pvhp@forte.com>
Signed-off-by: Dan Sugalski <sugalsd@lbcc.cc.or.us>

Fix default HP-UX installation path

private-msgid: 199705132228.AA227042483@hpcc123.corp.hp.com

Make Irix hints adapt when n32 libm.so is missing

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

[inseparable changes from match from perl-5.003_99 to perl-5.003_99a]

 BUILD PROCESS

Subject: AFS patches
From: Chip Salzenberg <chip@perl.com>
Files: Configure installperl

 CORE LANGUAGE CHANGES

Subject: SECURITY: Forbid glob() when tainting (-T or setuid)
From: Chip Salzenberg <chip@perl.com>
Files: pod/perlrun.pod pod/perlsec.pod pp_sys.c

Subject: SECURITY: Forbid exec() if $ENV{TERM} or $ENV{ENV} is tainted
From: Chip Salzenberg <chip@perl.com>
Files: pod/perlrun.pod pod/perlsec.pod t/op/taint.t taint.c

 CORE PORTABILITY

Subject: (NeXT|Open)Step update
Date: Wed,  7 May 97 17:47:02 -0500
From: Gerd Knops <gerti@BITart.com>
Files: Configure MANIFEST config_h.SH hints/next_3.sh hints/next_4.sh

    private-msgid: 9705072247.AA18882@BITart.com

Subject: Win32 update (consolidated patch plus three followups)
From: Gurusamy Sarathy <gsar@engin.umich.edu>
Files: EXTERN.h README.win32 lib/Sys/Hostname.pm pod/perldelta.pod win32/config.H win32/config.w32 win32/config_sh.PL win32/perllib.c win32/win32.c win32/win32.h win32/include/sys/socket.h

 DOCUMENTATION

Subject: Updates to perldelta
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod

Subject: Document 'Possible attempt to separate words with commas'
Date: 06 May 1997 23:27:55 +0200
From: Gisle Aas <gisle@aas.no>
Files: pod/perlop.pod
Msg-ID: hyb9snvdw.fsf@bergen.sn.no

    (applied based on p5p patch as commit 18270fd3b8aafde2f9ea21ea13adde95ef24b149)

Subject: Document that C<m?x?> is just like C<?x?>
From: Chip Salzenberg <chip@perl.com>
Files: pod/perlop.pod

 OTHER CORE CHANGES

Subject: Fix for redefined sort subs nastiness
Date: Thu, 08 May 1997 20:04:18 -0400
From: Gurusamy Sarathy <gsar@engin.umich.edu>
Files: op.c pod/perldelta.pod pod/perldiag.pod sv.c t/op/sort.t
Msg-ID: 199705090004.UAA15032@aatma.engin.umich.edu

    (applied based on p5p patch as commit e9e069932a0db06904b29e2b09a435afd40ed35c)

Document 'Possible attempt to separate words with commas'

Perhaps we should just document it:

p5p-msgid: hyb9snvdw.fsf@bergen.sn.no

OS/2 doc patch for _99

It adds some info people judged hard-to-find...

Enjoy,

p5p-msgid: 199705080046.UAA23466@monk.mps.ohio-state.edu

Fix for redefined sort subs nastiness

>sub sortfunc { &once }
>sub once {
>    eval q{
> print "Eval from ", join(':', caller(0)), "\n";
> sub rest {
>     print "REST: $a <=> $b\n";
>     $a <=> $b
> }
>    };
>    *sortfunc = *rest;
>    &sortfunc;
>}
>@x = sort sortfunc 10, 5, 2.5, 1.25;

That misbehaves due to the redefinition of the sort sub
while the sort is active.  That's a big no-no, because
the sortcop was pointing to the CvSTART of the original,
and it will now point to freed memory (if the sub really
got undefined).

Here's a tested patch that does nothing but die under
that circumstance.

p5p-msgid: 199705090004.UAA15032@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

Mention the Regular Expressions book

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

Mention the Regular Expressions book

| Could somebody please add Jfrield's Mastering Regeular Expressions to
| perlbook.pod, and also to a SEE ALSO in perlre.pod?

p5p-msgid: 199705071548.KAA05924@psa.pencom.com
private-msgid: 199705071737.MAA18799@psa.pencom.com

Refresh description of sprintf()

Debugger docs patch

New bit 16 of the `frame' option and the new `ornaments' option is
documented.

Enjoy,

p5p-msgid: 199705080107.VAA24317@monk.mps.ohio-state.edu

perlfaq9, hostname

Simple patch...

p5p-msgid: 199705061741.NAA22777@cse.psu.edu

More explicit Solaris instructions

Here are two patches to try to make the gcc -B/usr/ccs/bin/ trick
more apparent.  They were suggested by a user who didn't find the current
hints and INSTALL file sufficiently specific.

As a side effect, you get whatever else I had cooked up to go into the
next INSTALL update.

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

Newer CPerl mode

Some major flaws became appparent in older CPerls, and newer ones
prove themselves reasonably good, so here it is (for inclusion into
5.004):

Description of changes is one page down,

Enjoy,

p5p-msgid: 199705080032.UAA22532@monk.mps.ohio-state.edu

Trivial bugfix for pod of xsubpp

private-msgid: 199705051447.QAA09995@en1.engelschall.com

Three bugs in pod2html

I had three problems with the pod2html distributed with perl 5.00399:

1. The HTML code generated begins with a series of hyperlinks to all
   sections of the file.  Pod directives occurring in the section
   titles (=head directives) were not translated.

2. C<foo()> sets translates to <CODE>foo</CODE> -- the () disappear.

3. Perlpod promises that example code gets typeset with tab stops
   every 8 columns.  HTML makes no such promise, hence pod2html must
   expand tabs.

The first three hunks of the patch below solve #1, hunk 4 fixes a
call to &process_text with the wrong number of args, hunk 5 solves #3
and hunk 6 solves #2.x

p5p-msgid: 199705052228.AAA25351@mail.euronet.nl

Another blank line patch to Pod::Text

If an =over/=back block ends just before a =head1 tag, there is an
extraneous blank line before the heading.  This patch fixes that and
doesn't appear to have any negative effects.  The blank line after the
last =item should be provided by the =item's paragraph break.

p5p-msgid: m3afm5g6ar.fsf@windlord.Stanford.EDU

Fix wantarray() in sort subs [fixes metaconfig]

Win32 boot_DynaLoader problem in 99

In makedef.pl, boot_DynaLoader is defined in $skip_sym.  It should be
included in the __DATA__ section to force it into the dll exports.

p5p-msgid: 1997May05.105000.1708.84476@mail.jeld-wen.com

HPUX: patch for ext/DynaLoader/dl_hpux.xs

By default, doing a "make test" on a dynamically loaded module with
unresolved symbols will result with a useless error message.  Adding
the BIND_VERBOSE flag will add the names of undefined symbols to the
error message already printed to stderr.  This does *not* affect
default operation; only when PERL_DL_NONLAZY is set does it make a

p5p-msgid: 199705050548.WAA21260@palrel1.hp.com

Irix hint update

Hopefully, this is the final set of patches for the IRIX hints file
hints/irix_6.sh.  This is rather a multi-person effort, Jarkko and
John Stoffel wrote the major changes (and changed the default to
-n32), I made the last tweaks so that -o32 still works without
errors on the various compiler releases.  I've tested on IRIX-6.2,
IRIX64-6.2, IRIX64-6.4 and IRIX-6.5alpha.

p5p-msgid: yd83es0fp57.fsf@hoshi.engr.sgi.com

NetBSD hint update

There is a missing character in hints/netbsd.sh.

Line 51
case "$osver" in

should be
case "$osvers" in

Missing this case leads to the functions

setregid()
setreuid()
setrgid()
setruid()

being used, leading to a security problem on all released versions
of NetBSD.

p5p-msgid: 199705051346.XAA13584@topaz.nemeton.com.au

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

[inseparable changes from match from perl-5.003_98 to perl-5.003_99]

 CORE PORTABILITY

Subject: NeXT hints update
Date: Thu, 1 May 97 00:28:41 +0200
From: Unknown Contributor <hansm@euronet.nl>
Files: Configure Makefile.SH hints/next_4.sh

    private-msgid: 199704302229.AAA02690@mail.euronet.nl

Subject: Support shared libperl on AIX
Date: Sat, 26 Apr 1997 20:31:37 -0500
From: Eric Bartley <bartley@icd.cc.purdue.edu>
Files: Configure Makefile.SH hints/aix.sh
Msg-ID: 199704270131.UAA51426@icd.cc.purdue.edu

    (applied based on p5p patch as commit 019c9bb5516c92cceeeb4b050fa8075a1359c43c)

Support shared libperl on AIX

The current distribution will not build a shared libperl on AIX.

Currently the Makefile generated uses the same ld options for building
a shared libperl and dynamicly loaded extentions.  AIX's compiler
requires that you tell it explicitly what symbols to export/import. So,
it needs a separate set of LD options for each.

On top of all this, AIX doesn't seem to have an equivilent to
LD_LIBRARY_PATH. So, the directories to search during runtime must be
explicitly compiled in. In the following patch I compiled in both the
compilation directory (for miniperl and testing) and the installation
directory. I wish someone could suggest something cleaner, but it works.

p5p-msgid: 199704270131.UAA51426@icd.cc.purdue.edu

Fix typo in perldelta

Fix description of av_undef() in perlguts

private-msgid: 199705011042.MAA09897@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

typo fixes to installhtml

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

typo fixes to installhtml

I noticed a few typos in this file so here's a fix.  It's from a strictly
vanilla install.

p5p-msgid: 199705011114.HAA26968@cas.org

Disable op/pipe.t test under Machten

At 09:47 +0200 1997-05-01, I wrote:
>Everything else is as expected, but I'm looking into this:
>
>dialup02 domo$ ./TEST io/pipe.t
>io/pipe...........print failed: Broken pipe at ./io/pipe.t line 86.
>FAILED on test 9

Here's a patch.  It seems MachTen doesn't behave like native UNIX here, so
punt.

Given that VMS doesn't behave like native UNIX either (and there's been
nothing on the list yet about NT and other "aliens"), test 9 looks like a
good emulation exposer.  Is this what we want?  As far as I can make out
from a little mucking about and a reading of ISO 9945-1:1990, MachTen is
behaving in a way that POSIX allows: stdio elects not to buffer writes on
pipes (a defensible decision); a write on a broken pipe fails with EPIPE
and raises SIGPIPE (correct by POSIX); close of a broken pipe succeeds
(correct by POSIX,and OK by perl: nothing's buffered, because the write
failed) if the pipe reader exited with zero status.  Slightly
disconcertingly, I discover that, if I substitute the command 'false' for
'true' as the putative pipe reader, the (perl) close fails.  close() is not
documented as failing if a pipe reader has terminated with a non-zero exit
code.  Is this a documentation shortcoming, a general perl bug, or a
MachTen perl bug?  Whether close() suceeds or fails, $? is set
appropriately.

Whatever, so as to get 5.004 out of the door, either apply this patch or do
away with test 9 entirely, pending deeper reflection.

p5p-msgid: v03102801af8e160d3879@[194.51.248.68]

Refresh DB_File to 1.14

Something for _99.

Made it illegal to tie an associative array to a RECNO database and an
ordinary array to a HASH or BTREE database.

p5p-msgid: 9704302045.AA05484@claudius.bfsec.bt.co.uk

Add new globals to perl.exp

Fix OS/2-specific buffer overflow

private-msgid: 199704301920.PAA09681@monk.mps.ohio-state.edu

Fix sysread() on tied handle

Found in both perldelta.pod and perltie.pod:

: =item READ this LIST
:
: This method will be called when the handle is read from via the C<read>
: or C<sysread> functions.

This isn't true without the following patch:

p5p-msgid: 199705010601.CAA04926@Orb.Nashua.NH.US

Handle tainted values in lists returned from subs, evals

Forget prototype of subroutine after C<undef &subr>

Fix NUL-termination bug in delimcpy()

[inseparable changes from match from perl-5.003_97j to perl-5.003_98]

 DOCUMENTATION

Subject: Add new diagnostics to perldelta
From: Chip Salzenberg <chip@perl.com>
Files: pod/perldelta.pod pod/perldiag.pod

Support C< $coderef->($x,$y) >

Randal Schwartz said:
> Some time in October, 1994, Larry Wall said:
> > : All other references you can follow with ->, what about code refs?
> > Aw, look, I'd really like that feature in, but I think it's a bit
> > too close to the release for that.
> Hey Chip,
> Look, Larry said he'd really like that feature

Larry said that?  That change is like two lines, it's in!

Tricked-into-doing-by: Randal Schwartz <merlyn@stonehenge.com>