curl/docs
Viktor Szakats fb711b5098
build: fix clang-cl builds, add CI job
- appveyor: add build-only job for clang-cl.

- cmake: `-pedantic-errors` enables `-Werror,-Wlanguage-extension-token`
  automatically, which makes `__int64` detection fail.
  Explictly disable this compiler warning for clang-cl to make the
  feature detection work and to accept `__int64` in the source code.

- cmake: disable `-Wlanguage-extension-token` warning for clang-cl
  to fix these when encountering `__int64`:
  ```
  lib/formdata.c(797,29): error : extension used [-Werror,-Wlanguage-extension-token]
  lib/warnless.c(117,33): error : extension used [-Werror,-Wlanguage-extension-token]
  lib/warnless.c(60,28): message : expanded from macro 'CURL_MASK_SCOFFT'
  lib/warnless.c(59,38): message : expanded from macro 'CURL_MASK_UCOFFT'
  include\curl/system.h(352,40): message : expanded from macro 'CURL_TYPEOF_CURL_OFF_T'
  ```

- make `__GNUC__` warning suppressions apply to `__clang__` too.
  Necessary for clang-cl, which defines the latter, but not the former.
  (Regular clang defines both.)

- examples: fix clang-cl compiler warning in `http2-upload.c`.
  ```
  docs\examples\http2-upload.c(56,5): error : no previous prototype for function 'my_gettimeofday' [-Werror,-Wmissing-prototypes]
  docs\examples\http2-upload.c(56,1): message : declare 'static' if the function is not intended to be used outside of this translation unit
  ```

- unit2604: add missing `#pragma GCC diagnostic pop`.
  Follow-up to e53523fef0 #14859

- unit1652: limit compiler warning suppression to GCC.
  They do not affect clang builds.
  Follow-up to 71cf0d1fca #14772

Closes #15449
2024-10-30 23:15:32 +01:00
..
cmdline-opts docs: clarify FTP over HTTP proxy functionality somewhat 2024-10-26 23:45:32 +02:00
examples build: fix clang-cl builds, add CI job 2024-10-30 23:15:32 +01:00
internals tidy-up: whitespace, fix CI spacecheck for docs 2024-10-30 23:15:28 +01:00
libcurl docs: clarify FTP over HTTP proxy functionality somewhat 2024-10-26 23:45:32 +02:00
.gitignore
BINDINGS.md
BUG-BOUNTY.md
BUGS.md
CIPHERS-TLS12.md
CIPHERS.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
CMakeLists.txt cmake: replace CURL_*_DIR with {PROJECT,CMAKE_CURRENT}_*_DIR 2024-10-22 19:13:08 +02:00
CODE_OF_CONDUCT.md
CODE_REVIEW.md
CONTRIBUTE.md CONTRIBUTE: polished 2024-08-26 15:04:01 +02:00
curl-config.md
CURL-DISABLE.md cmake: document -D and env build options 2024-10-24 23:06:40 +02:00
CURLDOWN.md
DEPRECATE.md DEPRECATE: remove hyper in January 2025 2024-10-03 10:51:27 +02:00
DISTROS.md DISTROS: avoid use of "very" 2024-10-17 13:36:33 +02:00
EARLY-RELEASE.md
ECH.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
EXPERIMENTAL.md WebSockets: make support official (non-experimental) 2024-09-27 13:20:25 +02:00
FAQ
FEATURES.md FEATURES.md: fix typo 2024-08-23 08:46:09 +02:00
GOVERNANCE.md
HELP-US.md
HISTORY.md
HTTP3.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
HTTP-COOKIES.md
INSTALL
INSTALL-CMAKE.md cmake: tweaks around debug mode and hidden symbols 2024-10-27 14:26:45 +01:00
INSTALL.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
INTERNALS.md
IPFS.md
KNOWN_BUGS KNOWN_BUGS: LDFLAGS passed too late 2024-10-18 11:52:30 +02:00
MAIL-ETIQUETTE.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
Makefile.am
MANUAL.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
mk-ca-bundle.md
options-in-versions TLS: TLSv1.3 earlydata support for curl 2024-10-11 12:28:22 +02:00
README.md
RELEASE-PROCEDURE.md
ROADMAP.md
RUSTLS.md vtls/rustls: support strong CSRNG data 2024-09-13 14:11:56 +02:00
SECURITY-ADVISORY.md
SPONSORS.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
SSL-PROBLEMS.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
SSLCERTS.md curl: add options for safe/no CA bundle search (Windows) 2024-09-22 18:17:25 +02:00
THANKS THANKS: cleanup duplicates 2024-09-25 09:54:09 +02:00
THANKS-filter RELEASE-NOTES: synced 2024-10-18 10:13:38 +02:00
TheArtOfHttpScripting.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
TODO cmake: drop obsolete items from TODO and INSTALL-CMAKE 2024-10-24 19:13:10 +02:00
URL-SYNTAX.md GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
VERSIONS.md
VULN-DISCLOSURE-POLICY.md

curl logo

Documentation

You find a mix of various documentation in this directory and subdirectories, using several different formats. Some of them are not ideal for reading directly in your browser.

If you would rather see the rendered version of the documentation, check out the curl website's documentation section for general curl stuff or the libcurl section for libcurl related documentation.