Re: [privoxy-devel] pipelining setting

[Lee <le...@gm...>]

On 6/29/13, Fabian Keil <fk...@fa...> wrote:
> Lee <le...@gm...> wrote:
>
>> On 6/28/13, Robert Max Jackson <rob...@ny...> 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