curl/docs
Viktor Szakats e9a7d4a1c8
windows: use built-in _WIN32 macro to detect Windows
Windows compilers define `_WIN32` automatically. Windows SDK headers
or build env defines `WIN32`, or we have to take care of it. The
agreement seems to be that `_WIN32` is the preferred practice here.
Make the source code rely on that to detect we're building for Windows.

Public `curl.h` was using `WIN32`, `__WIN32__` and `CURL_WIN32` for
Windows detection, next to the official `_WIN32`. After this patch it
only uses `_WIN32` for this. Also, make it stop defining `CURL_WIN32`.

There is a slight chance these break compatibility with Windows
compilers that fail to define `_WIN32`. I'm not aware of any obsolete
or modern compiler affected, but in case there is one, one possible
solution is to define this macro manually.

grepping for `WIN32` remains useful to discover Windows-specific code.

Also:

- extend `checksrc` to ensure we're not using `WIN32` anymore.

- apply minor formatting here and there.

- delete unnecessary checks for `!MSDOS` when `_WIN32` is present.

Co-authored-by: Jay Satiro
Reviewed-by: Daniel Stenberg

Closes #12376
2023-11-22 15:42:25 +00:00
..
cmdline-opts resolve.d: drop a multi use-sentence 2023-11-08 12:40:24 +01:00
examples windows: use built-in _WIN32 macro to detect Windows 2023-11-22 15:42:25 +00:00
libcurl windows: use built-in _WIN32 macro to detect Windows 2023-11-22 15:42:25 +00:00
.gitignore copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
ALTSVC.md altsvc: accept and parse IPv6 addresses in response headers 2023-08-28 17:08:42 +02:00
BINDINGS.md BINDINGS: add V binding 2023-10-23 07:57:31 +02:00
BUFQ.md tidy-up: mostly whitespace nits 2023-08-31 23:02:10 +00:00
BUFREF.md
BUG-BOUNTY.md docs: link to the website versions instead of markdowns 2023-08-02 00:47:41 +02:00
BUGS.md tidy-up: mostly whitespace nits 2023-08-31 23:02:10 +00:00
CHECKSRC.md
CIPHERS.md
CMakeLists.txt copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
CODE_OF_CONDUCT.md docs: Update to secure URL versions 2017-09-04 14:08:54 +00:00
CODE_REVIEW.md
CODE_STYLE.md
CONNECTION-FILTERS.md
CONTRIBUTE.md docs: rewrite to present tense 2023-08-23 23:26:10 +02:00
curl-config.1
CURL-DISABLE.md lib: add ability to disable auths individually 2023-09-07 17:45:06 +02:00
DEPRECATE.md
DYNBUF.md docs: rewrite to present tense 2023-08-23 23:26:10 +02:00
EARLY-RELEASE.md
EXPERIMENTAL.md HTTP3: ngtcp2 builds are no longer experimental 2023-10-31 14:31:46 +01:00
FAQ
FEATURES.md FEATURES: update the URL phrasing 2023-11-22 13:26:51 +01:00
GOVERNANCE.md
HELP-US.md docs: rewrite to present tense 2023-08-23 23:26:10 +02:00
HISTORY.md docs: rewrite to present tense 2023-08-23 23:26:10 +02:00
HSTS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
HTTP2.md
HTTP3.md
HTTP-COOKIES.md docs: use a space after RFC when spelling out RFC numbers 2023-07-09 19:13:33 +02:00
HYPER.md
INSTALL
INSTALL.cmake
INSTALL.md build: require Windows XP or newer 2023-10-30 10:46:40 +00:00
INTERNALS.md gskit: remove 2023-08-07 20:57:48 +02:00
IPFS.md
KNOWN_BUGS docs: KNOWN_BUGS cleanup 2023-11-05 10:39:32 +01:00
MAIL-ETIQUETTE
Makefile.am docs: preserve the modification date when copying the prebuilt man page 2023-11-04 19:39:48 +01:00
MANUAL.md
mk-ca-bundle.1
MQTT.md
NEW-PROTOCOL.md docs: minor grammar fixes 2022-09-29 10:44:12 +02:00
options-in-versions curl: add support for the IPFS protocols: 2023-09-23 11:02:10 +02:00
PARALLEL-TRANSFERS.md
README.md
RELEASE-PROCEDURE.md
ROADMAP.md spellcheck.words: remove 'github' as an accepted word 2022-10-27 15:53:11 +02:00
RUSTLS.md rustls: update rustls-ffi 0.10.0 2023-07-22 23:40:44 +02:00
SECURITY-ADVISORY.md
SSL-PROBLEMS.md
SSLCERTS.md nss: remove support for this TLS library 2023-07-29 23:44:28 +02:00
THANKS THANKS: add contributors from 8.4.0 2023-10-11 07:34:19 +02:00
THANKS-filter
TheArtOfHttpScripting.md tidy-up: use more example domains 2023-09-29 18:25:56 +00:00
TODO
URL-SYNTAX.md
VERSIONS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
VULN-DISCLOSURE-POLICY.md
WEBSOCKET.md

curl logo

Documentation

you will 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.