[prev in list] [next in list] [prev in thread] [next in thread] 

List:       apache-docs
Subject:    Re: Proposal for a new mod_event documentation page
From:       Luca Toscano <toscano.luca () gmail ! com>
Date:       2016-02-09 21:38:49
Message-ID: CAFedD42DksC8JMye=pex+F5r4ZZDLrxoNuh_hPFQV6Wp8-yC+w () mail ! gmail ! com
[Download RAW message or body]

After some feedbacks I updated the trunk documentation:

https://httpd.apache.org/docs/trunk/mod/event.html

Please let me know if you like the new page and the new information
contained. In case, I'll backport the change to 2.4.x, otherwise I'll
revert.

Thanks!

Luca


2016-02-08 15:32 GMT+01:00 Luca Toscano <toscano.luca@gmail.com>:

> +dev for visibility
> ---------- Messaggio inoltrato ----------
> Da: "Luca Toscano" <toscano.luca@gmail.com>
> Data: 06 feb 2016 15:10
> Oggetto: Proposal for a new mod_event documentation page
> A: <docs@httpd.apache.org>
> Cc:
>
> Hi Apache Devs!
>
> I started an email thread some days ago on the dev mailing list to gather
> information about mod_event, getting tons of interesting things to read. I
> attached to this email a draft of how the new page should look like in my
> opinion, please let me know your thoughts!
>
> Notes about the changes:
>
> - clear statement that event shares all the configuration directives with
> worker, together with the fact that the number of threads is regulated by
> processes multiplied by threads per child.
>
> - explanation of the new async connections fields in mod_status.
>
> - tried to add all the information about keep alives, writing and closing
> connections that I've gathered so far. I added a disclaimer for the writing
> ones and a big section called "limitations", but I have probably failed to
> describe all the closing ones (not only lingering closes I suppose, but I
> wasn't sure).
>
> - clear logic connection between how it works and the
> "AsyncRequestWorkerFactor" directive section (I am referring to the
> sentence "The event MPM handles some connections in an asynchronous way").
>
> Apologies for technical inaccuracies and/or typos!
>
> Luca
>

[Attachment #3 (text/html)]

<div dir="ltr">After some feedbacks I updated the trunk \
documentation:<div><br></div><div><a \
href="https://httpd.apache.org/docs/trunk/mod/event.html">https://httpd.apache.org/docs/trunk/mod/event.html</a><br></div><div><br></div><div>Please \
let me know if you like the new page and the new information contained. In case, \
I&#39;ll backport the change to 2.4.x, otherwise I&#39;ll \
revert.</div><div><br></div><div>Thanks!</div><div><br></div><div>Luca</div><div><br></div></div><div \
class="gmail_extra"><br><div class="gmail_quote">2016-02-08 15:32 GMT+01:00 Luca \
Toscano <span dir="ltr">&lt;<a href="mailto:toscano.luca@gmail.com" \
target="_blank">toscano.luca@gmail.com</a>&gt;</span>:<br><blockquote \
class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex"><p dir="ltr">+dev for visibility</p> <div \
class="gmail_quote">---------- Messaggio inoltrato ----------<br>Da: &quot;Luca \
Toscano&quot; &lt;<a href="mailto:toscano.luca@gmail.com" \
target="_blank">toscano.luca@gmail.com</a>&gt;<br>Data: 06 feb 2016 15:10<br>Oggetto: \
Proposal for a new mod_event documentation page<br>A:  &lt;<a \
href="mailto:docs@httpd.apache.org" \
target="_blank">docs@httpd.apache.org</a>&gt;<br>Cc: <br><div><div class="h5"><br \
type="attribution"><div dir="ltr">Hi Apache Devs!<div><br></div><div>I started an \
email thread some days ago on the dev mailing list to gather information about \
mod_event, getting tons of interesting things to read. I attached to this email a \
draft of how the new page should look like in my opinion, please let me know your \
thoughts!</div><div><br></div><div>Notes about the \
changes:</div><div><br></div><div><div style="font-size:12.8px">- clear statement \
that event shares all the configuration directives with worker, together with the \
fact that the number of threads is regulated by processes multiplied by threads per \
child.  </div><div style="font-size:12.8px"><br></div><div style="font-size:12.8px">- \
explanation of the new async connections fields in mod_status.  </div><div \
style="font-size:12.8px"><br></div><div style="font-size:12.8px">- tried to add all \
the information about keep alives, writing and closing connections that I&#39;ve \
gathered so far. I added a disclaimer for the writing ones and a big section called \
&quot;limitations&quot;, but I have probably failed to describe all the closing ones \
(not only lingering closes I suppose, but I wasn&#39;t sure).</div><div \
style="font-size:12.8px"><br></div><div style="font-size:12.8px">- clear logic \
connection between how it works and the &quot;AsyncRequestWorkerFactor&quot; \
directive section (I am referring to the sentence &quot;The event MPM handles some \
connections in an asynchronous way&quot;).</div></div><div \
style="font-size:12.8px"><br></div><div style="font-size:12.8px">Apologies for \
technical inaccuracies and/or typos!</div><div \
style="font-size:12.8px"><br></div><div style="font-size:12.8px">Luca</div></div> \
</div></div></div> </blockquote></div><br></div>



[prev in list] [next in list] [prev in thread] [next in thread]