Commit 109e94c5 authored by Daniel Stenberg's avatar Daniel Stenberg
Browse files

docs: this is for 7.37.0 

And clarify for curl that --proxy-header now must be used for headers
that are meant for a proxy, and they will not be included if the request
is not for a proxy.
parent 74851340

docs/curl.1

+22 −16
Original line number Diff line number Diff line
@@ -678,16 +678,16 @@ If this option is used several times, only the first one is used. This is 
because undoing a GET doesn't make sense, but you should then instead enforce

the alternative method you prefer.

.IP "-H, --header <header>"

(HTTP) Extra header to use when getting a web page. You may specify any number

of extra headers. Note that if you should add a custom header that has the

same name as one of the internal ones curl would use, your externally set

header will be used instead of the internal one. This allows you to make even

trickier stuff than curl would normally do. You should not replace internally

set headers without knowing perfectly well what you're doing. Remove an

internal header by giving a replacement without content on the right side of

the colon, as in: -H \&"Host:". If you send the custom header with no-value

then its header must be terminated with a semicolon, such as \-H

\&"X-Custom-Header;" to send "X-Custom-Header:".

(HTTP) Extra header to include in the request when sending HTTP to a

server. You may specify any number of extra headers. Note that if you should

add a custom header that has the same name as one of the internal ones curl

would use, your externally set header will be used instead of the internal

one. This allows you to make even trickier stuff than curl would normally

do. You should not replace internally set headers without knowing perfectly

well what you're doing. Remove an internal header by giving a replacement

without content on the right side of the colon, as in: -H \&"Host:". If you

send the custom header with no-value then its header must be terminated with a

semicolon, such as \-H \&"X-Custom-Header;" to send "X-Custom-Header:".



curl will make sure that each header you add/replace is sent with the proper

end-of-line marker, you should thus \fBnot\fP add that as a part of the header
@@ -696,6 +696,9 @@ for you. 


See also the \fI-A, --user-agent\fP and \fI-e, --referer\fP options.



Starting in 7.37.0, you need \fI--proxy-header\fP to send custom headers

intended for a proxy.



This option can be used multiple times to add/replace/remove multiple headers.

.IP "--hostpubmd5 <md5>"

(SCP/SFTP) Pass a string containing 32 hexadecimal digits. The string should
@@ -1108,20 +1111,23 @@ The Bearer Token and user name are formatted according to RFC 6750. 


If this option is used several times, the last one will be used.

.IP "--proxy-header <header>"

(HTTP) Extra header to use when getting a web page with a proxy. You may

specify any number of extra headers. This is the equivalent option to \fI-H,

--header\fP but is for proxy communication only like in CONNECT requests when

you want a separate header sent to the proxy to what is sent to the actual

remote host.

(HTTP) Extra header to include in the request when sending HTTP to a

proxy. You may specify any number of extra headers. This is the equivalent

option to \fI-H, --header\fP but is for proxy communication only like in

CONNECT requests when you want a separate header sent to the proxy to what is

sent to the actual remote host.



curl will make sure that each header you add/replace is sent with the proper

end-of-line marker, you should thus \fBnot\fP add that as a part of the header

content: do not add newlines or carriage returns, they will only mess things

up for you.



Headers specified with this option will not be included in requests that curl

knows will not be sent to a proxy.



This option can be used multiple times to add/replace/remove multiple headers.



(Added in 7.36.0)

(Added in 7.37.0)

.IP "-p, --proxytunnel"

When an HTTP proxy is used (\fI-x, --proxy\fP), this option will cause non-HTTP

protocols to attempt to tunnel through the proxy instead of merely using it to

docs/libcurl/symbols-in-versions

+4 −4
Original line number Diff line number Diff line
@@ -193,8 +193,8 @@ CURLFTP_CREATE_DIR_RETRY 7.19.4 
CURLGSSAPI_DELEGATION_FLAG      7.22.0

CURLGSSAPI_DELEGATION_NONE      7.22.0

CURLGSSAPI_DELEGATION_POLICY_FLAG 7.22.0

CURLHEADER_SEPARATE             7.36.0

CURLHEADER_UNIFIED              7.36.0

CURLHEADER_SEPARATE             7.37.0

CURLHEADER_UNIFIED              7.37.0

CURLINFO_APPCONNECT_TIME        7.19.0

CURLINFO_CERTINFO               7.19.1

CURLINFO_CONDITION_UNMET        7.19.4
@@ -372,7 +372,7 @@ CURLOPT_GSSAPI_DELEGATION 7.22.0 
CURLOPT_HEADER                  7.1

CURLOPT_HEADERDATA              7.10

CURLOPT_HEADERFUNCTION          7.7.2

CURLOPT_HEADEROPT               7.36.0

CURLOPT_HEADEROPT               7.37.0

CURLOPT_HTTP200ALIASES          7.10.3

CURLOPT_HTTPAUTH                7.10.6

CURLOPT_HTTPGET                 7.8.1
@@ -442,7 +442,7 @@ CURLOPT_PROGRESSFUNCTION 7.1 7.32.0 
CURLOPT_PROTOCOLS               7.19.4

CURLOPT_PROXY                   7.1

CURLOPT_PROXYAUTH               7.10.7

CURLOPT_PROXYHEADER             7.36.0

CURLOPT_PROXYHEADER             7.37.0

CURLOPT_PROXYPASSWORD           7.19.1

CURLOPT_PROXYPORT               7.1

CURLOPT_PROXYTYPE               7.10