stas        2004/07/12 16:13:22

  Modified:    src/docs/2.0/api Apache.pod
               src/docs/2.0/api/APR Brigade.pod Bucket.pod IpSubnet.pod
                        PerlIO.pod Util.pod
               src/docs/2.0/api/Apache CmdParms.pod Connection.pod
                        Filter.pod Log.pod RequestRec.pod RequestUtil.pod
                        Server.pod ServerRec.pod ServerUtil.pod
               src/docs/2.0/api/ModPerl Global.pod
               src/docs/2.0/os/win32 config.pod
               src/docs/2.0/user/config config.pod custom.pod
               src/docs/2.0/user/handlers http.pod server.pod
               src/docs/2.0/user/install install.pod
  Log:
  complete Apache::ServerRec and update other pages
  
  Revision  Changes    Path
  1.5       +1 -1      modperl-docs/src/docs/2.0/api/Apache.pod
  
  Index: Apache.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache.pod,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -u -r1.4 -r1.5
  --- Apache.pod        22 May 2004 02:03:26 -0000      1.4
  +++ Apache.pod        12 Jul 2004 23:13:22 -0000      1.5
  @@ -18,7 +18,7 @@
   
   There are several modules that require the I<Apache> class as the
   first argument to the class methods that they define. For example
  -C<L<Apache::Server|docs::2.0::api::Apache::Server>> defines a class
  +C<L<Apache::Server|docs::2.0::api::Apache::ServerRec>> defines a class
   method
   C<L<Apache-E<gt>server|docs::2.0::api::Apache::Server/C_server_>>:
   
  
  
  
  1.10      +1 -1      modperl-docs/src/docs/2.0/api/APR/Brigade.pod
  
  Index: Brigade.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Brigade.pod,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -u -r1.9 -r1.10
  --- Brigade.pod       9 Jun 2004 16:17:42 -0000       1.9
  +++ Brigade.pod       12 Jul 2004 23:13:22 -0000      1.10
  @@ -159,7 +159,7 @@
   =item obj: C<$bb>
   ( C<L<APR::Brigade object|docs::2.0::api::APR::Brigade>> )
   
  -=item ret: C<$ret> ( true/false )
  +=item ret: C<$ret> ( boolean )
   
   =item since: 1.99_15
   
  
  
  
  1.9       +2 -2      modperl-docs/src/docs/2.0/api/APR/Bucket.pod
  
  Index: Bucket.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Bucket.pod,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -u -r1.8 -r1.9
  --- Bucket.pod        10 Jul 2004 00:26:55 -0000      1.8
  +++ Bucket.pod        12 Jul 2004 23:13:22 -0000      1.9
  @@ -183,7 +183,7 @@
   =item obj: C<$bucket>
   ( C<L<APR::Bucket object|docs::2.0::api::APR::Bucket>> )
   
  -=item ret: C<$ret> ( true/false )
  +=item ret: C<$ret> ( boolean )
   
   =item since: 1.99_10
   
  @@ -204,7 +204,7 @@
   =item obj: C<$bucket>
   ( C<L<APR::Bucket object|docs::2.0::api::APR::Bucket>> )
   
  -=item ret: C<$ret> ( true/false )
  +=item ret: C<$ret> ( boolean )
   
   =item since: 1.99_10
   
  
  
  
  1.5       +1 -1      modperl-docs/src/docs/2.0/api/APR/IpSubnet.pod
  
  Index: IpSubnet.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/IpSubnet.pod,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -u -r1.4 -r1.5
  --- IpSubnet.pod      28 May 2004 02:54:34 -0000      1.4
  +++ IpSubnet.pod      12 Jul 2004 23:13:22 -0000      1.5
  @@ -90,7 +90,7 @@
   
   The socket address to test
   
  -=item ret: C<$ret> ( true/false )
  +=item ret: C<$ret> ( boolean )
   
   true if the socket address is within the subnet, false otherwise
   
  
  
  
  1.10      +1 -1      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.9
  retrieving revision 1.10
  diff -u -u -r1.9 -r1.10
  --- PerlIO.pod        2 Jul 2004 16:51:18 -0000       1.9
  +++ PerlIO.pod        12 Jul 2004 23:13:22 -0000      1.10
  @@ -124,7 +124,7 @@
   
   =item ret: ( integer )
   
  -success or failure value (true/false).
  +success or failure value (boolean).
   
   =item since: 1.99_10
   
  
  
  
  1.7       +1 -1      modperl-docs/src/docs/2.0/api/APR/Util.pod
  
  Index: Util.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Util.pod,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -u -r1.6 -r1.7
  --- Util.pod  10 Jul 2004 00:26:55 -0000      1.6
  +++ Util.pod  12 Jul 2004 23:13:22 -0000      1.7
  @@ -46,7 +46,7 @@
   
   Encrypted or encoded hash. See below for supported hash formats.
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   The password either matches or not.
   
  
  
  
  1.4       +1 -1      modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod
  
  Index: CmdParms.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/CmdParms.pod,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -u -r1.3 -r1.4
  --- CmdParms.pod      22 May 2004 02:03:27 -0000      1.3
  +++ CmdParms.pod      12 Jul 2004 23:13:22 -0000      1.4
  @@ -243,7 +243,7 @@
   
   =item obj: C<$obj> (C<L<Apache::CmdParms|docs::2.0::api::Apache::CmdParms>>)
   
  -=item arg1: C<$s> (C<L<Apache::Server|docs::2.0::api::Apache::Server>>)
  +=item arg1: C<$s> (C<L<Apache::Server|docs::2.0::api::Apache::ServerRec>>)
   
   =item ret: no return value
   
  
  
  
  1.7       +1 -1      modperl-docs/src/docs/2.0/api/Apache/Connection.pod
  
  Index: Connection.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Connection.pod,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -u -r1.6 -r1.7
  --- Connection.pod    22 May 2004 02:03:27 -0000      1.6
  +++ Connection.pod    12 Jul 2004 23:13:22 -0000      1.7
  @@ -60,7 +60,7 @@
   
   =item obj: C<$c> 
