]> git.ipfire.org Git - thirdparty/curl.git/commit
docs: add CURLOPT type change history, drop casts where present
authorViktor Szakats <commit@vsz.me>
Fri, 1 Aug 2025 10:49:40 +0000 (12:49 +0200)
committerViktor Szakats <commit@vsz.me>
Fri, 1 Aug 2025 22:05:33 +0000 (00:05 +0200)
commitd01d2ec9f1039e94f8d6bbfd216fae4d9bde9ba6
treef3b9ad4b8718ecfcdd721b717728e05fe2087458
parentd1da9543f86a1356976e17aa7dc8e8b4fef09e2b
docs: add CURLOPT type change history, drop casts where present

Some CURLOPT constants defined in the curl public headers were initially
enums (= ints), or macros with bare numeric values. Recent curl releases
upgraded them to `long` constants, to make them pass correctly to
`curl_easy_setop()` by default, i.e. without requiring a `(long)` cast.

This patch drops such casts from the examples embedded in the docs. At
the same time it documents which curl release made them `long` types,
to keep them useful when working with previous libcurl versions.

Also:
- drop a `(long)` cast that was never necessary.
- CURLOPT_ALTSVC_CTRL.md: bump local copy of macros to long.
- test1119: make it ignore symbols ending with an underscore, to skip
  wildcard, e.g. `**CURLAUTH_***`.

Closes #18130
37 files changed:
.github/scripts/spellcheck.words
docs/libcurl/opts/CURLINFO_CONDITION_UNMET.md
docs/libcurl/opts/CURLOPT_ALTSVC.md
docs/libcurl/opts/CURLOPT_ALTSVC_CTRL.md
docs/libcurl/opts/CURLOPT_FTPSSLAUTH.md
docs/libcurl/opts/CURLOPT_FTP_CREATE_MISSING_DIRS.md
docs/libcurl/opts/CURLOPT_FTP_FILEMETHOD.md
docs/libcurl/opts/CURLOPT_FTP_SSL_CCC.md
docs/libcurl/opts/CURLOPT_GSSAPI_DELEGATION.md
docs/libcurl/opts/CURLOPT_HEADEROPT.md
docs/libcurl/opts/CURLOPT_HSTS_CTRL.md
docs/libcurl/opts/CURLOPT_HTTPAUTH.md
docs/libcurl/opts/CURLOPT_HTTP_VERSION.md
docs/libcurl/opts/CURLOPT_IPRESOLVE.md
docs/libcurl/opts/CURLOPT_MIME_OPTIONS.md
docs/libcurl/opts/CURLOPT_NETRC.md
docs/libcurl/opts/CURLOPT_NETRC_FILE.md
docs/libcurl/opts/CURLOPT_POSTFIELDSIZE.md
docs/libcurl/opts/CURLOPT_POSTREDIR.md
docs/libcurl/opts/CURLOPT_PROTOCOLS.md
docs/libcurl/opts/CURLOPT_PROXYAUTH.md
docs/libcurl/opts/CURLOPT_PROXYTYPE.md
docs/libcurl/opts/CURLOPT_PROXY_SSLVERSION.md
docs/libcurl/opts/CURLOPT_PROXY_SSL_OPTIONS.md
docs/libcurl/opts/CURLOPT_REDIR_PROTOCOLS.md
docs/libcurl/opts/CURLOPT_RTSP_REQUEST.md
docs/libcurl/opts/CURLOPT_RTSP_TRANSPORT.md
docs/libcurl/opts/CURLOPT_SOCKS5_AUTH.md
docs/libcurl/opts/CURLOPT_SSH_AUTH_TYPES.md
docs/libcurl/opts/CURLOPT_SSLVERSION.md
docs/libcurl/opts/CURLOPT_SSL_OPTIONS.md
docs/libcurl/opts/CURLOPT_TIMECONDITION.md
docs/libcurl/opts/CURLOPT_TIMEVALUE.md
docs/libcurl/opts/CURLOPT_TIMEVALUE_LARGE.md
docs/libcurl/opts/CURLOPT_USE_SSL.md
docs/libcurl/opts/CURLOPT_WS_OPTIONS.md
tests/test1119.pl