cmdline/docs/*.d: switch to using ## instead of .IP

To make the editing easier. To write and to read.

Closes #12667
This commit is contained in:
Daniel Stenberg 2024-01-09 10:36:14 +01:00
parent a859e29a60
commit 89bb115e4a
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
13 changed files with 305 additions and 192 deletions

View file

@ -19,24 +19,26 @@ that this performs URL-encoding.
To be CGI-compliant, the <data> part should begin with a *name* followed
by a separator and a content specification. The <data> part can be passed to
curl using one of the following syntaxes:
.RS
.IP "content"
## content
This makes curl URL-encode the content and pass that on. Just be careful
so that the content does not contain any = or @ symbols, as that makes
the syntax match one of the other cases below!
.IP "=content"
## =content
This makes curl URL-encode the content and pass that on. The preceding =
symbol is not included in the data.
.IP "name=content"
## name=content
This makes curl URL-encode the content part and pass that on. Note that
the name part is expected to be URL-encoded already.
.IP "@filename"
## @filename
This makes curl load data from the given file (including any newlines),
URL-encode that data and pass it on in the POST.
.IP "name@filename"
## name@filename
This makes curl load data from the given file (including any newlines),
URL-encode that data and pass it on in the POST. The name part gets an equal
sign appended, resulting in *name=urlencoded-file-content*. Note that the
name is expected to be URL-encoded already.
.RE
.IP