[PATCH] doc: update http.cookieFile with in-memory cookie processing

From: Piotr Szlazak via GitGitGadget <gitgitgadget@gmail.com>
Date: Jun 23, 2024, 21:24 UTC
Message-ID: <pull.1733.git.git.1719177846725.gitgitgadget@gmail.com>

From: Piotr Szlazak <piotr.szlazak@gmail.com>

Information added how to enable in-memory cookies processing. Cookies from server will be accepted and send back in successive requests within same connection.

At the moment documentation only mentions how to read cookies from the given file and how to save them to the file using http.saveCookies.

curl / libcurl will process cookies in memory if file name is blank. Check curl manpage: https://curl.se/docs/manpage.html#-b This is described here in more details: https://everything.curl.dev/http/cookies/engine.html And also explained here: https://www.youtube.com/watch?v=V5vZWHP-RqU&t=11459s

Git documentation was updated to include suggestion how to enable this by setting empty value for http.cookieFile.

Signed-off-by: Piotr Szlazak <piotr.szlazak@gmail.com>
---
    Update http.cookieFile with in-memory cookie processing

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1733%2Fpszlazak%2Fdocumentation-cookieFile-in-memory-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1733/pszlazak/documentation-cookieFile-in-memory-v1
Pull-Request: https://github.com/git/git/pull/1733

 Documentation/config/http.txt | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/config/http.txt b/Documentation/config/http.txt
index 2d4e0c9b869..228bed32ec1 100644
--- a/Documentation/config/http.txt
+++ b/Documentation/config/http.txt
@@ -78,10 +78,10 @@ http.extraHeader::
 
 http.cookieFile::
 	The pathname of a file containing previously stored cookie lines,
-	which should be used
-	in the Git http session, if they match the server. The file format
-	of the file to read cookies from should be plain HTTP headers or
-	the Netscape/Mozilla cookie file format (see `curl(1)`).
+	which should be used in the Git http session, if they match the server.
+	The file format of the file to read cookies from should be plain HTTP
+	headers or the Netscape/Mozilla cookie file format (see `curl(1)`).
+	Set it to empty value, to enable in-memory cookies processing.
 	NOTE that the file specified with http.cookieFile is used only as
 	input unless http.saveCookies is set.
 

base-commit: 66ac6e4bcd111be3fa9c2a6b3fafea718d00678d

-- 
gitgitgadget