Add hints for new users, and miscellaneous updates from Andy Dougherty

Update

perl 5.002_01: hints/dynixptx.sh

Add hints file for Dynix/ptx 4; Configure doesn't yet recognize
it, but will soon (mod Andy's schedule), and offers it in the
list of possibilities now.

perl 5.002_01: hints/bsdos.sh

Update BSD/OS hints file to newer version shipped with Perl 5.001m,
but comment out sig_name assignment, since it doesn't have a parallel
sig_num.  Configure should do ok now, though, according to Andy Dougherty.

Add $^E and $^O to special vars, and change run to runops

perl 5.002_01: global.sym

Add several missing symbols, and change run to runops, so its
EMBEDded name doesn't collide with perl_run in case-insensitive
linkers

perl 5.002_01: ext/POSIX/POSIX.xs

VMS update: emulate several near misses in signal handling, and
slightly different header file structure.  (Yes, it's not strictly
POSIX, but it's close.)

perl 5.002_01: ext/FileHandle/FileHandle.pm

Remove English, since it slows both FileHandle initialization and
regexp evaluation throughout any program that uses FileHandle

Convert to use $^O and Config's $dl_so instead of hard-wired .o

OS/2 update

Make EMBED the default, unless overridden by -DNO_EMBED

perl 5.002_01: embed.h

EMBED is now the default, unless overridden by -DNO_EMBED on
the cc command line.  Also adds several missing symbols.

Fix BIT_BUCKET, and add stubs for macros used by OS/2

Provide default value for $^O in C

Updated to reflect sigjmp and $^O patches

perl 5.002_01: Configure

Use SUBVERSION in default value for $archlib, so development
and production architecture-dependent libs can coexist
(Sorry; I don't have metaconfig, so this is a direct patch
against Configure.)

Added warning about fixed /x regexps -- # now always starts a comment

perl 5.002_01: [patch re-organisation and introduction]

This is my patch _01 to perl 5.002.

The bulk of this patch consists of VMS and OS/2 updates, and the
conversion to use EMBED as the default when building Perl.  It
also includes miscellaneous bugfixes, corrections to the pods,
and minor additions, notably the new $^E and $^O variables.

[editor's note: the changes between this and the perl-5.002_01 tag are
the individual changes in the patch set]

perl 5.002

[editor's note: changes seem to be mostly module updates,
documentation changes and some perl API macro additions]

perl 5.002gamma: utils/h2xs.PL

>From roehrich@cray.comTue Feb  6 10:10:30 1996
>Date: Mon, 5 Feb 1996 20:30:34 -0600
>From: Dean Roehrich <roehrich@cray.com>
>To: perl5-porters@africa.nicoh.com
>Subject: h2xs 1.15
>
>This is h2xs version 1.15.  Apply over beta3.
>
>From roehrich@cray.comWed Feb  7 09:17:51 1996
>Date: Tue, 6 Feb 1996 18:31:53 -0600
>From: Dean Roehrich <roehrich@cray.com>
>To: perl5-porters@africa.nicoh.com
>Subject: h2xs 1.16
>
>Following a suggestion from PaulM, I have updated the AUTOLOAD() that h2xs
>creates.  It uses Carp::croak now.

NETaa15204 patch problem

Re: Strange coredump in Tk

Move perl_init_i18nl14n here from miniperlmain.c.

Beta3: Fix for FILE leak when "use" fails

This patch fixes a file leak triggered by "use" or "require" errors.
I think it's of fairly high priority...

Beta3: Ensure hex() and oct() positive [edited]

This patch ensures that hex() and oct() always return positive values.

VMS updates.

Patches for test suit for better portability

This does not change actual tests, but improves support code such that
an early bail out does not happen if environment is not Unixish.

Re: Beta3: Fix bad warning on bitwise ops

Avoid unreferenced stub for VMS.

Patch to use sh under OS/2

Beta3: Combine code: provide_refs

perl 5.002gamma: pp.c

>From salzench@dun.nielsen.comSat Feb  3 15:18:05 1996
>Date: Sat, 3 Feb 1996 12:45:32 -0500 (EST)
>From: Chip Salzenberg <salzench@dun.nielsen.com>
>Reply to: chip@atlantic.net
>To: Perl 5 Porters <perl5-porters@africa.nicoh.com>
>Subject: Beta3: Combine code: provide_refs

>From lwall@sems.comWed Feb  7 09:10:55 1996
>Date: Tue, 06 Feb 96 14:52:41 -0800
>From: Larry Wall <lwall@sems.com>
>To: perl5-porters@africa.nicoh.com
>Subject: study still busted

Update to match new home of Pod::Functions.

perl 5.002gamma: pod/pod2man.PL

>From Richard_Ohnemus@dallas.csd.sterling.comThu Feb  8 10:09:31 1996
>Date: Wed, 7 Feb 1996 20:47:25 -0600 (CST)
>From: Richard Ohnemus <Richard_Ohnemus@dallas.csd.sterling.com>
>To: perl5-porters@africa.nicoh.com
>Subject: small bug in pod2man

pod2man will generate incorrect man pages if the pod file name has more than
1 dot ('.') in it.

>From kjahds@kjahds.comFri Feb  9 12:56:50 1996
>Date: Fri, 9 Feb 1996 12:06:23 -0500 (EST)
>From: Kenneth Albanowski <kjahds@kjahds.com>
>To: Peter Wolfe <wolfe@teloseng.com>
>Cc: tchrist@mox.perl.com, roderick@gate.net, doughera@lafcol.lafayette.edu,
>    perl5-porters@africa.nicoh.com
>Subject: Re: pod2man patch

[Fixes .bd command ]

perl 5.002gamma: pod/perlxstut.pod

>From okamoto@hpcc123.corp.hp.comSun Feb 11 21:28:55 1996
>Date: Fri, 9 Feb 1996 17:32:31 -0800
>From: Jeff Okamoto <okamoto@hpcc123.corp.hp.com>
>To: perl5-porters@africa.nicoh.com
>Subject: Perlxstut, 2/9 version
>
>Here's the latest version.  It should address all the comments that were made
>in the last release.

>From Tim.Bunce@ig.co.ukSun Feb 11 21:29:11 1996
>Date: Sat, 10 Feb 1996 08:34:48 +0000
>From: Tim Bunce <Tim.Bunce@ig.co.uk>
>To: perl5-porters@africa.nicoh.com, okamoto@hpcc123.corp.hp.com
>Cc: doughera@lafcol.lafayette.edu
>Subject: Re: Perlxstut, 2/9 version

[Use Mytest instead of mytest -- reserve lower case for pragmas.]

Automagically updated.

Tie::Hash update.

pod2man-inspired cleanups.

[deprecate %OVERLOAD]

Chip Salzenberg writes:
>
> According to Paul Marquess:
> >  use vars qw($VERSION @ISA @EXPORT);
>
> It would be safe to add @EXPORT_OK, @EXPORT_FAIL, %EXPORT_TAGS, and
> %OVERLOAD.

You remind me ;-)

tied() documentation

Here's some documentation for tied(), there doesn't seem to be any in
2b3.  Also included is a small comment in the FIRSTKEY() hash example of
perltie.pod, I had to look twice when I first saw the code and I thought
others might benefit from the explanation.

Tie::Hash patch.

Yet another try at HPUX and DGUX getpgrp() vs. getpgrp2().

Re: Beta3: Fix for SEGV on deep nesting

Change message to 'gamma'.

Here's a "gamma safe" patch.

OS/2 updates.

Beta3/Gamma: URGENT patch for integerized comparisons [edited]

[next note is from Andy]
[ This didn't apply cleanly to my source.  If I delete the (int)
casts in the first part of the patch, it does apply cleanly.  I worry
about that a little, but I put in the patch anyway. --AD ]

Changed newsgroup name to comp.lang.perl.misc.

perl 5.002gamma: miniperlmain.c

Moved function to util.c  It was C++ unfriendly and probably
didn't need to be here anyway.  (When it was just a small 2 or 3
liner, it made sense . . . ).

