Make $FH no longer a global

This is lying of course. It's now in the global $self->{FH},
but this is still the first step to fix its globalness.

Fix some error messages

Error handling/message improvements

- Move line number calculation to separate method
- Make death/Warn/blurt proper methods
  They pretended to be methods all along, but never were.
- Pass XS file name and line no. to typemap parser
  ... for better error messages from the typemap parser in
  case of embedded typemaps

Allow overriding line numbers and files while parsing strings

When parsing typemaps from strings, we used to print in-string
line numbers and <string> as the file name. In case of embedded
typemaps in XS code, we really want to refer back to the line
number and name of the XS file. This is now possible.

Support for embedded typemaps in XS

This implements embedded typemap documents with a heredoc-like
syntax. In your XS, use a block like the following:

TYPEMAP: <<END
Foo* T_SOMETHING

INPUT
T_SOMETHING
code
END

Update docs and exports to be in line with reality

check_conditional_preprocessor_statements is not a method

Also, lose some unsightly undef()s.

Make get_alias (nee GetAlias) a method

Make print_section a method

As with previous changes, checking whether a localization of $_ or
something along those lines is acceptable remains to be done.

Transform FOO_handlers to methods

More methods (merge_section)

Make PushXSStack a method

Transform some functions into methods on the proto-object

Some simple tests for errors

Better error checking/handling

Eliminate four unsightly magical hash refs

Previously, we'd be generating and passing around four lookup tables for
C-type to XS-type (type kind), C-type to prototype, XS-type to input map
code, and XS-type to output map code. This is now all handled by
ExtUtils::Typemaps.

Make trailing whitespace a newline at all times

use warnings

Make get_(in|out)putmap more flexible

They now also accept ctypes which are resolved to xstypes via the
typemap section.

Add targetable method

This does the same thing for a simple output map as the make_targetable
function in ExtUtils::ParseXS::Utilities does for all output maps. The
latter function is intended to be superseded by this new method.

Add comment explaining where terrible code comes from

... and it is not brought by the stork.

Document inception of EU::Typemaps

Bless singleton

Nah, implicit is bad

Lose now obsolete process_single_typemap()

This was the actual typemap parser. It is now parsed by
ExtUtils::Typemaps, so we don't need it any more!

Make ExtUtils::ParseXS use ExtUtils::Typemaps

This is just the quick'n'dirty conversion to make it use
EU::Typemaps. Eventually, we want to use it in its full object-oriented
goodness!

Do not use Carp, fix propagation of replace/skip

Using Carp in a module this early in the toolchain can cause ugly
failure. Carp can trigger loading overload. overload::StrVal can trigger
loading Scalar::Util. Scalar::Util::PP requires B. miniperl doesn't like
loading shared libraries.

This problem with Carp just shadowed the underlying problem that the
replace/skip options weren't propagated correctly.

Defer loading main module

More whitespace bug-compatibility

More compatibility testing

Add test of EU::Typemap output against old ParseXS code

This is testing for string equivalency, not code equivalency. But it's
better than nothing.

More bug-compatibility with old ExtUtils::ParseXS

Reinstate prototype default and warning about invalid prototypes

Add method to get ANSIfied code

This is done to all of the code in EU::PXS anyway, so why not
have a nice method for it?

Implement 'skip' option for merging typemaps

This implements the 'first come first serve' style merging that
ExtUtils::ParseXS currently does: It prefers the typemap entries that
exist already over new ones. This is because the order of processed
typemaps is such that the default typemaps come last.

Implement 'replace' option when merging typemaps

And by proxy, this had to be implemented in the three add_* methods.
Also adds more tests for merging with conflicts.

Allow merging typemaps from file

Add method to generate the prototype lookup hash

Akin to the methods in the parent commit that generate the lookup hash
for TYPEMAP/INPUT/OUTPUT, this method will generate the lookup has for
typemap's prototypes as required by ExtUtils::ParseXS at this time.

Methods to get typemaps in ParseXS compatible format

Essentially, these extra methods export the typemap information in the
format expected by ExtUtils::ParseXS at this time. Down the road, we may
want EU::PXS to simply pass around an ExtUtils::Typemaps object.

