httpd-apreq-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j...@apache.org
Subject svn commit: r1067397 - /httpd/apreq/trunk/glue/perl/lib/APR/Request/Magic.pm
Date Sat, 05 Feb 2011 06:03:11 GMT
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



Mime
View raw message