XS Example README

This is a very basic example of a Perl extension - the only thing it can do is print a message. See the emb* examples for more tricks.

For a broad variety of ways to pass function parameters in and out between C and Perl, see the literature below.

References & credits:

`man perlembed`
`man perlxstut`
`man perlxs`
`man perlguts`
"Advanced Perl Programming", "Programming Perl", "Perl in a Nutshell", "Perl Cookbook" - all four from O'Reilly & Associates
the sources of Perl 5.005_03 and Perl 5.6.1, in particular ext/Thread/Thread.c (Damn. 5.8.0 is out just now - gotta take a look.)
`man gcc`
USENET newsgroups - several hints on how to compile Perl using a C++ compiler, what to do about -DBOOL=char, how to avoid the assert redefinition warning etc.