Changes between Version 28 and Version 29 of ModParrotArchitecture

Timestamp:

11/30/08 20:07:56 (13 years ago)

Author:

jhorwitz

Comment:

--

ModParrotArchitecture

@@ -140 +140 @@
 This structure is used by Apache as the HLL module's configuration.  When configuration is requested by HLL code however, mod_parrot will return the {{{cfg}}} member.
 
-=== Metahandlers ===
+=== Hooks and Metahandlers ===
+
+Each HLL module can register a hook for each Apache phase.  It is not required to register a hook for every phase, though you must register at least one.
+
+Metahandlers are HLL-specific hooks that implement the semantics of that particular HLL module.  For example, mod_perl6 request phase handlers expect to receive an Apache::RequestRec object as the first argument.  The mod_perl6 metahandlers would be responsible for making sure that happens.
+
+Apache cannot call HLL code directly, so mod_parrot registers generic hook functions that call HLL code on its behalf.  These functions are in {{{src/mod_parrot.c}}} and have a {{{modparrot_meta_}}} prefix.
+
+For details on registering hooks and writing metahandlers, see the [wiki:ModParrotHLLDocs HLL module developer guide].
 
 === Tracking ===