From d377a64f4f87986e2b27bb9f61b62f549c72976b Mon Sep 17 00:00:00 2001
From: nagai <nagai@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Tue, 8 Mar 2005 09:48:46 +0000
Subject: * ext/tk/sample/tktextio.rb: add comment

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_8@8120 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 ext/tk/sample/tktextio.rb | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

(limited to 'ext')

diff --git a/ext/tk/sample/tktextio.rb b/ext/tk/sample/tktextio.rb
index 068b28e60e..8df2454135 100644
--- a/ext/tk/sample/tktextio.rb
+++ b/ext/tk/sample/tktextio.rb
@@ -1,9 +1,18 @@
 #!/usr/bin/env ruby
 #
 #  sample class of handling I/O stream on a TkText widget
-#
 #                                               by Hidetoshi NAGAI
 #
+#  NOTE: TkTextIO supports 'character' (not 'byte') access only. 
+#        So, for example, TkTextIO#getc returns a character, TkTextIO#pos 
+#        means the character position, TkTextIO#read(size) counts by 
+#        characters, and so on.
+#        Of course, it is available to make TkTextIO class to suuport 
+#        'byte' access. However, it may break multi-byte characters. 
+#        and then, displayed string on the text widget may be garbled.
+#        I think that it is not good on the supposed situation of using 
+#        TkTextIO. 
+#
 require 'tk'
 
 class TkTextIO < TkText
@@ -50,7 +59,6 @@ class TkTextIO < TkText
       @open[:r] = true;  @open[:w] = true
       @txtpos.set('end - 1 char')
     end
-
   end
 
   def <<(obj)
-- 
cgit v1.2.3