h2xs incorrectly treats enum values like macros

Patch and description by Rainer Weikusat, forwarded from
http://bugs.debian.org/502297 :

 The h2xs program scans C headers for 'constants' either defined
 as preprocessor macros or via enum and builds a sorted list of names
 containing the macros and enum values found in this way. This list
 is then passed to ExtUtils::Constant::WriteConstants, which generates
 the corresponding const-c.inc and const-xs.inc files when perl Makefile.PL
 is executed. By default, ie when just processing a constant name, this
 function assumes that the name refers to a preprocessor macro and
 the generated C-code in const-c.inc contains conditional compilation
 directives to either return the macro value or Perl_constant_NOTDEF,
 depending on the defined'ness of the macro. This causes constants
 defined as enumeration values to never be available to module users,
 because they are not visible to the preprocessor.

 Instead of passing just a name to the WriteConstants-routine, a
 hashref (members documented in ExtUtils::Constant::Base(3perl))
 can be used to specify more details regarding what code
 should be generated for a particular constant. For an enumeration
 value, a hashref constructed as

     { name => <name of the constant>, macro => 1 }

 could be used to get rid of the inappropriate preprocessor
 directives.

( Another version of the same fix was also submitted by Daniel Burr in
  http://bugs.debian.org/320286 )

Docs: Fixed a couple of [my] typos

I read through each my patches again and came across a typo,
a slight incorrectness, and a repeated word. Sorry.

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Update summary and add copyright

Yeah, well, I wrote some new stuff.

Docs: Expanded treatment of adding instance variables

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Clarify that a class is not an instance

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Minor modifications to discussion of constructor

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Make use of $self and $class clear

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Better orgnization of instance discussion

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Cleanup lead-in to instance variables

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Better[?] development of SUPER

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Get rid of those awful tabs!

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Quick explanation of duck typing and a warning

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Make the "use base" purpose more obvious

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Minor reorganization.

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Typo: 'no strict subs' -> 'no strict refs'

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Docs: Typo: \{-1} -> \g{-1}

Signed-off-by: Michael Witten <mfwitten@gmail.com>

Make h2ph look in "include-fixed", needed by at least gcc 4.3

As seen in <http://bugs.debian.org/522673>, since 4.2.0 or so
gcc's search path has a new "include-fixed" directory,
which currently contains <syslimits.h> and a few other headers.

Converting <syslimits.h> therefore fails unless h2ph knows about the new
directory too.

See http://gcc.gnu.org/ml/gcc-patches/2007-02/msg02038.html for some
background to the gcc change.

Deprecate assignment to $[

Based on a patch by James Mastros :

Subject: Deprecating $[
Message-ID: <abc933c50904020726x31776ab5m192036429af16f03@mail.gmail.com>

Remove libbsd/libBSD from wanted libs on AIX

Subject: libbsd on AIX
From: Rainer Tammer <tammer@tammer.net>
Date: Fri, 03 Apr 2009 11:59:18 +0200
Message-ID: <49D5DDF6.5050804@tammer.net>

In sdbm_open(), replace strcat()s and strcpy()s with memcpy()s.

Don't needlessly assign to pagname (which seems to make clang even happier).

Don't assign needlessly to dirname. (which seems to make clang happier.)

document PERL_SYS_INIT, PERL_SYS_TERM and that they should only be used once

Skip bug in new File::stat test.

-- index returns -1, not false when substring not found.

-- 2 tests in the block, not 1.

Sadahiro says that "first-come" should be preferred for Unicode::Normalize and Unicode::Collate

Remove the 5.005 threads details from the documentation for :locked and :method

Can't use inet_ntop and inet_pton under Cygwin because it doesn't fully implement IPv6 yet.

Close the file before renaming it. Problem spotted and fix supplied by corion.

Getopt::Long is maintained on CPAN

Upgrade to Getopt::Long 2.38

Don't create an empty Errno.pm if there is an error whilst running Errno_pm.PL
Implemented by initially writing to an temporary file name, and renaming as the
last act.

Note why we need a seemingly useless empty &Regexp::DESTROY

Avoid "Constant subroutine ... redefined" warning, spotted by Jerry D. Hedden.

Upgrade to CPANPLUS-Dist-Build-0.18.

TZ setting must contain an offset.

Per the standard at:

http://www.opengroup.org/onlinepubs/7990989775/xbd/envvar.html

Make references to the Glossary in Config.pm and Config.pod

Updates for ext/compress*

Document when as a syntax modifier

provide minimal documentation for the MUTABLE_*() macros

Merge commit 'origin/postfixwhen' into blead

Document that DESTROY is subject to AUTOLOAD, and the related optimisations.

Change Regexp::DESTROY to be a constant subroutine, removing XS_Regexp_DESTROY.
A constant subroutine is now optimised away at DESTROY time.

Change Perl_newCONSTSUB() so that a NULL sv generates an empty list return.
Don't call DESTROY if it's a constant subroutine.

In Perl_newCONSTSUB(), sv should not be NULL.

Update to Unicode::Normalize 1.03

1.03  Sun Mar 29 12:56:23 2009
  - mkheader: check if no composition needs growing the string.
  - Makefile.PL: a tweak

DB_File 1.820: Remove MAN3PODS => {}

Make Time::Piece use the init_tm() in util.c, bump to 1.13_03.

Jarkko put it there for that purpose back in e72cf795050cdfe9905e00270c38ba2547626581,
so we seem to be a little slow noticing.

The old broken method for determining whether we need to initialize a tm
struct in the absence of HAS_TM_TM_ZONE being available is preserved for
Perls prior to 5.8.0.

Don't call SvPV_const() on the method name at the top of method_common(), as it's not needed when the method is in the current stash (which happens quite often)

Don't COW PVFMs, as the IVX is now used for FmLINES. (since change 34134)

In Perl_sv_setsv_cow(), dstr can be NULL.

Allow when to be used as a statement modifier

Improve mro merging error messages.

This makes them very similar to those produced by Algorithm::C3.

Also skip test 20 in t/Socket.t when no IPv6 is available

Forgot one "static" in 7430375d1909c2b62c1fb3f9c6ed4b9d24dfcf32.

Fix concise-xs.t after recent changes to Socket.pm

Since concise-xs.t uses IO::Socket as a source for its testing, we need
to list correctly all function it exports.

Some standards compliance for the new Time::Piece test.

This is a follow-up to 036055ae9ae83cd5b00514419663540cb13fc21a.  Setting
TZ in the environment may or may not have any effect without calling tzset()
afterwards, and the %z format specifier for strftime() is not in the
standard (and was causing smoke failures in many places).

Merge commit 'mauzo/over-X' into blead

Add inet_pton and inet_ntop to the list of functions exported by Socket

What am I thinking?  Just bump the version.

Merge branch 'blead' of ssh://stevep@perl5.git.perl.org/gitroot/perl into blead

Add inet_pton() and inet_ntop() to Socket.

Remove unused function S_copy_big_TM_to_little_tm from time64.c.

Namespace clean-up for time64.

All of the time64 functions are only visible within pp_sys.c and are not
part of the public API, so make them all static and give them the S_ prefix.
A side effect of this is that we now unambiguously use S_localtime64_r and
S_gmtime64_r and should no longer collide with system-supplied versions, if
any.

One possible future direction is that if and when Configure detects any
system-supplied *time64_r functions, their prototypes, and their valid
time ranges, we could optionally select those instead of the home-grown
ones.

Another possible future direction is that we could s/S_/Perl_/ and make
the *time64_r functions part of the public API in some post-5.10.x
release.  Currently they are only exposed to the outside world via
Perl_pp_gmtime.

Also gave some TRACE macros more specific names.

The DOSish branch of File::stat->cando had its arguments wrong.

-ugk don't call string overload when S_IXXX isn't defined.

Ignore Makefile.PLs that are now autogenerated.

make_ext.pl's automatic Makefile.PL generation can write a suitalbe Makfile.PL

Undo the local change to Time::Piece's Makfile.PL that added MAN3PODS.

Remove MAN3PODS from modules' Makefile.PLs which are not the same as on CPAN.

Correct the path for IO - needs a trailing / to stop it matching IO-Compress

Remove MAN3PODS and NORECURS from Makefile.PLs where blead is canonical.

Remove now-redundant references to MAN3PODS in core modules' Makefile.PLs.

Simplify the file description for ext/threads

make_ext.pl should also set INSTALLMAN1DIR=none when running Makefile.PL

No need to set MAN3PODS now that make_ext.pl takes care of this for us.

make_ext.pl's automatic Makefile.PL generation can write these five for us.

fix smoke issues with the compression modules

[tweaked to add break; after each default; to make gcc happy]

-l was missing an SPAGAIN.

IO refs always stringify for -t, -T and -B.

Test -X overloads on GLOB and IO refs.

Docs for File::stat.

Bump File::stat's $VERSION.

I assume VMS doesn't have a superuser.

Warnings for File::stat deficiencies.

Reinstate File::stat::stat_cando.

Docs for -X overloading.

Tests for -X overload on File::stat.

I missed a s/stat_cando/cando/ in File::stat.

Stacked overloaded -X.

Test stacked overloaded -X.

Fall back to "" overload for -X.

More tests for -X/string/random overloading.

-M, -C, -A for File::stat.

Add -X overloading to File::stat.

Finish the rest of the -X ops.

Move magic logic into tryAMAGICftest macro.

Adjust tests.

Call -X magic from pp_ftread.

Tests for -X overloading.

Run overload.pl.