diff options
Diffstat (limited to 'doc/http.n')
| -rw-r--r-- | doc/http.n | 15 |
1 files changed, 8 insertions, 7 deletions
@@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: http.n,v 1.26 2007/10/24 14:29:38 dkf Exp $ +'\" RCS: @(#) $Id: http.n,v 1.27 2007/10/26 20:11:53 dgp Exp $ '\" .so man.macros .TH "http" n 2.5 http "Tcl Bundled Packages" @@ -89,8 +89,7 @@ flags and values that define the configuration: The Accept header of the request. The default is */*, which means that all types of documents are accepted. Otherwise you can supply a comma-separated list of mime type patterns that you are -willing to receive. For example, -.QW "image/gif, image/jpeg, text/*" . +willing to receive. For example, "image/gif, image/jpeg, text/*". .TP \fB\-proxyhost\fR \fIhostname\fR The name of the proxy host, if any. If this value is the @@ -121,8 +120,7 @@ characters. .TP \fB\-useragent\fR \fIstring\fR The value of the User-Agent header in the HTTP request. The default -is -.QW "\fBTcl http client package 2.5\fR" . +is \fB"Tcl http client package 2.4."\fR .RE .TP \fB::http::geturl\fR \fIurl\fR ?\fIoptions\fR? @@ -342,6 +340,7 @@ set token [::http::geturl https://my.secure.site/] \fB::http::unregister\fR \fIproto\fR This procedure unregisters a protocol handler that was previously registered via \fB::http::register\fR. + .SH "ERRORS" The \fB::http::geturl\fR procedure will raise errors in the following cases: invalid command line options, @@ -386,8 +385,7 @@ If the HTTP transaction completes entirely, then status will be \fBok\fR. However, you should still check the \fB::http::code\fR value to get the HTTP status. The \fB::http::ncode\fR procedure provides just the numeric error (e.g., 200, 404 or 500) while the \fB::http::code\fR -procedure returns a value like -.QW "HTTP 404 File not found" . +procedure returns a value like "HTTP 404 File not found". .TP eof If the server closes the socket without replying, then no error @@ -406,6 +404,7 @@ transaction. If it can read the server's response it will end up with an \fBok\fR status, otherwise it will have an \fBeof\fR status. + .SH "STATE ARRAY" The \fB::http::geturl\fR procedure returns a \fItoken\fR that can be used to get to the state of the HTTP transaction in the form of a Tcl array. @@ -535,7 +534,9 @@ proc httpCopyProgress {args} { flush stderr } .CE + .SH "SEE ALSO" safe(n), socket(n), safesock(n) + .SH KEYWORDS security policy, socket |