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/compat compat.pod
Date Tue, 22 Jan 2002 16:37:40 GMT
stas        02/01/22 08:37:40

  Modified:    src/docs/2.0/user/compat compat.pod
  Log:
  - document the compatibility of method handlers (have to use sub
  attributes)
  
  Revision  Changes    Path
  1.7       +35 -0     modperl-docs/src/docs/2.0/user/compat/compat.pod
  
  Index: compat.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/compat/compat.pod,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- compat.pod	6 Jan 2002 17:57:24 -0000	1.6
  +++ compat.pod	22 Jan 2002 16:37:40 -0000	1.7
  @@ -90,6 +90,41 @@
   =head2 Apache::File
   
   
  +=head1 Miscellaneous
  +
  +=head2 Method Handlers
  +
  +In mod_perl 1.x the method handlers could be specified by using the
  +C<($$)> prototype:
  +
  +  package Bird;
  +  @ISA = qw(Eagle);
  +  
  +  sub handler ($$) {
  +      my($class, $r) = @_;
  +      ...;
  +  }
  +
  +Starting from Perl version 5.6 the subroutine attributes are used in
  +place of subroutine prototypes:
  +
  +  package Bird;
  +  @ISA = qw(Eagle);
  +  
  +  sub handler : method {
  +      my($class, $r) = @_;
  +      ...;
  +  }
  +
  +see the L<attributes> manpage for additional information on subroutine
  +attributes.
  +
  +mod_perl 2.0 doesn't support the C<($$)> prototypes, mainly because
  +several callbacks in 2.0 have more arguments than C<$r>, so the
  +C<($$)> prototype doesn't make sense anymore. Therefore if you want
  +your code to work with both mod_perl generations, you should use the
  +subroutine attributes.
  +
   
   =head1 Apache::Registry and Apache::PerlRun and Other mod_cgi Emulators
   
  
  
  

---------------------------------------------------------------------
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