You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ta...@apache.org on 2008/05/06 19:57:00 UTC
svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml
Author: takashi
Date: Tue May 6 10:56:59 2008
New Revision: 653856
URL: http://svn.apache.org/viewvc?rev=653856&view=rev
Log:
mention that KeepAliveTimeout will be ignored in a name-based virtual host context.
PR: 36770
Modified:
httpd/httpd/trunk/docs/manual/mod/core.xml
Modified: httpd/httpd/trunk/docs/manual/mod/core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml?rev=653856&r1=653855&r2=653856&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml Tue May 6 10:56:59 2008
@@ -1560,6 +1560,10 @@
may cause performance problems in heavily loaded servers. The
higher the timeout, the more server processes will be kept
occupied waiting on connections with idle clients.</p>
+
+ <note type="warning"><title>Note</title>
+ <p>This directive will be ignored in a name-based virtual host context.</p>
+ </note>
</usage>
</directivesynopsis>
Re: svn commit: r653856 -
/httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by Takashi Sato <ta...@lans-tv.com>.
committed as r655438, r655477 and r655483
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by Eric Covener <co...@gmail.com>.
On Fri, May 9, 2008 at 8:34 PM, Takashi Sato <ta...@lans-tv.com> wrote:
> On Tue, 6 May 2008 21:19:53 +0200
> André Malo <nd...@perlig.de> wrote:
>
>> * Eric Covener wrote:
>>
>> > On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <jo...@slive.ca> wrote:
>> > > On Tue, May 6, 2008 at 1:57 PM, <ta...@apache.org> wrote:
>> > > > + <note type="warning"><title>Note</title>
>> > > > + <p>This directive will be ignored in a name-based virtual
>> > > > host context.</p> + </note>
>> >
>> > Useful to somehow clarify that if the connection matches a set of
>> > NameVirtualHost's, the KeepAliveTimeout from the first defined vhost
>> > in that set of NameVirtualhost's is used? I think it's still useful
>> > to tweak in that context.
>>
>> I agree that it would be generally desirable (it's a reference documentation
>> after all). But I think, it's pretty hard to explain if we want to avoid
>> confusion. People often don't even get the whole name based VH concept -
>> that's my experience at least.
>>
>> Maybe we need some "expert knowledge" boxes or something.
>>
>
> How about this attached patch?
> I know there may be someone who will be confused
> but I think the patch is better than there's nothing explained about
> name based vhost or at least than now
> because this is a reference documentation as you said.
+1
--
Eric Covener
covener@gmail.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: svn commit: r653856 -
/httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by Takashi Sato <ta...@lans-tv.com>.
On Tue, 6 May 2008 21:19:53 +0200
Andr� Malo <nd...@perlig.de> wrote:
> * Eric Covener wrote:
>
> > On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <jo...@slive.ca> wrote:
> > > On Tue, May 6, 2008 at 1:57 PM, <ta...@apache.org> wrote:
> > > > + <note type="warning"><title>Note</title>
> > > > + <p>This directive will be ignored in a name-based virtual
> > > > host context.</p> + </note>
> >
> > Useful to somehow clarify that if the connection matches a set of
> > NameVirtualHost's, the KeepAliveTimeout from the first defined vhost
> > in that set of NameVirtualhost's is used? I think it's still useful
> > to tweak in that context.
>
> I agree that it would be generally desirable (it's a reference documentation
> after all). But I think, it's pretty hard to explain if we want to avoid
> confusion. People often don't even get the whole name based VH concept -
> that's my experience at least.
>
> Maybe we need some "expert knowledge" boxes or something.
>
How about this attached patch?
I know there may be someone who will be confused
but I think the patch is better than there's nothing explained about
name based vhost or at least than now
because this is a reference documentation as you said.
Re: svn commit: r653856 -
/httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by Takashi Sato <ta...@lans-tv.com>.
On Tue, 6 May 2008 21:19:53 +0200
André Malo <nd...@perlig.de> wrote:
> * Eric Covener wrote:
>
> > On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <jo...@slive.ca> wrote:
> > > On Tue, May 6, 2008 at 1:57 PM, <ta...@apache.org> wrote:
> > > > + <note type="warning"><title>Note</title>
> > > > + <p>This directive will be ignored in a name-based virtual
> > > > host context.</p> + </note>
> >
> > Useful to somehow clarify that if the connection matches a set of
> > NameVirtualHost's, the KeepAliveTimeout from the first defined vhost
> > in that set of NameVirtualhost's is used? I think it's still useful
> > to tweak in that context.
>
> I agree that it would be generally desirable (it's a reference documentation
> after all). But I think, it's pretty hard to explain if we want to avoid
> confusion. People often don't even get the whole name based VH concept -
> that's my experience at least.
Humm, I agree. Well, what should I do?
I tried to explain it, but it is hard for me.
Should I revert r653856 and remove FixedInTrunk from PR36770 ?
Or how about:
-This directive will be ignored in a name-based virtual host context.
+This directive may be ignored in a name-based virtual host context.
Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by André Malo <nd...@perlig.de>.
* Eric Covener wrote:
> On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <jo...@slive.ca> wrote:
> > On Tue, May 6, 2008 at 1:57 PM, <ta...@apache.org> wrote:
> > > + <note type="warning"><title>Note</title>
> > > + <p>This directive will be ignored in a name-based virtual
> > > host context.</p> + </note>
>
> Useful to somehow clarify that if the connection matches a set of
> NameVirtualHost's, the KeepAliveTimeout from the first defined vhost
> in that set of NameVirtualhost's is used? I think it's still useful
> to tweak in that context.
I agree that it would be generally desirable (it's a reference documentation
after all). But I think, it's pretty hard to explain if we want to avoid
confusion. People often don't even get the whole name based VH concept -
that's my experience at least.
Maybe we need some "expert knowledge" boxes or something.
nd
--
die (eval q-qq[Just Another Perl Hacker
]
;-)
# André Malo, <http://www.perlig.de/> #
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by Eric Covener <co...@gmail.com>.
On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <jo...@slive.ca> wrote:
> On Tue, May 6, 2008 at 1:57 PM, <ta...@apache.org> wrote:
>
> > + <note type="warning"><title>Note</title>
> > + <p>This directive will be ignored in a name-based virtual host context.</p>
> > + </note>
>
Useful to somehow clarify that if the connection matches a set of
NameVirtualHost's, the KeepAliveTimeout from the first defined vhost
in that set of NameVirtualhost's is used? I think it's still useful
to tweak in that context.
--
Eric Covener
covener@gmail.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml
Posted by Joshua Slive <jo...@slive.ca>.
On Tue, May 6, 2008 at 1:57 PM, <ta...@apache.org> wrote:
> + <note type="warning"><title>Note</title>
> + <p>This directive will be ignored in a name-based virtual host context.</p>
> + </note>
That should just be an ordinary <note> with no type=.
warning is for really-important stuff like security problems.
(Obviously we should have called it something like "important", rather
than "warning", since you aren't the first to use it that way.)
Joshua.