Extending and Embedding Perl Source Code
========================================

These directories include the worked examples from the book _Extending
and Embedding Perl_ by Tim Jenness and Simon Cozens and published by
Manning Publications [http://www.manning.com/jenness]

The source code is arranged by chapter with each chapter
containing directories named after the book section in which
the example appeared. Only working examples are presented.
Code which is deliberately broken to demonstrate a common
problem is not included. 

Chapter 1 - C for Perl programmers

  Source code is provided for standalone listings.

Chapter 2 - Extending Perl: An Introduction

  Source code is included for all examples

Chapter 3 - Advanced C

  Source code is provided for standalone listings.

Chapter 4 - Perl's variable types

  Most of the examples in this chapter are Perl one-liners.
  Source code to complete programs is included.

Chapter 5 - The Perl5 API

  The examples in this chapter are all either from the Perl 
  source code or from Apache. This distribution does not
  duplicate those excerpts. Please go to the original source.

Chapter 6 - Advanced XS programming

  Source code is included for all examples.

Chapter 7 - Alternatives to XS

  Source code is included for all examples.

Chapter 8 - Embedding Perl in C

  Source code is included for all examples. [available soon]

Chapter 9 - Embedding case study.

  A copy of the mutt source code used for the embedding example in
  chapter 9 is included for completeness and because the URL for the
  mutt source presented in the book on page 269 has changed since
  publication and is now:

     ftp://ftp.mutt.org/mutt/historic/mutt-1.3.24i.tar.gz

  [patches available soon]

Chapter 10 - Introduction to Perl internals

  This chapter does not include any worked examples.

Chapter 11 - Hacking Perl

  This chapter does not include any worked examples

Appendix A - Perl's typemaps

  All the code from this chapter can be found in the XS::Typemap
  module that is distributed with perl 5.8.0


Copyright
---------

All the source code in this distribution is copyright (C) 2002
Tim Jenness and Simon Cozens. All Rights Reserved.

History
-------

Please contact the authors via the Author Online site if you
find problems with the source code in this distribution
and we will make a new release.

  2002-09-27  Initial release. 95% complete. Missing code
              examples from chapters 8 and 9

  