Reduce code duplication by using the same prototype regexp

Teach EU::Typemaps about the _ prototype

I am in a hurry and this makes things correct, but really, this should
maybe use EU::ParseXS' regular expression.

Bump ExtUtils::Typemaps version

Just to make sure there really will never be a confusion or
collision with the similarly named module that has been living
on CPAN.

Simplify "remove" logic after previous refactoring

Hash lookup for output sections

More O(1) for everyone.
Also fixes a tiny issue with an error message from the inputmap
conversion.

Convert input sections to hash lookup

Die, O(n), die!

Start refactoring EU::Typemaps

Use a hash lookup for avoiding collisions.

Remove note about being untested

This code is actually in production use.

update copyright

Add a trailing 's' to the name of EU::Typemap

This is to prevent collisions on case-insensitive file systems with
lib/typemap.

Extract typemap-related code from ExtUtils::ParseXS

This was available from CPAN a while ago. The plan is to use it to make
the typemap parsing and manipulation saner and rip the parser from
ExtUtils::ParseXS' dead claws.

Cleanup of make_targetable

Fix function name in documentation

Remove unnecessary Data::Dumper loading

Revert "Revert "Moved prototype check to XS code, allowing the .pm file change from yesterday""

This reverts commit cf8fc7eed929846d31d02d565b4d5f4480a18d69,
reinstating the move of the prototype check to XS code.

Start documenting the EU::ParseXS changes

Documentation: maintainers & copyright

Adding Jim Keenan and myself to the list of maintainers. Sorry, Jim!
Update copyright and prettify a note.

Documentation fix

Be more precise about the return values of process_typemaps().

Rename some ExtUtils::ParseXS 'constants'

Make them have properly descriptive, camel case names.

Reapply the patch that tought EU::ParseXS about _ protos

Even including a test!

Ignore new ExtUtils::ParseXS files in lib

Re-apply ExtUtils::ParseXS portion of 1e8125c62127

Which had to be reverted as 634b52b92f42a6bb93c549
for a big rebase.

Re-apply typo fixes from c4a6f826b3676d1fdbd99

These had to be reverted for the ExtUtils::ParseXS rebase of Jim
Keenan's strictification work.

Originally reverted as 8e19e0c1f155990dc120199.

Re-apply EU::ParseXS portion of c33e8be1506a75e

This is the unused-arg stuff in tests.
Originally reverted as 836ae07757f3a1a32212.

A bit more documentation of make_targetable().

Add documentation on the hashrefs produced by process_typemaps().

Add documentation and additional tests

... exploring relationship between typemaps and \%targetable.

Mostly adding tests and documentation.

Rename sub print_preprocessor_statements() to
analyze_preprocessor_statements().  Modify interface to map_type() and
re-work tests as needed.  Wrote documentation in Utilities.pm for
process_single_typemap(), map_type(), standard_XS_defs(),
assign_func_args(), analyze_preprocessor_statements().  Write tests
in t/109-standard_XS_defs.t, t/110-assign_func_args.t.

Move several functions to Utilities.pm

Namely: check_conditional_preprocessor_statements(), Warn(),
blurt() and death() to Utilities.pm.

Add file to test blurt, death and Warn.  (death() is not
really testable yet due to hard-coded 'exit'.)  ovid++, rjbs++,
xdg+++ for assistance in developing tests."

Change check_cpp() to check_conditional_preprocessor_statements()

... to be more self-documenting.

Also: Explicitly pass $self to Warn(), blurt() and death().
Add skeletons of files to test functions moved (or planned to be
moved) to Utilities.pm.

Was able to move $Packid into $self.

Note that I got build failures when I attempted to pull $Package into $self.

The distributions below because during various 'eval EXPR'
statements, I got a 'Global variable $Package ...' error.

