curl/docs
Viktor Szakats 1db9af2b9e
cmake: tweaks around debug mode and hidden symbols
- emit warning for `ENABLE_DEBUG` builds.

- add words to clarify that `ENABLE_DEBUG` is meant for developing curl
  itself.

- add comment saying `CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS=ON`
  CMake option may export extra, non-curl symbols.
  Ref: https://github.com/microsoft/vcpkg/issues/41761
  Unexplained exports seen also in curl CI:
  ```
  [ 742] _tcschr
  [ 743] _tcsncmp
  [ 744] _tcsncpy
  [ 745] _tcspbrk
  ```
  https://ci.appveyor.com/project/curlorg/curl/builds/50864041/job/lolledrg4h7hu6e4?fullLog=true#L2160
  CMake extracts these symbols from `.obj` files:
  https://gitlab.kitware.com/cmake/cmake/-/issues/22092#note_943718
  I have not found any new MSVC option that helps fixing this without
  decorating all functions in-source or maintaining a manual list of
  internal function names used for tests:
  https://learn.microsoft.com/cpp/build/reference/wholearchive-include-all-library-object-files

Closes #15414
2024-10-27 14:26:45 +01:00
..
cmdline-opts docs: clarify FTP over HTTP proxy functionality somewhat 2024-10-26 23:45:32 +02:00
examples GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02:00
internals GHA: silence proselint warnings and an error 2024-10-15 16:44:17 +02: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
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
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.