diff options
| author | dkf <donal.k.fellows@manchester.ac.uk> | 2003-04-16 23:06:25 (GMT) |
|---|---|---|
| committer | dkf <donal.k.fellows@manchester.ac.uk> | 2003-04-16 23:06:25 (GMT) |
| commit | caa2e40c5ef3e6d45edebe3e156b25903fb30eba (patch) | |
| tree | 90545b694afb61910f66b6539c67db3798483d1c | |
| parent | 2b9f9e31afa5200e9c98d9c5588d76ec5b1ba9b4 (diff) | |
| download | tcl-caa2e40c5ef3e6d45edebe3e156b25903fb30eba.zip tcl-caa2e40c5ef3e6d45edebe3e156b25903fb30eba.tar.gz tcl-caa2e40c5ef3e6d45edebe3e156b25903fb30eba.tar.bz2 | |
If you deal with network sockets, you should care about encodings. Tcl cannot
guess it for you. Updated socket docs to remind people about this. [Bug 630621]
| -rw-r--r-- | ChangeLog | 5 | ||||
| -rw-r--r-- | doc/socket.n | 11 |
2 files changed, 14 insertions, 2 deletions
@@ -1,3 +1,8 @@ +2003-04-17 Donal K. Fellows <fellowsd@cs.man.ac.uk> + + * doc/socket.n: Added a paragraph to remind people to specify + their encodings when using sockets. [Bug 630621] + 2003-04-16 Donal K. Fellows <fellowsd@cs.man.ac.uk> * doc/CrtMathFnc.3: Functions also have to deal with wide ints, diff --git a/doc/socket.n b/doc/socket.n index 51332f7..3ee0912 100644 --- a/doc/socket.n +++ b/doc/socket.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: socket.n,v 1.7 2002/10/01 10:03:19 dkf Exp $ +'\" RCS: @(#) $Id: socket.n,v 1.8 2003/04/16 23:06:30 dkf Exp $ .so man.macros .TH socket n 8.0 Tcl "Tcl Built-In Commands" .BS @@ -29,6 +29,13 @@ releases may include support for additional protocols. The \fBsocket\fR command may be used to open either the client or server side of a connection, depending on whether the \fB\-server\fR switch is specified. +.PP +Note that the default encoding for \fIall\fB sockets is the system +encoding, as returned by \fBencoding system\fR. Most of the time, you +will need to use \fBfconfigure\fR to alter this to something else, +such as \fIutf\-8\fR (ideal for communicating with other Tcl +processes) or \fIiso8859\-1\fR (useful for many network protocols, +especially the older ones). .SH "CLIENT SOCKETS" .PP @@ -138,7 +145,7 @@ list is identical to the address, its first element. .PP .SH "SEE ALSO" -flush(n), open(n), read(n) +fconfigure(n), flush(n), open(n), read(n) .SH KEYWORDS bind, channel, connection, domain name, host, network address, socket, tcp |