cvs commit: httpd-apreq/Request Request.pm

[jo...@apache.org]

joes        2003/08/23 11:48:19

  Modified:    .        Changes
               Request  Request.pm
  Log:
  Applied Steve Hay's doc patch to explain tempnam() dependence
  
  Revision  Changes    Path
  1.58      +5 -0      httpd-apreq/Changes
  
  Index: Changes
  ===================================================================
  RCS file: /home/cvs/httpd-apreq/Changes,v
  retrieving revision 1.57
  retrieving revision 1.58
  diff -u -r1.57 -r1.58
  --- Changes	10 Jul 2003 11:08:50 -0000	1.57
  +++ Changes	23 Aug 2003 18:48:19 -0000	1.58
  @@ -2,6 +2,11 @@
   
   =over 4
   
  +=item 1.24 - August 23, 2003
  +
  +Applied Steve Hay's Request.pm doc patch explaining the tempnam()
  +dependence for C<Apache::Request::new()>'s TEMP_DIR option.
  +
   =item 1.23 - July 10, 2003
   
   Applied Graham Clark's patch to cleanup apache_request.h macros.
  
  
  
  1.26      +13 -10    httpd-apreq/Request/Request.pm
  
  Index: Request.pm
  ===================================================================
  RCS file: /home/cvs/httpd-apreq/Request/Request.pm,v
  retrieving revision 1.25
  retrieving revision 1.26
  diff -u -r1.25 -r1.26
  --- Request.pm	10 Jul 2003 11:08:50 -0000	1.25
  +++ Request.pm	23 Aug 2003 18:48:19 -0000	1.26
  @@ -64,8 +64,6 @@
   
   =back
   
  -=over 4
  -
   =head2 new
   
   Create a new I<Apache::Request> object with an I<Apache> request_rec object:
  @@ -116,6 +114,17 @@
    my $upload = $apr->upload('file');
    $upload->link("/home/user/myfile") || warn "link failed: $!";
   
  +Note: The standard C library function C<tempnam()> is used to define the
  +file to be used, and it may well prefer to look for some other temporary
  +directory, specified by an environment variable in the environment of the
  +user that Apache is running as, in preference to the one passed to it.
  +For example, Microsoft's C<tempnam()> implementation will look for a TMP
  +environment variable first; glibc's version looks for TMPDIR first. The
  +TEMP_DIR specified here is generally only used if the relevant environment
  +variable is not set, or the directory specified by it does not exist.
  +Refer to your system's C library documentation for the full details on your
  +platform.
  +
   =item HOOK_DATA
   
   Extra configuration info passed to an upload hook.
  @@ -173,10 +182,10 @@
   It is called for you by the accessor methods, so it is not required but
   can be useful to provide a more user-friendly message should an error 
   occur:
  - 
  +
       my $r = shift;
       my $apr = Apache::Request->new($r); 
  - 
  +
       my $status = $apr->parse; 
       unless ($status == OK) { 
   	$apr->custom_response($status, $apr->notes("error-notes")); 
  @@ -238,8 +247,6 @@
   
       my $upload = $apr->upload($name);
   
  -=back
  -
   =head1 SUBCLASSING Apache::Request
   
   The Apache::Request class cannot be subclassed directly because its constructor
  @@ -302,8 +309,6 @@
   
   =head1 Apache::Upload METHODS
   
  -=over 4
  -
   =head2 name
   
   The name of the filefield parameter:
  @@ -386,8 +391,6 @@
   
   Typically the new name must lie on the same file system as the
   spool file. Check your system's link(2) manpage for details.
  -
  -=back
   
   =head1 SEE ALSO