perl 5.002gamma: mg.c

>From salzench@dun.nielsen.comSat Feb  3 15:17:03 1996
>Date: Sat, 3 Feb 1996 12:43:39 -0500 (EST)
>From: Chip Salzenberg <salzench@dun.nielsen.com>
>Reply to: chip@atlantic.net
>To: Perl 5 Porters <perl5-porters@africa.nicoh.com>
>Subject: Beta3: Possible typo in sv_unmagic() [edited]

>From salzench@dun.nielsen.comTue Feb  6 09:45:25 1996
>Date: Mon, 5 Feb 1996 00:09:09 -0500 (EST)
>From: Chip Salzenberg <salzench@dun.nielsen.com>
>Reply to: chip@atlantic.net
>To: Perl 5 Porters <perl5-porters@africa.nicoh.com>
>Subject: Beta3: Fix for 2nd magic SEGV

>From lwall@sems.comWed Feb  7 09:10:55 1996
>Date: Tue, 06 Feb 96 14:52:41 -0800
>From: Larry Wall <lwall@sems.com>
>To: perl5-porters@africa.nicoh.com
>Subject: study still busted

>The study itself work fine, but if you modify the string, it still thinks
>it is studied.  In some ways this is worse than study not working at all,
>as it did (or rather didn't) before.  Here's the test case:

Updated to match newer Getopt::Long.

Re: Debugger in beta3

Fix ) in wrong spot for VMS.

