lint and better documentation of the character vs. byte oriented commands

1 files changed, 8 insertions, 2 deletions

diff --git a/doc/seek.n b/doc/seek.n
index 3620e83..c6d69d2 100644
--- a/doc/seek.n
+++ b/doc/seek.n
@@ -5,10 +5,10 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: seek.n,v 1.2 1998/09/14 18:39:55 stanton Exp $
+'\" RCS: @(#) $Id: seek.n,v 1.3 1999/05/05 01:19:43 stanton Exp $
 '\" 
 .so man.macros
-.TH seek n 7.5 Tcl "Tcl Built-In Commands"
+.TH seek n 8.1 Tcl "Tcl Built-In Commands"
 .BS
 '\" Note:  do not modify the .SH NAME line immediately below!
 .SH NAME
@@ -50,6 +50,12 @@ It also discards any buffered and unread input.
 This command returns an empty string.
 An error occurs if this command is applied to channels whose underlying
 file or device does not support seeking.
+.PP
+.VS 8.1
+Note that \fIoffset\fR values are byte offsets, not character
+offsets.  Both \fBseek\fR and \fBtell\fR operate in terms of bytes,
+not characters, unlike \fBread\fR.
+.VE 8.1
 
 .SH KEYWORDS
 access position, file, seek