curl/docs
Jay Satiro cec47daa8c write-out.d: clarify Windows % symbol escaping
- Clarify that in Windows batch files the % must be escaped as %%, and
  at the command prompt it cannot be escaped which could lead to
  incorrect expansion.

Prior to this change the doc implied % must be escaped as %% in win32
always.

---

Examples showing how a write-out argument is received by curl:

If curl --write-out "%{http_code}" is executed in a batch file:
{http_code}

If curl --write-out "%%{http_code}" is executed in a batch file:
%{http_code}

If curl --write-out "%{http_code}" is executed from the command prompt:
%{http_code}

If curl --write-out "%%{http_code}" is executed from the command prompt:
%%{http_code}

At the command prompt something like "%{speed_download}%{http_code}"
would first be parsed by the command interpreter as %{speed_download}%
and would be expanded as environment variable {speed_download} if it
existed, though that's highly unlikely since Windows environment names
don't use braces.

---

Reported-by: Muhammad Hussein Ammari

Ref: https://github.com/bagder/everything-curl/pull/279

Fixes https://github.com/curl/curl/issues/10323
Closes https://github.com/curl/curl/pull/10337
2023-01-26 18:52:27 -05:00
..
cmdline-opts write-out.d: clarify Windows % symbol escaping 2023-01-26 18:52:27 -05:00
examples copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
libcurl docs: POSTFIELDSIZE must be set to -1 with read function 2023-01-20 10:01:43 -08:00
.gitignore copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
ALTSVC.md docs: minor grammar fixes 2022-09-29 10:44:12 +02:00
BINDINGS.md docs: update sourceforge project links [ci skip] 2022-10-01 18:40:47 +00:00
BUFREF.md docs: spellfixes 2022-09-21 15:20:08 +02:00
BUG-BOUNTY.md BUG-BOUNTY.md: mention the audit exception 2022-05-19 11:14:54 +02:00
BUGS.md docs: minor grammar fixes 2022-09-29 10:44:12 +02:00
CHECKSRC.md docs: spellfixes 2022-09-21 15:20:08 +02:00
CIPHERS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
CMakeLists.txt copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
CODE_OF_CONDUCT.md
CODE_REVIEW.md docs: spellfixes 2022-09-21 15:20:08 +02:00
CODE_STYLE.md scripts: move three scripts from lib/ to scripts/ 2022-03-23 15:26:11 +01:00
CONNECTION-FILTERS.md lib: connection filters (cfilter) addition to curl: 2022-11-11 15:17:51 +01:00
CONTRIBUTE.md misc: typo and grammar fixes 2022-10-27 10:01:30 +02:00
curl-config.1 copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
CURL-DISABLE.md docs: spellfixes 2022-09-21 15:20:08 +02:00
DEPRECATE.md noproxy: support for space-separated names is deprecated 2023-01-04 09:15:37 +01:00
DYNBUF.md docs: spellfixes 2022-09-21 15:20:08 +02:00
EARLY-RELEASE.md docs/EARLY-RELEASE.md: how to determine an early release 2022-11-05 23:52:11 +01:00
EXPERIMENTAL.md openssl: Don't ignore CA paths when using Windows CA store (redux) 2023-01-17 03:32:58 -05:00
FAQ docs: spelling nits 2022-09-29 21:29:04 +00:00
FEATURES.md docs: spellfixes 2022-09-21 15:20:08 +02:00
GOVERNANCE.md misc: typo and grammar fixes 2022-10-27 10:01:30 +02:00
HELP-US.md docs: add link to GitHub Discussions 2023-01-02 00:26:37 +01:00
HISTORY.md docs: spellfixes 2022-09-21 15:20:08 +02:00
HSTS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
HTTP2.md docs: spellfixes 2022-09-21 15:20:08 +02:00
HTTP3.md msh3: update to v0.6 2023-01-10 13:50:08 +01:00
HTTP-COOKIES.md HTTP-COOKIES.md: update the 6265bis link to draft-11 2022-11-18 09:59:33 +01:00
HYPER.md misc: typo and grammar fixes 2022-10-27 10:01:30 +02:00
INSTALL
INSTALL.cmake docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
INSTALL.md docs/INSTALL.md: list OSes and CPUs quoted 2022-11-29 10:28:31 +01:00
INTERNALS.md INTERNALS: cleanup 2022-12-27 10:54:03 +01:00
KNOWN_BUGS cmake: set the soname on the shared library 2022-12-15 12:36:25 +01:00
MAIL-ETIQUETTE docs: remove him/her/he/she from documentation 2022-07-27 13:52:53 +02:00
Makefile.am copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
MANUAL.md MANUAL.md: add pipe to apt-key example 2022-12-28 09:19:02 +01:00
mk-ca-bundle.1 copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
MQTT.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
NEW-PROTOCOL.md docs: minor grammar fixes 2022-09-29 10:44:12 +02:00
options-in-versions src: add --http3-only 2023-01-12 16:18:05 +01:00
PARALLEL-TRANSFERS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
README.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
RELEASE-PROCEDURE.md docs: spellfixes 2022-09-21 15:20:08 +02:00
ROADMAP.md spellcheck.words: remove 'github' as an accepted word 2022-10-27 15:53:11 +02:00
RUSTLS.md misc: typo and grammar fixes 2022-10-27 10:01:30 +02:00
SECURITY-PROCESS.md SECURITY-PROCESS.md: document severity levels 2022-12-21 16:26:35 +01:00
SSL-PROBLEMS.md misc: typo and grammar fixes 2022-10-27 10:01:30 +02:00
SSLCERTS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
THANKS THANKS: 40 new contributors from 7.87.0 2022-12-21 08:00:59 +01:00
THANKS-filter copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
TheArtOfHttpScripting.md docs: spellfixes 2022-09-21 15:20:08 +02:00
TODO misc: Fix incorrect spelling 2022-12-06 23:18:23 +01:00
URL-SYNTAX.md test1275: verify upercase after period in markdown 2022-10-12 14:19:50 +02:00
VERSIONS.md docs: spellfixes 2022-09-21 15:20:08 +02:00
WEBSOCKET.md copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00

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.