Documentation patch: Tie::Hash, Tie::Scalar, Tie::SubstrHash

[This finishes a job started by Randy Ray with perl5.002b1f.]

This patch updates the files lib/TieHash.pm and lib/SubstrHash.pm. Those
two files are moved to a new directory called lib/Tie. A new tie-related
class for scalars, lib/Tie/Scalar.pm, is added. Each of these has pod
documentation that passes through pod2man without complaint. All package
names are updated to reflect this structure, and the "standard" sub-classes
for hashes and scalars are named Tie::StdHash and Tie::StdScalar, in
keeping with the group consensus.

With this, the documentation for Tie::Hash should be fine, Tie::Scalar
exists and is documented, and Tie::SubstrHash (formerly just SubstrHash)
is also documented, albeit weakly. I have no examples of usage to show, and
I suspect a possible bug or two, but without examples it's hard to say.

As it happens, this patch also impacts the DBM-style extensions, as they
(DB_File, NDBM_File, GBM_File, ODBM_File, SDBM_File) all inherited from
the old TieHash.pm as a base class.

Test-Harness breaks libwww-perl, Sorry

DATA filehandle not closed in Symbol.pm

[CORRECTION] Doc patches for Search::Dict and Sys::Syslog

perl 5.002gamma: lib/Pod/Functions.pm

This moved from pod/PerlDoc/Functions.pm.  It's used by the buildtoc
script, and might be used by a future html2pod script.  Or not.  It
needed a home somewhere, and Pod::Functions.pm seemed sensible.

perl 5.002gamma: lib/Getopt/Long.pm

I have replaced the version in 5.002 beta 3 with GetoptLong-2.1.
This has some nice new features and has been extensively tested.

beta3 File::Path warning fix

The following patch fixes a warning from File::Path.  Apply over beta3.

New file, part of MakeMaker-5.21 upgrade.

xsubpp 1.933 patch

perl 5.002gamma: lib/ExtUtils/MakeMaker.pm

Updated for MakeMaker 5.21.  This version handles local customization
of installation directories in a much easier-to-manipulate manner.
This is an important improvement and made it worthwhile to upgrade
from the version in 5.002 beta 3.

New file, part of MakeMaker 5.21.

Updated for MakeMaker 5.21.

New file.  Part of MakeMaker 5.21.

Make note about numerical version numbers. (Part of mm 5.21 patch)

Autoloadwarnings

Here is a correction for autoloader. Note that one cannot
use vars '$package::var';
, alas.

installman patch: Dont remove manpages unless the new one is good

Fix 2 installman bugs:
* If the old manpage existed, it was removed even if $pod2man failed.
* If installman aborted, an incomplete manpage was left in $MANPATH.

perl 5.002gamma: hints/sunos_4_1.sh

Add comment at tzname.

Add -DSTRUCT_TM_HASZONE flag for POSIX.

perl 5.002gamma: hints/solaris_2.sh

Turn off bcmp & friends.

Delete apparently unnecessary -x486 comment.

perl 5.002gamma: hints/sco.sh

On recent versions, at least, no warnings is -w0, not -W0.

Remove libdl.so from libswanted since it doesn't mix well with
archive libraries, at least by default.

perl 5.002gamma: hints/os2.sh

Updated.  I've deleted many of the apparently-no-longer-necessary
commented-out items.

New file.

perl 5.002gamma: hints/machten.sh

This version is specific to machten 4.X.  2.x.x has moved to its
own hint file.

perl 5.002gamma: hints/linux.sh

Remove d_dosuid configurable option from hint file.  There's no universal
right value.

More info on NDBM_File hang-up.

Allow Configure to look for libndbm.

perl 5.002gamma: hints/freebsd.sh

Remove d_dosuid configurable option from hint file.  There's no universal
right value.

Some updates.

Old habits die hard :-)

Part of the MakeMaker 5.21 update.

perl 5.002gamma: ext/Safe/Safe.xs

Added +1 to maxo at Malcom's suggestion.  AIX will probably stil
get bad free().

VERSION Patch

TieHash -> Tie::Hash

Re: NETaa14816: tzname[] and SunOS - Here's a patch

