README
1
2
3ExtUtils::XSBuilder - Automatic XS glue code generation
4-------------------------------------------------------
5
6Copyright (c) 2000-2001 Doug MacEachern
7Copyright (c) 2001-2004 Gerald Richter / ecos gmbh (www.ecos.de)
8
9You may distribute under the terms of either the GNU General Public
10License or the Artistic License, as specified in the Perl README file.
11
12THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
13WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
14MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15
16$Id: README,v 1.4 2004/03/29 03:49:31 richter Exp $
17
18
19OVERVIEW
20========
21
22ExtUtils::XSBuilder is a set modules to parse C header files and create XS
23glue code and documentation out of it. Idealy this allows to "write" an
24interface to a C library without coding a line. Since no C-API is ideal,
25some adjuments are necessary most of the time. So to use this module you
26must still be familar with C and XS programming, but it removes a lot of
27stupid work and copy&paste from you. Also when the C API changes, most
28of the time you only have to rerun XSBuilder to get your new Perl API.
29
30
31INSTALLATION
32============
33
34
35perl Makefile.PL
36make install
37
38
39DOCUMENTATION
40=============
41
42XSBuilder.pod contains the documentation
43xsbuilder.osc2002.pod contains my slides from the O'Reilly
44 OpenSource Convention 2002
45
46AUTHOR
47======
48
49Doug MacEachern has written most of the code for mod_perl 2.0.
50G. Richter has genarlized the code to make it useable outside
51mod_perl.
52
53
54
55
56
57