(C<L<Apache::Connection|docs::2.0::api::Apache::Connection>>)
   
  -=item ret: C<$base_server> 
(C<L<Apache::Server|docs::2.0::api::Apache::Server>>)
  +=item ret: C<$base_server> 
(C<L<Apache::Server|docs::2.0::api::Apache::ServerRec>>)
   
   =back
   
  
  
  
  1.19      +1 -1      modperl-docs/src/docs/2.0/api/Apache/Filter.pod
  
  Index: Filter.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Filter.pod,v
  retrieving revision 1.18
  retrieving revision 1.19
  diff -u -u -r1.18 -r1.19
  --- Filter.pod        2 Jul 2004 23:17:05 -0000       1.18
  +++ Filter.pod        12 Jul 2004 23:13:22 -0000      1.19
  @@ -792,7 +792,7 @@
   
   The filter to remove
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   a true value if EOS has been seen, otherwise a false value
   
  
  
  
  1.13      +3 -3      modperl-docs/src/docs/2.0/api/Apache/Log.pod
  
  Index: Log.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Log.pod,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -u -r1.12 -r1.13
  --- Log.pod   10 Jul 2004 08:28:53 -0000      1.12
  +++ Log.pod   12 Jul 2004 23:13:22 -0000      1.13
  @@ -243,7 +243,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item arg1: C<@message> ( strings ARRAY )
   
  @@ -273,7 +273,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item arg1: C<$file> ( string )
   
  @@ -329,7 +329,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item ret: C<$slog> ( C<Apache::Log::Server> object )
   
  
  
  
  1.20      +2 -2      modperl-docs/src/docs/2.0/api/Apache/RequestRec.pod
  
  Index: RequestRec.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/RequestRec.pod,v
  retrieving revision 1.19
  retrieving revision 1.20
  diff -u -u -r1.19 -r1.20
  --- RequestRec.pod    10 Jul 2004 08:28:53 -0000      1.19
  +++ RequestRec.pod    12 Jul 2004 23:13:22 -0000      1.20
  @@ -210,7 +210,7 @@
   
   =head2 C<server>
   
  -Get the C<L<Apache::Server|docs::2.0::api::Apache::Server>> object for
  +Get the C<L<Apache::Server|docs::2.0::api::Apache::ServerRec>> object for
   the server the request C<$r> is running under.
   
     $s = $r->server();
  @@ -220,7 +220,7 @@
   =item obj: C<$r>
   ( C<L<Apache::RequestRec object|docs::2.0::api::Apache::RequestRec>> )
   
  -=item ret: C<$s> ( C<L<Apache::Server 
object|docs::2.0::api::Apache::Server>> )
  +=item ret: C<$s> ( C<L<Apache::ServerRec 
object|docs::2.0::api::Apache::ServerRec>> )
   
   =item since: 1.99_12
   
  
  
  
  1.23      +5 -5      modperl-docs/src/docs/2.0/api/Apache/RequestUtil.pod
  
  Index: RequestUtil.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/RequestUtil.pod,v
  retrieving revision 1.22
  retrieving revision 1.23
  diff -u -u -r1.22 -r1.23
  --- RequestUtil.pod   7 Jul 2004 21:52:24 -0000       1.22
  +++ RequestUtil.pod   12 Jul 2004 23:13:22 -0000      1.23
  @@ -475,7 +475,7 @@
   
   A request or a sub-request object
   
  -=item ret: C<$is_initial> ( true/false )
  +=item ret: C<$is_initial> ( boolean )
   
   If true -- it's the main request, otherwise it's a sub-request
   
  @@ -502,7 +502,7 @@
   
   =item arg1: C<$flag> ( string )
   
  -=item ret: C<$result> ( true/false )
  +=item ret: C<$result> ( boolean )
   
   =item since: 1.99_10
   
  @@ -569,7 +569,7 @@
   
   that argument will be I</foo>
   
  -=item ret: C<$ret> ( true/false )
  +=item ret: C<$ret> ( boolean )
   
   a true value if the merge was successful (i.e. the request
   C<$location> match was found), otherwise false.
  @@ -879,7 +879,7 @@
   if more than one passed, use a reference to an array of CODE refs
   and/or subroutine names.
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   returns a true value on success, otherwise a false value
   
  @@ -972,7 +972,7 @@
   if the argument is C<undef> or C<[]> the list of handlers is reset to
   zero.
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   returns a true value on success, otherwise a false value
   
  
  
  
  1.6       +1 -1      modperl-docs/src/docs/2.0/api/Apache/Server.pod
  
  Index: Server.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Server.pod,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -u -r1.5 -r1.6
  --- Server.pod        10 Jul 2004 08:28:53 -0000      1.5
  +++ Server.pod        12 Jul 2004 23:13:22 -0000      1.6
  @@ -7,7 +7,7 @@
   
   =head1 Synopsis
   
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
   
   META: to be completed
   
  
  
  
  1.2       +361 -249  modperl-docs/src/docs/2.0/api/Apache/ServerRec.pod
  
  Index: ServerRec.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/ServerRec.pod,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -u -r1.1 -r1.2
  --- ServerRec.pod     10 Jul 2004 08:28:53 -0000      1.1
  +++ ServerRec.pod     12 Jul 2004 23:13:22 -0000      1.2
  @@ -8,9 +8,37 @@
   =head1 Synopsis
   
     use Apache::ServerRec ();
  -
  -META: to be completed
  -
  +  
  +  $error_fname = $s->error_fname();
  +  
  +  $is_virtual = $s->is_virtual();
  +  
  +  $keep_alive         = $s->keep_alive();
  +  $keep_alive_max     = $s->keep_alive_max();
  +  $keep_alive_timeout = $s->keep_alive_timeout();
  +  
  +  $limit_req_fields    = $s->limit_req_fields();
  +  $limit_req_fieldsize = $s->limit_req_fieldsize();
  +  $limit_req_line      = $s->limit_req_line();
  +  
  +  $path = $s->path();
  +  
  +  $hostname = $s->server_hostname();
  +  $port     = $s->port();
  +  
  +  $server_admin = $s->server_admin();
  +  
  +  $proc = $s->process();
  +  
  +  $timeout  = $s->timeout();
  +  $loglevel = $s->loglevel();
  +  
  +  my $server = Apache->server;
  +  my $vhosts = 0;
  +  for (my $s = $server->next; $s; $s = $s->next) {
  +      $vhosts++;
  +  }
  +  print "There are $vhosts virtual hosts";
   
   
   
  @@ -31,19 +59,32 @@
   
   
   
  -=head2 C<process>
   
  -The process this server is running in
   
  -  $proc = $s->process();
  +=head2 C<error_fname>
  +
  +Get/set the C<ErrorLog> file value (e.g. F<logs/error_log>)
  +
  +  $error_fname      = $s->error_fname();
  +  $prev_error_fname = $s->error_fname($new_error_fname);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item ret: C<$proc>
  -( C<L<Apache::Process object|docs::2.0::api::Apache::Process>> )
  +=item opt arg1: C<$new_error_fname> ( string )
  +
  +If passed, sets the new value for C<ErrorLog>
  +
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
  +
  +=item ret: C<$error_fname> ( string )
  +
  +Returns the C<ErrorLog> value setting.
  +
  +If C<$new_error_fname> is passed returns the setting before the change.
   
   =item since: 1.99_15
   
  @@ -53,68 +94,65 @@
   
   
   
  -=head2 C<next>
   
  -The next server record in the list (if there are vhosts)
   
  -  $s_next = $s->next();
  +=head2 C<is_virtual>
  +
  +Test whether C<$s> is a virtual host object
  +
  +  $is_virtual = $s->is_virtual();
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item ret: C<$s_next>
  -( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
  +=item ret: C<$is_virtual> ( boolean )
  +
  +Returns the is_virtual setting.
  +
  +If C<$new_is_virtual> is passed, returns the setting before the
  +change.
   
   =item since: 1.99_15
   
   =back
   
  -For example the following code traverses all the servers, starting
  -from the base server and continuing to vhost servers, counting all
  -available vhosts:
  +Example:
   
  -  use Apache::ServerRec ();
  -  use Apache::ServerUtil ();
  -  my $server = Apache->server;
  -  my $vhosts = 0;
  -  for (my $s = $server->next; $s; $s = $s->next) {
  -      $vhosts++;
  -  }
  -  print "There are $vhosts virtual hosts";
  +  print "This is a virtual host" if $s->is_virtual();
   
   
   
   
   
   
  -=head2 C<server_admin>
  +=head2 C<keep_alive>
   
  -Get/set the server admin value
  +Get/set the C<KeepAlive> setting, which specifies whether Apache
  +should accept more than one request over the same connection from the
  +same client.
   
  -  $server_admin      = $s->server_admin();
  -  $prev_server_admin = $s->server_admin($new_server_admin);
  +  $keep_alive      = $s->keep_alive();
  +  $prev_keep_alive = $s->keep_alive($new_keep_alive);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_server_admin> ( string )
  +=item opt arg1: C<$new_keep_alive> ( boolean )
   
  -If passed, sets the new server_admin.
  +If passed, sets the new keep_alive.
   
  -Note that under threaded mpms, this option works only before threads
  -are spawned (i.e. before the
  -C<L<ChildInit|docs::2.0::user::handlers::server/PerlChildInitHandler>>
  -phase).
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=item ret: C<$server_admin> ( string )
  +=item ret: C<$keep_alive> ( boolean )
   
  -Returns the server_admin setting.
  +Returns the C<KeepAlive> setting.
   
  -If C<$new_server_admin> is passed returns the setting before the
  +If C<$new_keep_alive> is passed, returns the setting before the
   change.
   
   =item since: 1.99_15
  @@ -125,32 +163,34 @@
   
   
   
  -=head2 C<server_hostname>
   
  -Get/set the server hostname value
   
  -  $server_hostname      = $s->server_hostname();
  -  $prev_server_hostname = $s->server_hostname($new_server_hostname);
  +=head2 C<keep_alive_max>
  +
  +Get/set the C<MaxKeepAliveRequest> setting, which specifies the
  +maximum number of requests Apache will serve over a C<KeepAlive>
  +connection.
  +
  +  $keep_alive_max      = $s->keep_alive_max();
  +  $prev_keep_alive_max = $s->keep_alive_max($new_keep_alive_max);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_server_hostname> ( string )
  +=item opt arg1: C<$new_keep_alive_max> ( integer )
   
  -If passed, sets the new server_hostname.
  +If passed, sets the new keep_alive_max.
   
  -Note that under threaded mpms, this option works only before threads
  -are spawned (i.e. before the
  -C<L<ChildInit|docs::2.0::user::handlers::server/PerlChildInitHandler>>
  -phase).
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=item ret: C<$server_hostname> ( string )
  +=item ret: C<$keep_alive_max> ( integer )
   
  -Returns the server_hostname setting.
  +Returns the keep_alive_max setting.
   
  -If C<$new_server_hostname> is passed returns the setting before the
  +If C<$new_keep_alive_max> is passed, returns the setting before the
   change.
   
   =item since: 1.99_15
  @@ -162,35 +202,34 @@
   
   
   
  -=head2 C<port>
  +=head2 C<keep_alive_timeout>
   
  -Get/set the port value
  +Get/set the C<KeepAliveTimeout> setting (in microsecs), which
  +specifies how long Apache will wait for another request before
  +breaking a C<KeepAlive> connection.
   
  -  $port      = $s->port();
  -  $prev_port = $s->port($new_port);
  +  $keep_alive_timeout      = $s->keep_alive_timeout();
  +  $prev_keep_alive_timeout = $s->keep_alive_timeout($new_timeout);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_port> ( string )
  +=item opt arg1: C<$new_keep_alive_timeout> ( integer )
   
  -If passed, sets the new port.
  +The expected value is in microsecs.
   
  -Note that under threaded mpms, this option works only before threads
  -are spawned (i.e. before the
  -C<L<ChildInit|docs::2.0::user::handlers::server/PerlChildInitHandler>>
  -phase).
  +If passed, sets the new C<KeepAlive> timeout.
   
  -META: I don't think one should be allowed to change port number after
  -the server has started.
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=item ret: C<$port> ( string )
  +=item ret: C<$keep_alive_timeout> ( integer )
   
  -Returns the port setting.
  +Returns the C<KeepAlive> timeout value (in microsecs).
   
  -If C<$new_port> is passed returns the setting before the change.
  +If C<$new_timeout> is passed, returns the setting before the change.
   
   =item since: 1.99_15
   
  @@ -200,32 +239,32 @@
   
   
   
  -=head2 C<error_fname>
   
  -Get/set the C<ErrorLog> file value (e.g. F<logs/error_log>)
  +=head2 C<limit_req_fields>
   
  -  $error_fname      = $s->error_fname();
  -  $prev_error_fname = $s->error_fname($new_error_fname);
  +Get/set limit on number of request header fields
  +
  +  $limit_req_fields      = $s->limit_req_fields();
  +  $prev_limit_req_fields = $s->limit_req_fields($new_limit_req_fields);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_error_fname> ( string )
  +=item opt arg1: C<$new_limit_req_fields> ( integer )
   
  -If passed, sets the new value for C<ErrorLog>
  +If passed, sets the new request headers number limit.
   
  -Note that under threaded mpms, this option works only before threads
  -are spawned (i.e. before the
  -C<L<ChildInit|docs::2.0::user::handlers::server/PerlChildInitHandler>>
  -phase).
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=item ret: C<$error_fname> ( string )
  +=item ret: C<$limit_req_fields> ( integer )
   
  -Returns the C<ErrorLog> value setting.
  +Returns the request headers number limit.
   
  -If C<$new_error_fname> is passed returns the setting before the change.
  +If C<$new_limit_req_fields> is passed, returns the setting before the
  +change.
   
   =item since: 1.99_15
   
  @@ -236,28 +275,30 @@
   
   
   
  +=head2 C<limit_req_fieldsize>
   
  -=head2 C<loglevel>
  -
  -Get/set the C<LogLevel> directive value
  +Get/set limit on size of any request header field
   
  -  $loglevel      = $s->loglevel();
  -  $prev_loglevel = $s->loglevel($new_loglevel);
  +  $limit_req_fieldsize = $s->limit_req_fieldsize();
  +  $prev_limit          = $s->limit_req_fieldsize($new_limit);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_loglevel> ( string )
  +=item opt arg1: C<$new_limit_req_fieldsize> ( integer )
   
  -If passed, sets a new C<LogLevel> value
  +If passed, sets the new request header size limit.
   
  -=item ret: C<$loglevel> ( string )
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -Returns the C<LogLevel> value
  +=item ret: C<$limit_req_fieldsize> ( integer )
   
  -If C<$new_loglevel> is passed, returns the setting before the change.
  +Returns the request header size limit.
  +
  +If C<$new_limit> is passed, returns the setting before the change.
   
   =item since: 1.99_15
   
  @@ -268,22 +309,31 @@
   
   
   
  -=head2 C<is_virtual>
  +=head2 C<limit_req_line>
   
  -Test whether C<$s> is a virtual host object
  +Get/set limit on size of the HTTP request line
   
  -  $is_virtual = $s->is_virtual();
  +  $limit_req_line      = $s->limit_req_line();
  +  $prev_limit_req_line = $s->limit_req_line($new_limit_req_line);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item ret: C<$is_virtual> ( string )
  +=item opt arg1: C<$new_limit_req_line> ( integer )
   
  -Returns the is_virtual setting.
  +If passed, sets the new request line limit value.
  +
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -If C<$new_is_virtual> is passed returns the setting before the change.
  +=item ret: C<$limit_req_line> ( integer )
  +
  +Returns the request line limit value
  +
  +If C<$new_limit_req_line> is passed, returns the setting before the
  +change.
   
   =item since: 1.99_15
   
  @@ -295,131 +345,143 @@
   
   
   
  +=head2 C<loglevel>
   
  -=head2 C<timeout>
  -
  -Get/set the timeout (in microsecs), before we give up doing something
  +Get/set the C<LogLevel> directive value
   
  -  $timeout      = $s->timeout();
  -  $prev_timeout = $s->timeout($new_timeout);
  +  $loglevel      = $s->loglevel();
  +  $prev_loglevel = $s->loglevel($new_loglevel);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_timeout> ( string )
  +=item opt arg1: C<$new_loglevel> ( C<L<Apache::Const :log
  +constant|docs::2.0::api::Apache::Const/C__log_>> )
   
  -If passed, sets the new timeout (the value should be in microseconds).
  +If passed, sets a new C<LogLevel> value
   
  -Note that under threaded mpms, this option works only before threads
  -are spawned (i.e. before the
  -C<L<ChildInit|docs::2.0::user::handlers::server/PerlChildInitHandler>>
  -phase).
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=item ret: C<$timeout> ( string )
  +=item ret: C<$loglevel> ( C<L<Apache::Const :log
  +constant|docs::2.0::api::Apache::Const/C__log_>> )
   
  -Returns the timeout setting in microseconds.
  +Returns the C<LogLevel> value as a constant.
   
  -If C<$new_timeout> is passed returns the setting before the change.
  +If C<$new_loglevel> is passed, returns the setting before the change.
   
   =item since: 1.99_15
   
   =back
   
  -To stress out the timeout values is microseconds, here is how to set
  -the timeout to 20 secs:
  +For example, to set the C<LogLevel> value to C<info>:
   
  -  $s->timeout(20_000_000);
  +  use Apache::Const -compile => qw(LOG_INFO);
  +  $s->loglevel(Apache::LOG_INFO);
   
   
   
   
   
   
  +=head2 C<next>
   
  -=head2 C<keep_alive_timeout>
  -
  -META: Autogenerated - needs to be reviewed/completed
  -
  -Get/set the apr interval we will wait for another request
  +The next server record in the list (if there are vhosts)
   
  -  $keep_alive_timeout = $s->keep_alive_timeout();
  -  $prev_keep_alive_timeout = $s->keep_alive_timeout($new_keep_alive_timeout);
  +  $s_next = $s->next();
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_keep_alive_timeout> ( string )
  -
  -If passed, sets the new keep_alive_timeout.
  +=item ret: C<$s_next>
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item ret: C<$keep_alive_timeout> ( string )
  +=item since: 1.99_15
   
  -Returns the keep_alive_timeout setting.
  +=back
   
  -If C<$new_keep_alive_timeout> is passed returns the setting before the 
change.
  +For example the following code traverses all the servers, starting
  +from the base server and continuing to vhost servers, counting all
  +available vhosts:
   
  -=item since: 1.99_15
  +  use Apache::ServerRec ();
  +  use Apache::ServerUtil ();
  +  my $server = Apache->server;
  +  my $vhosts = 0;
  +  for (my $s = $server->next; $s; $s = $s->next) {
  +      $vhosts++;
  +  }
  +  print "There are $vhosts virtual hosts";
   
  -=back
   
   
   
  -=head2 C<keep_alive_max>
   
  -META: Autogenerated - needs to be reviewed/completed
  +=head2 C<path>
   
  -Get/set maximum requests per connection
  +Get/set pathname for the C<ServerPath> setting
   
  -  $keep_alive_max = $s->keep_alive_max();
  -  $prev_keep_alive_max = $s->keep_alive_max($new_keep_alive_max);
  +  $path      = $s->path();
  +  $prev_path = $s->path($new_path);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_keep_alive_max> ( string )
  +=item opt arg1: C<$new_path> ( string )
   
  -If passed, sets the new keep_alive_max.
  +If passed, sets the new path.
   
  -=item ret: C<$keep_alive_max> ( string )
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -Returns the keep_alive_max setting.
  +=item ret: C<$path> ( string )
   
  -If C<$new_keep_alive_max> is passed returns the setting before the change.
  +Returns the path setting.
  +
  +If C<$new_path> is passed, returns the setting before the change.
   
   =item since: 1.99_15
   
   =back
   
   
  -=head2 C<keep_alive>
   
  -META: Autogenerated - needs to be reviewed/completed
   
  -Use persistent connections?
   
  -  $keep_alive = $s->keep_alive();
  -  $prev_keep_alive = $s->keep_alive($new_keep_alive);
  +
  +=head2 C<port>
  +
  +Get/set the port value
  +
  +  $port      = $s->port();
  +  $prev_port = $s->port($new_port);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_keep_alive> ( string )
  +=item opt arg1: C<$new_port> ( integer )
   
  -If passed, sets the new keep_alive.
  +If passed, sets the new port.
   
  -=item ret: C<$keep_alive> ( string )
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -Returns the keep_alive setting.
  +META: I don't think one should be allowed to change port number after
  +the server has started.
   
  -If C<$new_keep_alive> is passed returns the setting before the change.
  +=item ret: C<$port> ( integer )
  +
  +Returns the port setting.
  +
  +If C<$new_port> is passed returns the setting before the change.
   
   =item since: 1.99_15
   
  @@ -427,29 +489,22 @@
   
   
   
  -=head2 C<path>
   
  -META: Autogenerated - needs to be reviewed/completed
   
  -Get/set pathname for ServerPath
   
  -  $path = $s->path();
  -  $prev_path = $s->path($new_path);
  +=head2 C<process>
  +
  +The process this server is running in
  +
  +  $proc = $s->process();
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_path> ( string )
  -
  -If passed, sets the new path.
  -
  -=item ret: C<$path> ( string )
  -
  -Returns the path setting.
  -
  -If C<$new_path> is passed returns the setting before the change.
  +=item ret: C<$proc>
  +( C<L<Apache::Process object|docs::2.0::api::Apache::Process>> )
   
   =item since: 1.99_15
   
  @@ -458,29 +513,33 @@
   
   
   
  -=head2 C<names>
   
  -META: Autogenerated - needs to be reviewed/completed
   
  -Get/set normal names for ServerAlias servers
  +=head2 C<server_admin>
   
  -  $names = $s->names();
  -  $prev_names = $s->names($new_names);
  +Get/set the C<ServerAdmin> value
  +
  +  $server_admin      = $s->server_admin();
  +  $prev_server_admin = $s->server_admin($new_server_admin);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_names> 
(C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>>)
  +=item opt arg1: C<$new_server_admin> ( string )
   
  -If passed, sets the new names.
  +If passed, sets the new C<ServerAdmin> value.
   
  -=item ret: C<$names> 
(C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>>)
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -Returns the names setting.
  +=item ret: C<$server_admin> ( string )
  +
  +Returns the C<ServerAdmin> value.
   
  -If C<$new_names> is passed returns the setting before the change.
  +If C<$new_server_admin> is passed, returns the setting before the
  +change.
   
   =item since: 1.99_15
   
  @@ -490,29 +549,31 @@
   
   
   
  -=head2 C<wild_names>
  -
  -META: Autogenerated - needs to be reviewed/completed
  +=head2 C<server_hostname>
   
  -Wildcarded names for ServerAlias servers
  +Get/set the C<ServerName> value
   
  -  $wild_names = $s->wild_names();
  -  $prev_wild_names = $s->wild_names($new_wild_names);
  +  $server_hostname      = $s->server_hostname();
  +  $prev_server_hostname = $s->server_hostname($new_server_hostname);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_wild_names> 
(C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>>)
  +=item opt arg1: C<$new_server_hostname> ( string )
   
  -If passed, sets the new wild_names.
  +If passed, sets the C<ServerName> value
   
  -=item ret: C<$wild_names> 
(C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>>)
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -Returns the wild_names setting.
  +=item ret: C<$server_hostname> ( string )
   
  -If C<$new_wild_names> is passed returns the setting before the change.
  +Returns the C<ServerName> value
  +
  +If C<$new_server_hostname> is passed, returns the setting before the
  +change.
   
   =item since: 1.99_15
   
  @@ -521,112 +582,144 @@
   
   
   
  -=head2 C<limit_req_line>
   
  -META: Autogenerated - needs to be reviewed/completed
   
  -Get/set limit on size of the HTTP request line
   
  -  $limit_req_line = $s->limit_req_line();
  -  $prev_limit_req_line = $s->limit_req_line($new_limit_req_line);
  +=head2 C<timeout>
  +
  +Get/set the timeout (C<TimeOut>) (in microsecs), which Apache will
  +wait for before it gives up doing something
  +
  +  $timeout      = $s->timeout();
  +  $prev_timeout = $s->timeout($new_timeout);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_limit_req_line> ( string )
  +=item opt arg1: C<$new_timeout> ( integer )
  +
  +If passed, sets the new timeout (the value should be in microseconds).
   
  -If passed, sets the new limit_req_line.
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=item ret: C<$limit_req_line> ( string )
  +=item ret: C<$timeout> ( integer )
   
  -Returns the limit_req_line setting.
  +Returns the timeout setting in microseconds.
   
  -If C<$new_limit_req_line> is passed returns the setting before the
  -change.
  +If C<$new_timeout> is passed, returns the setting before the change.
   
   =item since: 1.99_15
   
   =back
   
  +Let us repeat again: the timeout values is microseconds. For example
  +to set the timeout to 20 secs:
   
  -=head2 C<limit_req_fieldsize>
  +  $s->timeout(20_000_000);
   
  -META: Autogenerated - needs to be reviewed/completed
   
  -limit on size of any request header field
   
  -  $limit_req_fieldsize = $s->limit_req_fieldsize();
  -  $prev_limit_req_fieldsize = 
$s->limit_req_fieldsize($new_limit_req_fieldsize);
   
  -=over 4
   
  -=item obj: C<$s>
  -( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_limit_req_fieldsize> ( string )
   
  -If passed, sets the new limit_req_fieldsize.
   
  -=item ret: C<$limit_req_fieldsize> ( string )
   
  -Returns the limit_req_fieldsize setting.
   
  -If C<$new_limit_req_fieldsize> is passed returns the setting before
  -the change.
   
  -=item since: 1.99_15
   
  -=back
   
   
  +=head1 Notes
   
   
  -=head2 C<limit_req_fields>
  +=head2 Limited Functionality under Threaded MPMs
   
  -META: Autogenerated - needs to be reviewed/completed
  +Note that under threaded MPMs, some of the read/write accessors, will
  +be able to set values only before threads are spawned (i.e. before the
  +C<L<ChildInit
  +phase|docs::2.0::user::handlers::server/PerlChildInitHandler>>).
  +Therefore if you are developing your application on the non-threaded
  +MPM, but planning to have it run under threaded mpm, you should not
  +use those methods to set values after the ChildInit phase.
   
  -Get/set limit on number of request header fields
  +The affected accessor methods are marked as such in their respective
  +documentation entries.
   
  -  $limit_req_fields = $s->limit_req_fields();
  -  $prev_limit_req_fields = $s->limit_req_fields($new_limit_req_fields);
  +
  +
  +
  +
  +
  +
  +
  +=head1 Unsupported API
  +
  +C<Apache::ServerRec> also provides auto-generated Perl interface for a
  +few other methods which aren't tested at the moment and therefore
  +their API is a subject to change. These methods will be finalized
  +later as a need arises. If you want to rely on any of the following
  +methods please contact the L<the mod_perl development mailing
  +list|maillist::dev> so we can help each other take the steps necessary
  +to shift the method to an officially supported API.
  +
  +
  +
  +
  +=head2 C<addrs>
  +
  +Get the addrs value
  +
  +  $addrs = $s->addrs();
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item opt arg2: C<$new_limit_req_fields> ( string )
  +=item ret: C<$addrs>
  +( C<L<Apache::ServerAddr|docs::2.0::api::Apache::ServerAddr>> )
   
  -If passed, sets the new limit_req_fields.
  +Returns the addrs setting.
   
  -=item ret: C<$limit_req_fields> ( string )
  +=item since: subject to change
   
  -Returns the limit_req_fields setting.
  +=back
   
  -If C<$new_limit_req_fields> is passed returns the setting before the change.
  +META: this methods returns a vhost-specific Apache::ServerAddr object,
  +which is not implemented at the moment. See the struct server_addr_rec
  +entry in httpd-2.0/include/httpd.h for more information. It seems that
  +most (all?) of the information in that record is available through
  +other APIs.
   
  -=item since: 1.99_15
   
  -=back
   
   
   
  +=head2 C<lookup_defaults>
   
  +Get the lookup_defaults value.  MIME type info, etc., before we start
  +checking per-directory info.
   
  +  $lookup_defaults = $s->lookup_defaults();
   
  +=over 4
   
  +=item obj: C<$s>
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=head1 Unsupported API
  +=item ret: C<$lookup_defaults>
  +( C<L<Apache::ConfVector|docs::2.0::api::Apache::ConfVector>> )
  +
  +Returns the lookup_defaults setting.
  +
  +=item since: subject to change
  +
  +=back
   
  -C<Apache::ServerRec> also provides auto-generated Perl interface for a
  -few other methods which aren't tested at the moment and therefore
  -their API is a subject to change. These methods will be finalized
  -later as a need arises. If you want to rely on any of the following
  -methods please contact the L<the mod_perl development mailing
  -list|maillist::dev> so we can help each other take the steps necessary
  -to shift the method to an officially supported API.
   
   
   
  @@ -655,58 +748,77 @@
   
   
   
  -=head2 C<lookup_defaults>
  +=head2 C<names>
   
  -Get the lookup_defaults value.  MIME type info, etc., before we start
  -checking per-directory info.
  +Get/set the value(s) for the C<ServerAlias> setting
   
  -  $lookup_defaults = $s->lookup_defaults();
  +  $names      = $s->names();
  +  $prev_names = $s->names($new_names);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item ret: C<$lookup_defaults>
  -( C<L<Apache::ConfVector|docs::2.0::api::Apache::ConfVector>> )
  +=item opt arg1: C<$new_names>
  +( C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>> )
   
  -Returns the lookup_defaults setting.
  +If passed, sets the new names.
   
  -=item since: subject to change
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
  +
  +=item ret: C<$names> 
  +( C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>> )
  +
  +Returns the names setting.
  +
  +If C<$new_names> is passed, returns the setting before the change.
  +
  +=item since: 1.99_15
   
   =back
   
  +META: we don't have C<APR::ArrayHeader> yet
   
   
   
  -=head2 C<addrs>
   
  -Get the addrs value
   
  -  $addrs = $s->addrs();
  +
  +=head2 C<wild_names>
  +
  +Wildcarded names for ServerAlias servers
  +
  +  $wild_names      = $s->wild_names();
  +  $prev_wild_names = $s->wild_names($new_wild_names);
   
   =over 4
   
   =item obj: C<$s>
   ( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item ret: C<$addrs>
  -( C<L<Apache::ServerAddr|docs::2.0::api::Apache::ServerAddr>> )
  +=item opt arg1: C<$new_wild_names>
  +( C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>> )
   
  -Returns the addrs setting.
  +If passed, sets the new wild_names.
   
  -=item since: subject to change
  +Note the L<limited functionality under threaded
  +MPMs|/Limited_Functionality_under_Threaded_MPMs>.
   
  -=back
  +=item ret: C<$wild_names>
  +( C<L<APR::ArrayHeader|docs::2.0::api::APR::ArrayHeader>> )
   
  -META: this methods returns a vhost-specific Apache::ServerAddr object,
  -which is not implemented at the moment. See the struct server_addr_rec
  -entry in httpd-2.0/include/httpd.h for more information. It seems that
  -most (all?) of the information in that record is available through
  -other APIs.
  +Returns the wild_names setting.
   
  +If C<$new_wild_names> is passed, returns the setting before the
  +change.
   
  +=item since: 1.99_15
  +
  +=back
   
  +META: we don't have C<APR::ArrayHeader> yet
   
   
   
  
  
  
  1.23      +16 -15    modperl-docs/src/docs/2.0/api/Apache/ServerUtil.pod
  
  Index: ServerUtil.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/ServerUtil.pod,v
  retrieving revision 1.22
  retrieving revision 1.23
  diff -u -u -r1.22 -r1.23
  --- ServerUtil.pod    10 Jul 2004 08:28:53 -0000      1.22
  +++ ServerUtil.pod    12 Jul 2004 23:13:22 -0000      1.23
  @@ -50,7 +50,8 @@
   
   =over 4
   
  -=item obj: C<$pconf> (C<L<APR::Pool|docs::2.0::api::APR::Pool>>)
  +=item obj: C<$pconf>
  +( C<L<APR::Pool object|docs::2.0::api::APR::Pool>> )
   
   The pool to allocate the component from (should really be a
   C<$pconf_pool>)
  @@ -81,7 +82,7 @@
   
   The define to check for
   
  -=item ret: C<$result> (integer)
  +=item ret: C<$result> ( boolean )
   
   true if defined, false otherwise
   
  @@ -175,9 +176,9 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
  -=item arg1: C<$lines> (ARRAY ref)
  +=item arg1: C<$lines> ( ARRAY ref )
   
   An ARRAY reference containing configuration lines per element, without
   the new line terminators.
  @@ -223,7 +224,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item opt arg2: C<$key> ( string )
   
  @@ -293,7 +294,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   The current server
   
  @@ -321,7 +322,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item arg1: C<$hook_name> ( string )
   
  @@ -359,11 +360,11 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item arg1: C<$flag> ( string )
   
  -=item ret: C<$result> ( true/false )
  +=item ret: C<$result> ( boolean )
   
   =item since: 1.99_10
   
  @@ -427,7 +428,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item arg1: C<$hook_name> ( string )
   
  @@ -441,7 +442,7 @@
   if more than one passed, use a reference to an array of CODE refs
   and/or subroutine names.
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   returns a true value on success, otherwise a false value
   
  @@ -483,7 +484,7 @@
   =item obj: C<Apache> (class name)
   
   =item ret: C<$main_s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item since: 1.99_10
   
  @@ -510,7 +511,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item opt arg2: C<$fname> ( string )
   
  @@ -548,7 +549,7 @@
   =over 4
   
   =item obj: C<$s>
  -( C<L<Apache::Server object|docs::2.0::api::Apache::Server>> )
  +( C<L<Apache::ServerRec object|docs::2.0::api::Apache::ServerRec>> )
   
   =item arg1: C<$hook_name> ( string )
   
  @@ -565,7 +566,7 @@
   if the argument is C<undef> or C<[]> the list of handlers is reset to
   zero.
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   returns a true value on success, otherwise a false value
   
  
  
  
  1.4       +3 -3      modperl-docs/src/docs/2.0/api/ModPerl/Global.pod
  
  Index: Global.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Global.pod,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -u -r1.3 -r1.4
  --- Global.pod        22 May 2004 02:03:28 -0000      1.3
  +++ Global.pod        12 Jul 2004 23:13:22 -0000      1.4
  @@ -74,7 +74,7 @@
   
   what package to special list is for
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   true value if C<$key> is known, false otherwise.
   
  @@ -103,7 +103,7 @@
   
   what package to special list is for
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   true value if C<$key> is known, false otherwise.
   
  @@ -131,7 +131,7 @@
   
   what package to special list is for
   
  -=item ret: C<$ok> ( true/false )
  +=item ret: C<$ok> ( boolean )
   
   true value if C<$key> is known, false otherwise.
   
  
  
  
  1.13      +1 -1      modperl-docs/src/docs/2.0/os/win32/config.pod
  
  Index: config.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/os/win32/config.pod,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -u -r1.12 -r1.13
  --- config.pod        28 Apr 2004 21:40:12 -0000      1.12
  +++ config.pod        12 Jul 2004 23:13:22 -0000      1.13
  @@ -36,7 +36,7 @@
     use Apache::RequestRec ();
     use Apache::RequestIO ();
     use Apache::RequestUtil ();
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     use Apache::ServerUtil ();
     use Apache::Connection ();
     use Apache::Log ();
  
  
  
  1.64      +1 -1      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.63
  retrieving revision 1.64
  diff -u -u -r1.63 -r1.64
  --- config.pod        26 Apr 2004 22:52:02 -0000      1.63
  +++ config.pod        12 Jul 2004 23:13:22 -0000      1.64
  @@ -104,7 +104,7 @@
     use Apache::RequestIO ();
     use Apache::RequestUtil ();
     
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     use Apache::ServerUtil ();
     use Apache::Connection ();
     use Apache::Log ();
  
  
  
  1.10      +2 -2      modperl-docs/src/docs/2.0/user/config/custom.pod
  
  Index: custom.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/custom.pod,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -u -r1.9 -r1.10
  --- custom.pod        8 Mar 2004 21:54:05 -0000       1.9
  +++ custom.pod        12 Jul 2004 23:13:22 -0000      1.10
  @@ -751,7 +751,7 @@
   main server's configuration object use:
   
     use Apache::Module ();
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     use Apache::ServerUtil ();
     ...
     if ($s->is_virtual) {
  @@ -1057,7 +1057,7 @@
     
     use Apache::RequestRec ();
     use Apache::RequestIO ();
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     use Apache::ServerUtil ();
     use Apache::Module ();
     
  
  
  
  1.40      +1 -1      modperl-docs/src/docs/2.0/user/handlers/http.pod
  
  Index: http.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/handlers/http.pod,v
  retrieving revision 1.39
  retrieving revision 1.40
  diff -u -u -r1.39 -r1.40
  --- http.pod  5 Jul 2004 04:37:20 -0000       1.39
  +++ http.pod  12 Jul 2004 23:13:22 -0000      1.40
  @@ -444,7 +444,7 @@
     use Apache::RequestRec ();
     use Apache::RequestIO ();
     use Apache::RequestUtil ();
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     use Apache::Process ();
     use APR::Table ();
     
  
  
  
  1.16      +1 -1      modperl-docs/src/docs/2.0/user/handlers/server.pod
  
  Index: server.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/handlers/server.pod,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -u -r1.15 -r1.16
  --- server.pod        6 Jun 2004 10:11:44 -0000       1.15
  +++ server.pod        12 Jul 2004 23:13:22 -0000      1.16
  @@ -257,7 +257,7 @@
   traverse the configured virtual hosts, you can accomplish that using a
   simple loop. For example to print out the configured port numbers do:
   
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     # ...
     sub open_logs {
         my($conf_pool, $log_pool, $temp_pool, $s) = @_;
  
  
  
  1.57      +1 -1      modperl-docs/src/docs/2.0/user/install/install.pod
  
  Index: install.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/install/install.pod,v
  retrieving revision 1.56
  retrieving revision 1.57
  diff -u -u -r1.56 -r1.57
  --- install.pod       4 Jul 2004 19:18:25 -0000       1.56
  +++ install.pod       12 Jul 2004 23:13:22 -0000      1.57
  @@ -439,7 +439,7 @@
   
   in I<httpd.conf> or:
   
  -  use Apache::Server ();
  +  use Apache::ServerRec ();
     use Apache::ServerUtil ();
     use Apache::Process ();
     my $pool = Apache->server->process->pool;
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to