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/config config.pod
Date Tue, 13 Aug 2002 11:41:45 GMT
stas        2002/08/13 04:41:45

  Modified:    src/docs/2.0/user/config config.pod
  Log:
  remove irrelevant data from the config tables
  other minor reorgs
  
  Revision  Changes    Path
  1.21      +91 -58    modperl-docs/src/docs/2.0/user/config/config.pod
  
  Index: config.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/config.pod,v
  retrieving revision 1.20
  retrieving revision 1.21
  diff -u -r1.20 -r1.21
  --- config.pod	12 Jul 2002 09:55:54 -0000	1.20
  +++ config.pod	13 Aug 2002 11:41:45 -0000	1.21
  @@ -645,72 +645,71 @@
   =head1 mod_perl Directives Argument Types and Allowed Location
   
   The following table shows where in the configuration files mod_perl
  -configuration directives are allowed to appear, what kind of and how
  -many arguments they expect:
  +configuration directives are allowed to appear, what kind and how many
  +arguments they expect:
   
   General directives:
   
  -    Directive                 Arguments     SRV   DIR
  -  ---------------------------------------------------
  -  PerlSwitches                 ITERATE       V
  -  PerlRequire                  ITERATE       V
  -  PerlModule                   ITERATE       V
  -  PerlOptions                  ITERATE       V     V
  -  PerlSetVar                   TAKE2         V     V
  -  PerlAddVar                   ITERATE2      V     V
  -  PerlSetEnv                   TAKE2         V     V
  -  PerlPassEnv                  TAKE1         V
  -  <Perl> Sections              RAW_ARGS      V
  -  PerlTrace                    TAKE1         V
  +    Directive                 Arguments  Scope
  +  --------------------------------------------
  +  PerlSwitches                 ITERATE    SRV
  +  PerlRequire                  ITERATE    SRV
  +  PerlModule                   ITERATE    SRV
  +  PerlOptions                  ITERATE    DIR
  +  PerlSetVar                   TAKE2      DIR
  +  PerlAddVar                   ITERATE2   DIR
  +  PerlSetEnv                   TAKE2      DIR
  +  PerlPassEnv                  TAKE1      SRV
  +  <Perl> Sections              RAW_ARGS   SRV
  +  PerlTrace                    TAKE1      SRV
   
   Handler assignment directives:
   
  -    Directive                 Arguments  TYPE     SRV   DIR
  -  ---------------------------------------------------------
  -  PerlOpenLogsHandler          ITERATE  RUN_ALL    V
  -  PerlPostConfigHandler        ITERATE  RUN_ALL    V
  -  PerlChildInitHandler         ITERATE  VOID       V
  -  
  -  PerlPreConnectionHandler     ITERATE  RUN_ALL    V
  -  PerlProcessConnectionHandler ITERATE  RUN_FIRST  V
  -  
  -  PerlPostReadRequestHandler   ITERATE  RUN_ALL    V
  -  PerlTransHandler             ITERATE  RUN_FIRST  V
  -  PerlInitHandler              ITERATE  RUN_ALL    V     V
  -  PerlHeaderParserHandler      ITERATE  RUN_ALL    V     V
  -  PerlAccessHandler            ITERATE  RUN_ALL    V     V
  -  PerlAuthenHandler            ITERATE  RUN_FIRST  V     V
  -  PerlAuthzHandler             ITERATE  RUN_FIRST  V     V
  -  PerlTypeHandler              ITERATE  RUN_FIRST  V     V
  -  PerlFixupHandler             ITERATE  RUN_ALL    V     V
  -  PerlResponseHandler          ITERATE  RUN_FIRST  V     V
  -  PerlLogHandler               ITERATE  RUN_ALL    V     V
  -  PerlCleanupHandler           ITERATE  XXX        V     V
  -  
  -  PerlInputFilterHandler       ITERATE  VOID       V     V
  -  PerlOutputFilterHandler      ITERATE  VOID       V     V
  +    Directive                 Arguments  Scope
  +  --------------------------------------------
  +  PerlOpenLogsHandler          ITERATE    SRV
  +  PerlPostConfigHandler        ITERATE    SRV
  +  PerlChildInitHandler         ITERATE    SRV
  +
  +  PerlPreConnectionHandler     ITERATE    SRV
  +  PerlProcessConnectionHandler ITERATE    SRV
  +
  +  PerlPostReadRequestHandler   ITERATE    SRV
  +  PerlTransHandler             ITERATE    SRV
  +  PerlInitHandler              ITERATE    DIR
  +  PerlHeaderParserHandler      ITERATE    DIR
  +  PerlAccessHandler            ITERATE    DIR
  +  PerlAuthenHandler            ITERATE    DIR
  +  PerlAuthzHandler             ITERATE    DIR
  +  PerlTypeHandler              ITERATE    DIR
  +  PerlFixupHandler             ITERATE    DIR
  +  PerlResponseHandler          ITERATE    DIR
  +  PerlLogHandler               ITERATE    DIR
  +  PerlCleanupHandler           ITERATE    DIR
   
  +  PerlInputFilterHandler       ITERATE    DIR
  +  PerlOutputFilterHandler      ITERATE    DIR
   
   Perl Interpreter management directives:
   
  -    Directive                 Arguments     SRV   DIR
  -  ---------------------------------------------------
  -  PerlInterpStart              TAKE1         V
  -  PerlInterpMax                TAKE1         V
  -  PerlInterpMinSpare           TAKE1         V
  -  PerlInterpMaxSpare           TAKE1         V
  -  PerlInterpMaxRequests        TAKE1         V
  -  PerlInterpScope              TAKE1         V     V
  -
  -mod_perl 1.0 back compatibility directives:
  -
  -    Directive                 Arguments     SRV   DIR
  -  ---------------------------------------------------
  -  PerlHandler                   ITERATE      V     V
  -  PerlSendHeader                FLAG         V     V
  -  PerlSetupEnv                  FLAG         V     V
  -  PerlTaintCheck                FLAG         V
  -  PerlWarn                      FLAG         V
  +    Directive                 Arguments  Scope
  +  --------------------------------------------
  +  PerlInterpStart              TAKE1      SRV
  +  PerlInterpMax                TAKE1      SRV
  +  PerlInterpMinSpare           TAKE1      SRV
  +  PerlInterpMaxSpare           TAKE1      SRV
  +  PerlInterpMaxRequests        TAKE1      SRV
  +  PerlInterpScope              TAKE1      DIR
  +
  +mod_perl 1.0 back-compatibility directives:
  +
  +    Directive                 Arguments  Scope
  +  --------------------------------------------
  +  PerlHandler                   ITERATE   DIR
  +  PerlSendHeader                FLAG      DIR
  +  PerlSetupEnv                  FLAG      DIR
  +  PerlTaintCheck                FLAG      SRV
  +  PerlWarn                      FLAG      SRV
   
   The I<Arguments> column represents the type of arguments directives
   accepts, where:
  @@ -743,8 +742,8 @@
   
   =back
   
  -The second and the third column show the locations the directives are
  -allowed to appear in:
  +The I<Scope> column shows the location the directives are allowed to
  +appear in:
   
   =over
   
  @@ -761,6 +760,9 @@
   can also appear in I<.htaccess> files.  These directives are defined
   as C<OR_ALL> in the source code.
   
  +These directives can also appear in the global server configuration
  +and C<E<lt>VirtualHostE<gt>>.
  +
   =back
   
   Apache specifies other allowed location types which are currently not
  @@ -768,8 +770,39 @@
   in I<include/httpd_config.h> (hint: search for C<RSRC_CONF>).
   
   
  +The I<Type> column specifies a phase's behavior when there is more
  +then one handler registered to run for this phase. (For C API
  +declarations see I<include/ap_config.h>, which includes other types
  +which aren't exposed by mod_perl.)
  +
  +
  +=over
   
  +=item * VOID
  +
  +Handlers of the type C<VOID> will be I<all> executed in the order they
  +have been registered disregarding their return values. Though in
  +mod_perl they are expected to return C<Apache::OK>.
  +
  +=item * RUN_FIRST
  +
  +Handlers of the type C<RUN_FIRST> will be executed in the order they
  +have been registered until the first handler that returns something
  +other than C<Apache::DECLINED>. If the return value is
  +C<Apache::DECLINED>, the next handler in the chain will be run. If the
  +return value is C<Apache::OK> the next phase will start. In all other
  +cases the execution will be aborted.
  +
  +=item * RUN_ALL
  +
  +Handlers of the type C<RUN_ALL> will be executed in the order they
  +have been registered until the first handler that returns something
  +other than C<Apache::OK> or C<Apache::DECLINED>.
  +
  +=back
   
  +Also see L<mod_perl Directives Argument Types and Allowed
  +Location|user::config::config/mod_perl_Directives_Argument_Types_and_Allowed_Location>
   
   
   
  
  
  

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