Mailing-List: contact apreq-cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: apreq-dev@httpd.apache.org
Message-ID: <20051104150048.19149.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r330817 -
 /httpd/apreq/trunk/glue/perl/xsbuilder/APR/Request/Request.pod
Date: Fri, 04 Nov 2005 15:00:47 -0000
To: apreq-cvs@httpd.apache.org
From: joes@apache.org

Author: joes
Date: Fri Nov  4 07:00:45 2005
New Revision: 330817

URL: http://svn.apache.org/viewcvs?rev=330817&view=rev
Log:
document undef returns

Modified:
    httpd/apreq/trunk/glue/perl/xsbuilder/APR/Request/Request.pod

Modified: httpd/apreq/trunk/glue/perl/xsbuilder/APR/Request/Request.pod
URL: http://svn.apache.org/viewcvs/httpd/apreq/trunk/glue/perl/xsbuilder/APR/Request/Request.pod?rev=330817&r1=330816&r2=330817&view=diff
==============================================================================
--- httpd/apreq/trunk/glue/perl/xsbuilder/APR/Request/Request.pod (original)
+++ httpd/apreq/trunk/glue/perl/xsbuilder/APR/Request/Request.pod Fri Nov  4 07:00:45 2005
@@ -237,8 +237,8 @@
     $req->jar($key)
 
 With no arguments, this method returns a tied APR::Request::Cookie::Table
-object in scalar context, or the names (in order, with repetitions) of all
-the parsed cookies.
+object (or undef if the "Cookie" header is absent) in scalar context, or 
+the names (in order, with repetitions) of all the parsed cookies.
 
 With the C<$key> argument, in scalar context this method fetches the first
 matching cookie.  In list context it returns all matching cookies.
@@ -276,8 +276,8 @@
     $req->args($key)
 
 With no arguments, this method returns a tied APR::Request::Param::Table
-object in scalar context, or the names (in order, with repetitions) of all
-the parsed query-string arguments.
+object (or undef if the query string is absent) in scalar context, or the 
+names (in order, with repetitions) of all the parsed query-string arguments.
 
 With the C<$key> argument, in scalar context this method fetches the first
 matching query-string arg.  In list context it returns all matching args.
@@ -312,8 +312,8 @@
     $req->body($key)
 
 With no arguments, this method returns a tied APR::Request::Param::Table
-object in scalar context, or the names (in order, with repetitions) of all
-the parsed cookies.
+object (or undef if the request body is absent) in scalar context, or the 
+names (in order, with repetitions) of all the parsed cookies.
 
 With the C<$key> argument, in scalar context this method fetches the first
 matching body param.  In list context it returns all matching body params.
@@ -348,8 +348,9 @@
     $req->param($key)
 
 With no arguments, this method returns a tied APR::Request::Param::Table
-object in scalar context, or the names (in order, with repetitions) of all
-the incoming (args + body) params.
+object (or undef, if the query string and request body are absent) in scalar
+context, or the names (in order, with repetitions) of all the incoming
+(args + body) params.
 
 With the C<$key> argument, in scalar context this method fetches the first
 matching param.  In list context it returns all matching params.
@@ -384,8 +385,9 @@
     $req->upload($key)
 
 With no arguments, this method returns a tied APR::Request::Param::Table
-object in scalar context (whose entries are APR::Request::Param objects),
-or the names (in order, with repetitions) of all the incoming uploads.
+object (or undef if the request body is absent) in scalar context (whose
+entries are APR::Request::Param objects), or the names (in order, with 
+repetitions) of all the incoming uploads.
 
 With the C<$key> argument, in scalar context this method fetches the first
 matching upload.  In list context it returns all matching uploads.  The return