Example #2 README

This is an example of how to include a statically linked extension into our proggie, with automatic bootstrap of the extension from within C space - so that Perl space user scripts don't have to explicitly `use' the extension, which they'd always have to otherwise, as long as they'd be intended to run in our custom embedded interpreter.

Also note that there's a Perl-space global named variable being initialized to hold the pointer to a C++ object - even before the user script is run.

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.