summaryrefslogtreecommitdiffstats
path: root/doc/http.n
diff options
context:
space:
mode:
authorhobbs <hobbs>2004-05-25 22:50:46 (GMT)
committerhobbs <hobbs>2004-05-25 22:50:46 (GMT)
commitbde979906035bbdc9ff1001cb4a4b64a5dd6b813 (patch)
tree3773b90b5f652f7c9a3ae818597690d3ad138bc2 /doc/http.n
parentf54b39a2a3db59321f0fef9bed7f1606156deb1a (diff)
downloadtcl-bde979906035bbdc9ff1001cb4a4b64a5dd6b813.zip
tcl-bde979906035bbdc9ff1001cb4a4b64a5dd6b813.tar.gz
tcl-bde979906035bbdc9ff1001cb4a4b64a5dd6b813.tar.bz2
* doc/http.n (http::config): add -urlencoding option (default utf-8)
* library/http/http.tcl: that specifies encoding conversion of * library/http/pkgIndex.tcl: args for http::formatQuery. Previously * tests/http.test: undefined, RFC 2718 says it should be utf-8. 'http::config -urlencoding {}' returns previous behavior, which will throw errors processing non-latin-1 chars. Bumped http package to 2.5.0.
Diffstat (limited to 'doc/http.n')
-rw-r--r--doc/http.n16
1 files changed, 13 insertions, 3 deletions
diff --git a/doc/http.n b/doc/http.n
index 8cd249d..a76e6ff 100644
--- a/doc/http.n
+++ b/doc/http.n
@@ -1,20 +1,21 @@
'\"
'\" Copyright (c) 1995-1997 Sun Microsystems, Inc.
'\" Copyright (c) 1998-2000 by Ajuba Solutions.
+'\" Copyright (c) 2004 ActiveState Corporation.
'\"
'\" 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.18.2.1 2003/07/16 04:15:07 dgp Exp $
+'\" RCS: @(#) $Id: http.n,v 1.18.2.2 2004/05/25 22:50:46 hobbs Exp $
'\"
.so man.macros
-.TH "http" n 2.4 http "Tcl Bundled Packages"
+.TH "http" n 2.5 http "Tcl Bundled Packages"
.BS
'\" Note: do not modify the .SH NAME line immediately below!
.SH NAME
http \- Client-side implementation of the HTTP/1.0 protocol.
.SH SYNOPSIS
-\fBpackage require http ?2.4?\fR
+\fBpackage require http ?2.5?\fR
.sp
\fB::http::config \fI?options?\fR
.sp
@@ -108,6 +109,15 @@ an empty list. The default filter returns the values of the
\fB\-proxyhost\fR and \fB\-proxyport\fR settings if they are
non-empty.
.TP
+\fB\-urlencoding\fP \fIencoding\fP
+The \fIencoding\fR used for creating the x-url-encoded URLs with
+\fB::http::formatQuery\fR. The default is \fButf-8\fR, as specified by RFC
+2718. Prior to http 2.5 this was unspecified, and that behavior can be
+returned by specifying the empty string (\fB{}\fR), although
+\fIiso8859-1\fR is recommended to restore similar behavior but without the
+\fB::http::formatQuery\fR throwing an error processing non-latin-1
+characters.
+.TP
\fB\-useragent\fP \fIstring\fP
The value of the User-Agent header in the HTTP request. The default
is \fB"Tcl http client package 2.4."\fR