Skip to content

docs: add CURLOPT type change history, drop casts where present#18130

Closed
vszakats wants to merge 46 commits intocurl:masterfrom
vszakats:docslong
Closed

docs: add CURLOPT type change history, drop casts where present#18130
vszakats wants to merge 46 commits intocurl:masterfrom
vszakats:docslong

Conversation

@vszakats
Copy link
Copy Markdown
Member

@vszakats vszakats commented Aug 1, 2025

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_***.

@vszakats vszakats changed the title docs: add type change history, drop casts where present docs: add CURLOPT type change history, drop casts where present Aug 1, 2025
@github-actions github-actions bot added the CI Continuous Integration label Aug 1, 2025
@vszakats

This comment was marked as resolved.

@github-actions github-actions bot added the tests label Aug 1, 2025
Comment thread docs/libcurl/opts/CURLOPT_FTP_CREATE_MISSING_DIRS.md Outdated
@vszakats vszakats force-pushed the docslong branch 2 times, most recently from 757d781 to ccc88b7 Compare August 1, 2025 16:56
vszakats added a commit that referenced this pull request Aug 1, 2025
In curl/curl.h and the man page. To match the rest of CURLOPT macros.

Cherry-picked from #18130
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Development

Successfully merging this pull request may close these issues.

2 participants