cut -d '/' -f 7,8,9,10,11 research/problematic.builds.20100410.txt
D/DB/DBURDICK/BoostGraph/Boost-Graph-1.4.tar.gz
D/DE/DEEMON/Crypt-OpenSSL-SMIME-0.02.tar.gz
D/DL/DLOWE/Text-Tmpl-0.33.tar.gz
D/DM/DMAKI/Data-Valve-0.00010.tar.gz
D/DO/DORMANDO/Perlbal-XS-HTTPHeaders-0.20.tar.gz
E/ED/EDPRATOMO/Algorithm-Permute-0.12.tar.gz
J/JH/JHI/String-Approx-3.26.tar.gz
K/KA/KARMAN/Search-Tools-0.45.tar.gz
K/KI/KILINRAX/HTML-Strip-1.06.tar.gz
L/LA/LAIRDM/Algorithm-SVM-0.13.tar.gz
M/MA/MARKSMITH/HTTP-HeaderParser-XS-0.20.tar.gz
M/MC/MCEGLOWS/Search-ContextGraph-0.15.tar.gz
M/MH/MHX/Convert-Binary-C-0.74.tar.gz
M/MH/MHX/Tie-Hash-Indexed-0.05.tar.gz
M/MI/MIKEWONG/Table-ParentChild-0.05.tar.gz
M/MS/MSERGEANT/CDB_File-0.96.tar.gz
M/MS/MSERGEANT/IO-KQueue-0.34.tar.gz
P/PA/PAJAS/XML-LibXML-1.70.tar.gz
P/PM/PMQS/Filter-1.37.tar.gz
S/SA/SALVA/Compress-PPMd-0.11.tar.gz
S/SA/SAPER/Net-Pcap-0.16.tar.gz
S/SA/SAPER/Net-RawIP-0.25.tar.gz
S/SG/SGOELDNER/MonetDB-CLI-MapiXS-0.03.tar.gz
S/SM/SMUELLER/Math-SymbolicX-FastEvaluator-0.01.tar.gz
S/SM/SMUELLER/Parse-ExuberantCTags-1.01.tar.gz
S/SP/SPIDB/Net-ext-1.011.tar.gz
T/TJ/TJMATHER/Crypt-OpenSSL-DSA-0.13.tar.gz

Refactor some code into sub set_cond()

Eliminate instances of calling subs with '&'.

Add vim modeline entries.

Move sub print_preprocessor_statements() into Utilities.pm.

Refactor some code into sub assign_func_args().

Don't have to undef if it's never been assigned to.

Move several variables found inside the PARAGRAPH loop

... closer to the point where each is first used.

Move $orig_args closer to where it's used

Move $prepush_done closer to where it's used

Move $func_header inside while loop closer to where it's used

Move two heredocs into Utilities::standard_XS_defs().

Change @outlist and %only_C_inlist into corresponding references

... in anticipation of upcoming refactorings,

Add messages to 3 tests which lacked them.

Move 4 elements in %args into $self

It was not yet possible to move $args{'s'} into $self because
of a quotemeta problem.

No evident need for 'for' loop in assignment from $args{filename}.

Explicitly pass $self to check_cpp()

Also explicitly return $self from print_preprocessor_statements().

Refactor code inside process_file() into print_preprocessor_statements()

Change \@BootCode to $BootCode_ref

to facilitate more refactoring of code into (somewhat) encapsulated
subs.

Eliminate some synthetic variables

and move declarations of some lexicals closer to the point where
they are actually used.

Typographical cleanup

Mostly elimination of trailing whitespace.

Add $newXS to $self

Keeping fingers crossed!

Move $proto into $self;

Add $Module_cname to $self.

Move %defaults to $self.

Move @line to $self.

Move @line_no, @Attributes, %outargs, @XSStack to $self.

Move %lengthof, %XsubAliases, %XsubAliasValues, %Interfaces.

To do: Eliminate confusion between these attributes: interface
(scalar) interfaces (scalar) Interfaces (hash)

Add \%in_out and \%argtype_seen to $self.

Move 9 'our' hashes and arrays into $self

For now, bypassing \@line, \%defaults.

Move $var_num into $self.

Write inline comment explaining current status of 'our' variables.

Move $Interfaces into $self, but as $self->{interfaces}

... to avoid confusion with %Interfaces. (But note we already have
$self->{interface}. This will have to be fixed.)