docs: mention when increasing http.postBuffer is valuable
commit7a2dc95cbc25b4b82cff35931f69f8a5aafeb878
authorbrian m. carlson <sandals@crustytoothpaste.net>
Wed, 22 Jan 2020 03:45:43 +0000 (22 03:45 +0000)
committerJunio C Hamano <gitster@pobox.com>
Wed, 22 Jan 2020 20:27:49 +0000 (22 12:27 -0800)
treeaa6abf6c1bbfab0f8f2d56d7f7b43e00ce82930c
parent1b13e9032f039c8cdb1994dd092ff2ed32af5cf5
docs: mention when increasing http.postBuffer is valuable

Users in a wide variety of situations find themselves with HTTP push
problems.  Oftentimes these issues are due to antivirus software,
filtering proxies, or other man-in-the-middle situations; other times,
they are due to simple unreliability of the network.

However, a common solution to HTTP push problems found online is to
increase http.postBuffer.  This works for none of the aforementioned
situations and is only useful in a small, highly restricted number of
cases: essentially, when the connection does not properly support
HTTP/1.1.

Document when raising this value is appropriate and what it actually
does, and discourage people from using it as a general solution for push
problems, since it is not effective there.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/config/http.txt