Re: pipelining setting

Lee <[email protected]>
Newsgroups gmane.comp.web.privoxy.devel
Message-ID <CAD8GWssJERHK48JSA3S5RocM=rg_rYP795GvJMjwtTtym-ADfg@mail.gmail.com>
On 6/29/13, Fabian Keil <[email protected]> wrote:
> Lee <[email protected]> wrote:
>
>> On 6/28/13, Robert Max Jackson <[email protected]> wrote:
>> >     For Privoxy version 3.0.21, after rereading sections 6.5 of
>> > config.txt on tolerate-pipelining repeatedly, I cannot figure out
>> > which setting, 0 or 1, tolerates pipelining.  (I fear the
>> > documentation here is completely ambiguous, at least for those not
>> > familiar with whatever linguistic assumptions would make it
>> > unambiguous.)
>> >
>> >     Could someone clarify?
>>
>> 0: privoxy does not handle pipelined requests
>> 1: privoxy attempts to handle pipelined requests from the client (eg.
>> firefox)
>>
>> #  Effect if unset:
>> #
>> #      If Privoxy receives more than one request at once, it
>> #      terminates the client connection after serving the first one.
>>
>> I'm so used to 1 is the same thing as "set" and 0 is "clear" or
>> "unset" that it's hard for me to imagine someone not knowing that --
>> assuming that is the problem with the documentation.
>>
>> How would you change the documentation to make it clear that
>> 0 = client pipelining is not allowed
>> 1 = client pipelining allowed
>
> I suppose we could change "This option lets Privoxy tolerate pipelining."
> to something like "Setting this directive to 1 lets ...".

What do you think of changing the name to "allow-pipelining"?

tolerate roughly equals put up with; as in you might not like it but
you will put up with it.  So while I will tolerate my son staying up
until 4am and sleeping until noon, he is not allowed to make enough
noise to wake me up :)  Changing the name to "allow-pipelining" might
make the purpose of the keyword a bit clearer.

>> Fabian - is this bit correct?
>>
>> #  Default value:
>> #
>> #      None
>>
>> sure looks like the default is 0
>
> In the config file "None", "Unset" and "0" currently refer to the same
> numeric default value. I wouldn't be opposed to consistently using "0".

0 would be better.  None implies neither 0 or 1
Want me to do it?  Changes would be to current/doc/source/p-config.sgml - right?

Lee

------------------------------------------------------------------------------
This SF.net email is sponsored by Windows:

Build for Windows Store.

http://p.sf.net/sfu/windows-dev2dev
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.