summaryrefslogtreecommitdiffstats
path: root/doc/http.n
diff options
context:
space:
mode:
authorkjnash <k.j.nash@usa.net>2022-05-11 19:05:33 (GMT)
committerkjnash <k.j.nash@usa.net>2022-05-11 19:05:33 (GMT)
commit355490c37c7a596e846ffeb26c4d82f2dfed9d37 (patch)
tree65aa25164056a9b59f70b1b758b6f73888a1caab /doc/http.n
parentb9ef9f9cefccc2ef851149acbd14c280dd70e622 (diff)
downloadtcl-355490c37c7a596e846ffeb26c4d82f2dfed9d37.zip
tcl-355490c37c7a596e846ffeb26c4d82f2dfed9d37.tar.gz
tcl-355490c37c7a596e846ffeb26c4d82f2dfed9d37.tar.bz2
Revise http(n) to fix #6afa947d1a
Diffstat (limited to 'doc/http.n')
-rw-r--r--doc/http.n12
1 files changed, 10 insertions, 2 deletions
diff --git a/doc/http.n b/doc/http.n
index 47ed057..b5197a9 100644
--- a/doc/http.n
+++ b/doc/http.n
@@ -306,8 +306,16 @@ multiple requests. Default is 0.
\fB\-method\fR \fItype\fR
.
Force the HTTP request method to \fItype\fR. \fB::http::geturl\fR will
-auto-select GET, POST or HEAD based on other options, but this option
-enables choices like PUT and DELETE for webdav support.
+auto-select GET, POST or HEAD based on other options, but this option overrides
+that selection and enables choices like PUT and DELETE for WebDAV support.
+.RS
+.PP
+It is the caller's responsibility to ensure that the headers and request body
+(if any) conform to the requirements of the request method. For example, if
+using \fB\-method\fR \fIPOST\fR to send a POST with an empty request body, the
+caller must also supply the option
+.QW "-headers {Content-Length 0}" .
+.RE
.TP
\fB\-myaddr\fR \fIaddress\fR
.