You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@tomcat.apache.org by "Robert P. J. Day" <rp...@crashcourse.ca> on 2011/03/31 14:06:54 UTC

some documentation in conf/web.xml seems incorrect

  again, from a totally newbie point of view, i was perusing
conf/web.xml and noticed the snippets:

  <!--   buffered            Should output from this servlet be buffered?   -->
  <!--                       (0=false, 1=true)  [0]                         -->
  <!--                                                                      -->
  <!--   debug               Debugging detail level for messages logged     -->
  <!--                       by this servlet.  [0]                          -->
  <!--                                                                      -->
  <!--   expires             The number of seconds before a page with SSI   -->
  <!--                       directives will expire.  [No default]          -->

but just below that

        <init-param>
          <param-name>buffered</param-name>
          <param-value>1</param-value>
        </init-param>
        <init-param>
          <param-name>debug</param-name>
          <param-value>0</param-value>
        </init-param>
        <init-param>
          <param-name>expires</param-name>
          <param-value>666</param-value>
        </init-param>

so the comments don't seem to agree with at least a couple of the
parameter default values (certainly the "buffered" param seems to
disagree).

rday

-- 

========================================================================
Robert P. J. Day                               Waterloo, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org


Re: some documentation in conf/web.xml seems incorrect

Posted by "Robert P. J. Day" <rp...@crashcourse.ca>.
On Thu, 31 Mar 2011, Mark Thomas wrote:

> On 31/03/2011 13:06, Robert P. J. Day wrote:
> >
> >   again, from a totally newbie point of view, i was perusing
> > conf/web.xml and noticed the snippets:
> >
> >   <!--   buffered            Should output from this servlet be buffered?   -->
> >   <!--                       (0=false, 1=true)  [0]                         -->
> >
> > but just below that
> >
> >         <init-param>
> >           <param-name>buffered</param-name>
> >           <param-value>1</param-value>
> >         </init-param>
> >
> > so the comments don't seem to agree with at least a couple of the
> > parameter default values (certainly the "buffered" param seems to
> > disagree).
>
> The default value is what you get if you don't specify the value.
> The value is specified so a non-default is used. Arguably, the
> default should be changed and all init-params removed.

  duh.  sorry, i should have figured that out.

rday

-- 

========================================================================
Robert P. J. Day                               Waterloo, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org


Re: some documentation in conf/web.xml seems incorrect

Posted by Mark Thomas <ma...@apache.org>.
On 31/03/2011 13:06, Robert P. J. Day wrote:
> 
>   again, from a totally newbie point of view, i was perusing
> conf/web.xml and noticed the snippets:
> 
>   <!--   buffered            Should output from this servlet be buffered?   -->
>   <!--                       (0=false, 1=true)  [0]                         -->
>
> but just below that
> 
>         <init-param>
>           <param-name>buffered</param-name>
>           <param-value>1</param-value>
>         </init-param>
> 
> so the comments don't seem to agree with at least a couple of the
> parameter default values (certainly the "buffered" param seems to
> disagree).

The default value is what you get if you don't specify the value. The
value is specified so a non-default is used. Arguably, the default
should be changed and all init-params removed.

Mark



---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org