Author: joes
Date: Sat Feb 5 06:03:11 2011
New Revision: 1067397
URL: http://svn.apache.org/viewvc?rev=1067397&view=rev
Log:
thoughts
Modified:
httpd/apreq/trunk/glue/perl/lib/APR/Request/Magic.pm
Modified: httpd/apreq/trunk/glue/perl/lib/APR/Request/Magic.pm
URL:
http://svn.apache.org/viewvc/httpd/apreq/trunk/glue/perl/lib/APR/Request/Magic.pm?rev=1067397&r1=1067396&r2=1067397&view=diff
==============================================================================
--- httpd/apreq/trunk/glue/perl/lib/APR/Request/Magic.pm (original)
+++ httpd/apreq/trunk/glue/perl/lib/APR/Request/Magic.pm Sat Feb 5 06:03:11
2011
@@ -17,3 +17,19 @@ else {
}
1;
+
+# Notes:
+#
+# 1) module authors should accept an APR::Request object in their
+# args to new() instead of pulling out an apreq handle internally.
+# the reason is that in a cgi context you'll need to share the
+# pool with your users if they are to use apreq outside of your module,
+# which is probably more trouble than it's worth.
+#
+# 2) the way to use this module is trivial:
+#
+# use APR::Request::Magic;
+#
+# my $apreq_ctx = APR::Request::Magic->new;
+# my $apreq_handle =
$apreq_ctx->handle(@typical_args_without_the_first_one);
+# # do stuff with $apreq_handle which is an APR::Request object
