perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/user/porting compat.pod
Date Sun, 04 Jul 2004 17:09:26 GMT
stas        2004/07/04 10:09:26

  Modified:    src/docs/2.0/user/porting compat.pod
  Log:
  - document the removed Apache::File->new()
  - add the new idiom to slurp the contents of the file
  
  Revision  Changes    Path
  1.52      +19 -3     modperl-docs/src/docs/2.0/user/porting/compat.pod
  
  Index: compat.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/porting/compat.pod,v
  retrieving revision 1.51
  retrieving revision 1.52
  diff -u -u -r1.51 -r1.52
  --- compat.pod	2 Jul 2004 23:17:53 -0000	1.51
  +++ compat.pod	4 Jul 2004 17:09:26 -0000	1.52
  @@ -1185,11 +1185,27 @@
   The methods from mod_perl 1.0's module C<Apache::File> have been
   either moved to other packages or removed.
   
  -=head2 C<open()> and C<close()>
   
  -The methods C<open()> and C<close()> were removed. See the back
  -compatibility implementation in the module
  +=head2 C<new()>, C<open()> and C<close()>
  +
  +The methods C<new()>, C<open()> and C<close()> were removed. See the
  +back compatibility implementation in the module
   C<L<Apache::compat|docs::2.0::api::Apache::compat>>.
  +
  +Because of that some of the idioms have changes too. If previously you
  +were writing:
  +
  +    my $fh = Apache::File->new($r->filename)
  +        or return Apache::DECLINED;
  +    # Slurp the file (hopefully it's not too big).
  +    my $content = do { local $/; <$fh> };
  +    close $fh;
  +
  +Now, you would write that as:
  +
  +  use Apache::RequestUtil ();
  +  $content = $r->slurp_filename();
  +
   
   =head2 C<tmpfile()>
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message