Skip to content

Commit 8d20119

Browse files
pszlazakgitster
authored andcommitted
doc: update http.cookieFile with in-memory cookie processing
Documentation only mentions how to read cookies from the given file and how to save them to the file using http.saveCookies. But underlying libcURL allows the HTTP cookies used only in memory; cookies from the server will be accepted and sent back in successive requests within same connection, by using an empty string as the filename. Document this. Signed-off-by: Piotr Szlazak <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 557ae14 commit 8d20119

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

Documentation/config/http.txt

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,12 +82,16 @@ http.cookieFile::
8282
in the Git http session, if they match the server. The file format
8383
of the file to read cookies from should be plain HTTP headers or
8484
the Netscape/Mozilla cookie file format (see `curl(1)`).
85+
Set it to an empty string, to accept only new cookies from
86+
the server and send them back in successive requests within same
87+
connection.
8588
NOTE that the file specified with http.cookieFile is used only as
8689
input unless http.saveCookies is set.
8790

8891
http.saveCookies::
8992
If set, store cookies received during requests to the file specified by
90-
http.cookieFile. Has no effect if http.cookieFile is unset.
93+
http.cookieFile. Has no effect if http.cookieFile is unset, or set to
94+
an empty string.
9195

9296
http.version::
9397
Use the specified HTTP protocol version when communicating with a server.

0 commit comments

Comments
 (0)