Author: joes
Date: Mon Jul 11 04:30:45 2005
New Revision: 210099
URL: http://svn.apache.org/viewcvs?rev=210099&view=rev
Log:
Formally drop support for table add/set/delete
methods in the Perl glue (technically these
were withdrawn in the 2.05-dev release, but
the docs failed to mention that).
Modified:
httpd/apreq/trunk/CHANGES
httpd/apreq/trunk/glue/perl/lib/Apache2/Request.pm
Modified: httpd/apreq/trunk/CHANGES
URL:
http://svn.apache.org/viewcvs/httpd/apreq/trunk/CHANGES?rev=210099&r1=210098&r2=210099&view=diff
==============================================================================
--- httpd/apreq/trunk/CHANGES (original)
+++ httpd/apreq/trunk/CHANGES Mon Jul 11 04:30:45 2005
@@ -4,6 +4,12 @@
@section v2_06 Changes with libapreq2-2.06
+
+- Perl API [joes]
+ Support for table set/add/delete methods is formally withdrawn.
+ Technically this feature died with the module API refactoring in
+ 2.05-dev.
+
- C API [max]
Right-hand limit of apreq_brigade_move() is declared as "excluding",
Modified: httpd/apreq/trunk/glue/perl/lib/Apache2/Request.pm
URL:
http://svn.apache.org/viewcvs/httpd/apreq/trunk/glue/perl/lib/Apache2/Request.pm?rev=210099&r1=210098&r2=210099&view=diff
==============================================================================
--- httpd/apreq/trunk/glue/perl/lib/Apache2/Request.pm (original)
+++ httpd/apreq/trunk/glue/perl/lib/Apache2/Request.pm Mon Jul 11 04:30:45 2005
@@ -495,27 +495,10 @@
This is easily addressed by preloading the modules during
server startup.
-=item * You must use the C<Apache2::Request::Table> API via
- C<< scalar $req->args >> or C<< scalar $req->body >>
- to assign new parameters to the request. You may
- no longer use the two-argument method calls; e.g.
-
- $req->param("foo" => "bar"); # NO: usage error in 2.X
- $req->args->{foo} = "bar"; # OK: assign to args table
- $req->body->add(foo => "bar"); # OK: add to body table
-
- $req->param->add(foo => "bar"); # NO: this is an expensive noop,
- # because the param table is
- # generated by overlaying $req->args
- # and $req->body.
-
- my $params = $req->param;
- $params->set(foo => "bar"); # OK: sets "foo" entry in $params, which
- # is a local (args + body) table. Neither
- # $req->args, $req->body, nor future
calls
- # to $req->param, are affected by mods to
- # $params.
-
+=item * You can no longer add (or set or delete) parameters in the
+ C<< scalar $req->param >>, C<< scalar $req->args >> or
+ C<< scalar $req->body >> tables. Nor can you add (or set or delete)
+ cookies in the C<< scalar $req->jar >> table.
=item * C<instance()> is now identical to C<new()>, and is now deprecated. It
may be removed from a future 2.X release.
