ev::makemaker(3pm) [debian man page]

EV::MakeMaker(3pm)					User Contributed Perl Documentation					EV::MakeMaker(3pm)

NAME

       EV::MakeMaker - MakeMaker glue for the C-level EV API

SYNOPSIS

       This allows you to access some libevent functionality from other perl modules.

DESCRIPTION

       For optimal performance, hook into EV at the C-level.  You'll need to make changes to your "Makefile.PL" and add code to your "xs" / "c"
       file(s).

HOW TO

   Makefile.PL
	 use EV::MakeMaker qw(ev_args);

	 # ... set up %args ...

	 WriteMakefile (ev_args (%args));

   XS
	 #include "EVAPI.h"

	 BOOT:
	   I_EV_API ("YourModule");

API

       See the EVAPI.h <http://cvs.schmorp.de/EV/EV/EVAPI.h> header, which you should include instead of ev.h.

       In short, all the functions and macros from ev.h should work, except that the trailing underscore macros ("EV_A_", "EV_DEFAULT_") are not
       available (except "EV_P_" :).

       Multiplicity is enabled.

       The "data" member in each watcher is of type "SV *" and not "void *" (this might change at some point).

EXAMPLE

       The EV::Glib, EV::ADNS and Glib::EV modules all give nice examples on how to use this module.

       Here are some .xs fragments taken from EV::ADNS that should get you going:

	 #include "EVAPI.h"

	 static ev_prepare pw;
	 static ev_idle iw;

	 static void
	 idle_cb (EV_P_ ev_idle *w, int revents)
	 {
	   ev_idle_stop (EV_A, w);
	 }

	 MODULE = ...

	 BOOT:
	 {
	   I_EV_API ("EV::ADNS");
	   ev_prepare_init (&pw, prepare_cb);
	   ev_init (&iw, idle_cb); ev_set_priority (&iw, EV_MINPRI);
	   ev_idle_start (EV_DEFAULT, &iw);
	 }

perl v5.14.2							    2008-04-07							EV::MakeMaker(3pm)

Datum::MakeMaker(3pm)					User Contributed Perl Documentation				     Datum::MakeMaker(3pm)

NAME

       Carp::Datum::MakeMaker - Offer to strip Carp::Datum calls statically

SYNOPSIS

	# Put this at the top of the Makefile.PL for your module
	use ExtUtils::MakeMaker;       # you may omit this line
	use Carp::Datum::MakeMaker;

DESCRIPTION

       The "Carp::Datum::MakeMaker" module supersedes the regular WriteMakefile() routine of "ExtUtils::MakeMaker".

       When running the Makefile.PL from a module interactively, the user will be asked whether calls to "Carp::Datum" should be stripped at build
       time.

       By default, or when running non-interactively, most calls to Carp::Datum routines will be removed: the "datum_strip" program will be
       invoked to filter *.pm files during the build process.  This program is a mere wrapper for the datum_strip() routine, defined in
       "Carp::Datum::Strip".

       The only call that will not be stripped is the DTRACE() call.  However, it will be dynamically remapped to a "Log::Agent" call.	It cannot
       be statically remapped because of its baroque interface.

       At the top of Makefile.PL, insert

	   use Carp::Datum::MakeMaker;

       which will take care of loading "ExtUtils::MakeMaker".  Note that it makes sense to refer to this module, since "Carp::Datum" is being used
       internally, and therefore the user will not be able to install the module if they do not have "Carp::Datum" already installed.

       If you wish to be nicer about "Carp::Datum" not being installed, you can say instead:

	   use ExtUtils::MakeMaker;
	   eval "use Carp::Datum::MakeMaker;";

	   WriteMakefile(
	       'NAME'	   => "Your::module::name",
	       'PREREQ_PM' => {
		   'Carp::Datum'  => '0.100',
	       },
	   );

       It will allow them to run the Makefile.PL, and yet be reminded about the missing "Carp::Datum" module.  Chances are they won't be able to
       go much farther though...

AUTHORS

       Christophe Dehaudt and Raphael Manfredi are the original authors.

       Send bug reports, hints, tips, suggestions to Dave Hoover at <squirrel@cpan.org>.

SEE ALSO

       Carp::Datum::Strip(3), ExtUtils::MakeMaker(3).

perl v5.10.0							    2006-04-13						     Datum::MakeMaker(3pm)