]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
docs/HTTP-COOKIES.md: link to more information
authorDaniel Stenberg <daniel@haxx.se>
Wed, 1 Jan 2025 20:18:11 +0000 (21:18 +0100)
committerDaniel Stenberg <daniel@haxx.se>
Wed, 1 Jan 2025 21:45:48 +0000 (22:45 +0100)
Closes #15891

docs/HTTP-COOKIES.md

index 38432d273f4347731447b515101740484004bfb2..62905dbc6c192994e02446fe914a284246785493 100644 (file)
@@ -103,69 +103,69 @@ SPDX-License-Identifier: curl
 
   Command line options:
 
-  `-b, --cookie`
+  [`-b, --cookie`](https://curl.se/docs/manpage.html#-b)
 
   tell curl a file to read cookies from and start the cookie engine, or if it
   is not a file it passes on the given string. `-b name=var` works and so does
   `-b cookiefile`.
 
-  `-j, --junk-session-cookies`
+  [`-j, --junk-session-cookies`](https://curl.se/docs/manpage.html#-j)
 
   when used in combination with -b, it skips all "session cookies" on load so
   as to appear to start a new cookie session.
 
-  `-c, --cookie-jar`
+  [`-c, --cookie-jar`](https://curl.se/docs/manpage.html#-c)
 
   tell curl to start the cookie engine and write cookies to the given file
   after the request(s)
 
 ## Cookies with libcurl
 
-  libcurl offers several ways to enable and interface the cookie engine. These
-  options are the ones provided by the native API. libcurl bindings may offer
-  access to them using other means.
+libcurl offers several ways to enable and interface the cookie engine. These
+options are the ones provided by the native API. libcurl bindings may offer
+access to them using other means.
 
-  `CURLOPT_COOKIE`
+[`CURLOPT_COOKIE`](https://curl.se/libcurl/c/CURLOPT_COOKIE.html)
 
-  Is used when you want to specify the exact contents of a cookie header to
-  send to the server.
+Is used when you want to specify the exact contents of a cookie header to
+send to the server.
 
-  `CURLOPT_COOKIEFILE`
+[`CURLOPT_COOKIEFILE`](https://curl.se/libcurl/c/CURLOPT_COOKIEFILE.html)
 
-  Tell libcurl to activate the cookie engine, and to read the initial set of
-  cookies from the given file. Read-only.
+Tell libcurl to activate the cookie engine, and to read the initial set of
+cookies from the given file. Read-only.
 
-  `CURLOPT_COOKIEJAR`
+[`CURLOPT_COOKIEJAR`](https://curl.se/libcurl/c/CURLOPT_COOKIEJAR.html)
 
-  Tell libcurl to activate the cookie engine, and when the easy handle is
-  closed save all known cookies to the given cookie jar file. Write-only.
+Tell libcurl to activate the cookie engine, and when the easy handle is
+closed save all known cookies to the given cookie jar file. Write-only.
 
-  `CURLOPT_COOKIELIST`
+[`CURLOPT_COOKIELIST`](https://curl.se/libcurl/c/CURLOPT_COOKIELIST.html)
 
-  Provide detailed information about a single cookie to add to the internal
-  storage of cookies. Pass in the cookie as an HTTP header with all the
-  details set, or pass in a line from a Netscape cookie file. This option can
-  also be used to flush the cookies etc.
+Provide detailed information about a single cookie to add to the internal
+storage of cookies. Pass in the cookie as an HTTP header with all the
+details set, or pass in a line from a Netscape cookie file. This option can
+also be used to flush the cookies etc.
 
-  `CURLOPT_COOKIESESSION`
+[`CURLOPT_COOKIESESSION`](https://curl.se/libcurl/c/CURLOPT_COOKIESESSION.html)
 
-  Tell libcurl to ignore all cookies it is about to load that are session
-  cookies.
+Tell libcurl to ignore all cookies it is about to load that are session
+cookies.
 
-  `CURLINFO_COOKIELIST`
+[`CURLINFO_COOKIELIST`](https://curl.se/libcurl/c/CURLINFO_COOKIELIST.html)
 
-  Extract cookie information from the internal cookie storage as a linked
-  list.
+Extract cookie information from the internal cookie storage as a linked
+list.
 
 ## Cookies with JavaScript
 
-  These days a lot of the web is built up by JavaScript. The web browser loads
-  complete programs that render the page you see. These JavaScript programs
-  can also set and access cookies.
+These days a lot of the web is built up by JavaScript. The web browser loads
+complete programs that render the page you see. These JavaScript programs
+can also set and access cookies.
 
-  Since curl and libcurl are plain HTTP clients without any knowledge of or
-  capability to handle JavaScript, such cookies are not detected or used.
+Since curl and libcurl are plain HTTP clients without any knowledge of or
+capability to handle JavaScript, such cookies are not detected or used.
 
-  Often, if you want to mimic what a browser does on such websites, you can
-  record web browser HTTP traffic when using such a site and then repeat the
-  cookie operations using curl or libcurl.
+Often, if you want to mimic what a browser does on such websites, you can
+record web browser HTTP traffic when using such a site and then repeat the
+cookie operations using curl or libcurl.