VERSION Patch

TieHash -> Tie::Hash Patch.

perl 5.002gamma: ext/FileHandle/FileHandle.xs

Allow compilation even if f[sg]etpos not available.

Allow compilation even if setvbuf() is not available.

perl 5.002gamma: ext/FileHandle/FileHandle.pm

>From pmarquess@bfsec.bt.co.ukTue Feb  6 09:38:27 1996
>Date: Tue, 6 Feb 96 14:09:49 GMT
>From: Paul Marquess <pmarquess@bfsec.bt.co.uk>
>To: perl5-porters@africa.nicoh.com
>Cc: pmarquess@bfsec.bt.co.uk
>Subject: VERSION Patch

>From chip@atlantic.netTue Feb  6 12:14:01 1996
>Date: Tue, 6 Feb 1996 12:03:43 -0500 (EST)
>From: Chip Salzenberg <chip@atlantic.net>
>To: andreas.koenig@mind.de
>Cc: perl5-porters@africa.nicoh.com
>Subject: Beta3: Allow 'use FileHandle' in miniperl

VMS-specific patch.

Change comp.lang.perl to comp.lang.perl.misc.

VERSION Patch

VERSION Patch

TieHash -> Tie::Hash

Regenerated.

Updated to version 1.20.

TMPFILE support

Currently on DOSISH machines a -e line with a syntax error results in
persisting pl234523 tmpfile. The patch below:

a) Cleans up the cleanup code;
b) Moves the TMPPATH specifics to header files.

I do not send patches for OS/2 files, since they are very much
reworked now, I only note that b) allows OS/2 startup to specify
TMPPATH to look to a $ENV{TMP} directory (instead of the current
directory, as it is now). Note that this allows now running -e perl
from read-only media.

Since there is no place now to have DOSISH _code_, as opposed to
_headers_, I leave the TMPPATH code on ./os2/os2.c, though it should
be common to DOS as well.

Enjoy,
Ilya

Inplace editing broken if DOSISH

perl 5.002gamma: configure

Add explicit call to 'sh'.  This appears to keep the x2p/Makefile.SH
extraction from clobbering the main Makefile on Linux.

perl 5.002gamma: config_h.SH

Delete the VMS and UNLINK_ALL_VERSIONS defines.

Some parts are rearranged.

Updated to match current Configure.

perl 5.002gamma: Makefile.SH

Include the proper -Ilib for miniperl test.

Use ./miniperl in case user doesn't have '.' in PATH.

Updated.

Add a few more notes about use of extensions across multiple versions.

perl 5.002gamma: Configure

Remove d_vms and d_unlnkallvers constants.  These should be set
in vmsish.h (and optionally undef'd in unixish.h, dosish.h).

Send the &-d info to >&4 so you see it even with -s.

Update unixism comments.

Introduce new nm_so_opt variable that holds options that might be
required for use with nm on shared libraries but that are fatal
if used on archive libraries.

Move suid question closer to top.  This also shuffled a few other
units.

Start varargs testing script with $startsh.

Start O_NONBLOCK testing script with $startsh.

Detect OS/2 early on.

perl 5.002gamma: [patch introduction and re-organisations]

[ re-organisations:

# Give this module a sensible home.
mv pod/PerlDoc/Functions.pm lib/Pod/Functions.pm
rmdir pod/PerlDoc

# Tie:: finally has its own hierarchy
mkdir lib/Tie
mv lib/TieHash.pm lib/Tie/Hash.pm
mv lib/SubstrHash.pm lib/Tie/SubstrHash.pm

rm -f lib/FileHandle.pm    # Duplicate of ext/FileHandle/FileHandle.pm
rm -f os2/diff.MANIFEST    # Obsolete (I applied a variant of it.)
rm -f os2/diff.init        # Obsolete.

]

This is patch.2gamma to perl5.002 beta3.
This takes you from 5.002beta3 to 5.002gamma.

To apply this patch, run the above commands, then
cd to your perl source directory and then type

        patch -p1 -N < patch.2gamma

The changes are described after each /^Index/ line below.  This is
designed so you can examine each change with a command such as

        csplit -k patch.2gamma '/^Index:/' '{99}'

(Of course since there are 116 items and most csplit's have an
arbitrary limit of 100 files, you'll probably have to manually split
this file first, but you get the idea.  (GNU csplit doesn't have this
limitation.  Nor does a perl solution, of course.))

Patch and enjoy,

    Andy Dougherty              doughera@lafcol.lafayette.edu
    Dept. of Physics
    Lafayette College, Easton PA 18042