perl-modperl-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/api/APR PerlIO.pod
Date Tue, 08 Apr 2003 02:11:46 GMT
stas        2003/04/07 19:11:46

  Modified:    src/docs/2.0/api/APR PerlIO.pod
  Log:
  document the addition of APR::PerlIO::PERLIO_LAYERS_ARE_ENABLED
  
  Revision  Changes    Path
  1.2       +25 -8     modperl-docs/src/docs/2.0/api/APR/PerlIO.pod
  
  Index: PerlIO.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/PerlIO.pod,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- PerlIO.pod	27 Jan 2003 04:05:12 -0000	1.1
  +++ PerlIO.pod	8 Apr 2003 02:11:46 -0000	1.2
  @@ -9,6 +9,9 @@
     sub handler {
         my $r = shift;
     
  +      die "This Perl build doesn't support PerlIO layers"
  +          unless APR::PerlIO::PERLIO_LAYERS_ARE_ENABLED;
  +  
         open my $fh, ">:APR", $filename, $r or die $!;
         # work with $fh as normal $fh
         close $fh;
  @@ -29,13 +32,25 @@
   mod_perl functions will return a filehandle which is internally hooked
   to APR. But you can use APR Perl IO directly if you want.
   
  -=head1 METHODS
  +=head1 Constants
   
  -Perl Interface:
  +=head2 PERLIO_LAYERS_ARE_ENABLED
  +
  +Before using the Perl IO APR layer one has to check whether it's
  +supported by the used perl build.
  +
  +  die "This Perl build doesn't support PerlIO layers"
  +      unless APR::PerlIO::PERLIO_LAYERS_ARE_ENABLED;
   
  -=over
  +Notice that loading C<APR::PerlIO> won't fail when Perl IO layers
  +aren't available since C<APR::PerlIO provides functionality for Perl
  +builds not supporting Perl IO layers.
   
  -=item open()
  +=head1 API
  +
  +Perl Interface:
  +
  +=head2 open()
   
   To use APR Perl IO to open a file the four arguments open() should be
   used. For example:
  @@ -55,7 +70,7 @@
   the rest of the arguments are the same as described by the I<open()>
   manpage.
   
  -=item seek()
  +=head2 seek()
   
     seek($fh, $offset, $whence);
   
  @@ -69,10 +84,12 @@
   To solve the problem, rebuild Perl with C<-Uuselargefiles>. Currently
   there is no way to force APR to build with large files support.
   
  -=back
  +=head1 C API
  +
  +The C API provides functions to convert between Perl IO and APR Perl
  +IO filehandles.
   
  -The C interface provides functions to convert between Perl IO and
  -APR Perl IO filehandles.
  +META: document these
   
   =head1 SEE ALSO
   
  
  
  

Mime
View raw message