Mailing List Archive: Apache: Docs

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml

Index | Next | Previous | View Threaded

covener at gmail

May 6, 2008, 11:10 AM

Post #1 of 6 (214 views)
Permalink

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml

On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <joshua[at]slive.ca> wrote:
> On Tue, May 6, 2008 at 1:57 PM, <takashi[at]apache.org> wrote:
>
> > + <note type="warning"><title>Note</title>
> > + This directive will be ignored in a name-based virtual host context.
> > + </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[at]gmail.com

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe[at]httpd.apache.org
For additional commands, e-mail: docs-help[at]httpd.apache.org

nd at perlig

May 6, 2008, 12:19 PM

Post #2 of 6 (206 views)
Permalink

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml [In reply to]

* Eric Covener wrote:

> On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <joshua[at]slive.ca> wrote:
> > On Tue, May 6, 2008 at 1:57 PM, <takashi[at]apache.org> wrote:
> > > + <note type="warning"><title>Note</title>
> > > + This directive will be ignored in a name-based virtual
> > > host context. + </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[at]httpd.apache.org
For additional commands, e-mail: docs-help[at]httpd.apache.org

takashi at lans-tv

May 7, 2008, 8:32 AM

Post #3 of 6 (198 views)
Permalink

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml [In reply to]

On Tue, 6 May 2008 21:19:53 +0200
André Malo <nd[at]perlig.de> wrote:

> * Eric Covener wrote:
>
> > On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <joshua[at]slive.ca> wrote:
> > > On Tue, May 6, 2008 at 1:57 PM, <takashi[at]apache.org> wrote:
> > > > + <note type="warning"><title>Note</title>
> > > > + This directive will be ignored in a name-based virtual
> > > > host context. + </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.

takashi at lans-tv

May 9, 2008, 5:34 PM

Post #4 of 6 (188 views)
Permalink

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml [In reply to]

On Tue, 6 May 2008 21:19:53 +0200
André Malo <nd[at]perlig.de> wrote:

> * Eric Covener wrote:
>
> > On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <joshua[at]slive.ca> wrote:
> > > On Tue, May 6, 2008 at 1:57 PM, <takashi[at]apache.org> wrote:
> > > > + <note type="warning"><title>Note</title>
> > > > + This directive will be ignored in a name-based virtual
> > > > host context. + </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.

Attachments:

KeepAliveTimeout.patch (0.70 KB)

covener at gmail

May 10, 2008, 4:00 AM

Post #5 of 6 (185 views)
Permalink

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml [In reply to]

On Fri, May 9, 2008 at 8:34 PM, Takashi Sato <takashi[at]lans-tv.com> wrote:
> On Tue, 6 May 2008 21:19:53 +0200
> André Malo <nd[at]perlig.de> wrote:
>
>> * Eric Covener wrote:
>>
>> > On Tue, May 6, 2008 at 2:03 PM, Joshua Slive <joshua[at]slive.ca> wrote:
>> > > On Tue, May 6, 2008 at 1:57 PM, <takashi[at]apache.org> wrote:
>> > > > + <note type="warning"><title>Note</title>
>> > > > + This directive will be ignored in a name-based virtual
>> > > > host context. + </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[at]gmail.com

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe[at]httpd.apache.org
For additional commands, e-mail: docs-help[at]httpd.apache.org

takashi at lans-tv

May 12, 2008, 5:05 AM

Post #6 of 6 (172 views)
Permalink

Re: svn commit: r653856 - /httpd/httpd/trunk/docs/manual/mod/core.xml [In reply to]

committed as r655438, r655477 and r655483

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe[at]httpd.apache.org
For additional commands, e-mail: docs-help[at]httpd.apache.org

Index | Next | Previous | View Threaded

Interested in having your list archived? Contact lists@gossamer-threads.com