Hi, Attached is a not applied patch that I already submitted a while ago. It fixes the description of HOOKS and there macros in the documentation. -- address: Covalent Technologies, 645 Howard St, San Francisco, CA - 94105 phone: +1-415-536-5221 fax:+1-415-536-5210 personal website: http://www.lisanza.net/--- ../httpd-2_0_16-orig/docs/manual/developer/hooks.html Wed Apr 4 05:45:37 2001 +++ docs/manual/developer/hooks.html Fri Apr 13 15:08:53 2001 @@ -34,13 +34,13 @@
Declare the hook function
-Use the DECLARE_HOOK macro, which needs to be given the name of the -hook, the return type of the hook function and the arguments. For +
Use the AP_DECLARE_HOOK macro, which needs to be given the return +type of the hook function, the name of the hook, and the arguments. For example, if the hook returns an int and takes a request_rec * and an int and is called "do_something", then declare it like this:
-DECLARE_HOOK(int,do_something,(request_rec *r,int n)) +AP_DECLARE_HOOK(int,do_something,(request_rec *r,int n))This should go in a header which modules will include if they want to use the hook.
@@ -52,8 +52,8 @@ declared as follows:
-HOOK_STRUCT(
- HOOK_LINK(do_something)
+APR_HOOK_STRUCT(
+ APR_HOOK_LINK(do_something)
...
)
@@ -70,7 +70,7 @@
If the return value of a hook is void, then all the hooks are called, and the caller is implemented like this:
-IMPLEMENT_HOOK_VOID(do_something,(request_rec *r,int +AP_IMPLEMENT_HOOK_VOID(do_something,(request_rec *r,int n),(r,n))The second and third arguments are the dummy argument declaration and @@ -90,7 +90,7 @@
If the hook returns a value, then it can either be run until the first hook that does something interesting, like so:
-IMPLEMENT_HOOK_RUN_FIRST(int,do_something,(request_rec *r,int n),(r,n),DECLINED) +AP_IMPLEMENT_HOOK_RUN_FIRST(int,do_something,(request_rec *r,int n),(r,n),DECLINED)The first hook that doesn't return DECLINED stops the loop and its return value is returned from the hook caller. Note @@ -104,7 +104,7 @@ those two stops the loop, and its return is the return value. Declare these like so:
-IMPLEMENT_HOOK_RUN_ALL(int,do_something,(request_rec *r,int +AP_IMPLEMENT_HOOK_RUN_ALL(int,do_something,(request_rec *r,int n),(r,n),OK,DECLINED)Again, OK and DECLINED are the traditional
