[ruby-dev:28022] Re: 1.8.4 documents?

永井@知能．九工大です．

From: Koji Arai <[e-mail]>
Subject: [ruby-dev:28017] Re: 1.8.4 documents?
Date: Wed, 14 Dec 2005 00:55:15 +0900
Message-ID: <[e-mail]>
> 以下のようにさまざまな修正があるのですが、時間をいただければ
> 作業します。が、12/24 には間に合いません。分担しませんか？

Ruby/Tk 関連です．
まず最初にですが，
---------------------------------------------------------------
次のバージョンに対応しています．
   Tcl7.6/Tk4.2, Tcl/Tk8.0 〜 8.4.12, Tcl/Tk8.5a1 〜 a3

   Tcl/Tk 拡張ライブラリについては
      ActiveTcl8.4.12.0 またはそれ以前
      ( beta 版 は ActiveTcl8.5.0.0b4 またはそれ以前 )
   に含まれるものに対応しています．
   対応している Tcl/Tk 拡張の種類とバージョンとは
      ext/tk/lib/tkextlib/SUPPPORT_STATUS
        または
      <installed lib dir>/tkextlib/SUPPORT_STATUS
   を参照してください．
   ただし，Tcl/Tk 拡張のバージョンの記述は，対応を行った最新の
   ものを示していますので，記述された以前のバージョンであっても，
   極端に古くない限りは対応できているはずです．
   各ライブラリへの対応のための変更履歴は
      ext/tk/ChangeLog.tkextlib
   を参照してください．

次のサンプルスクリプトが追加されました．
   ext/tk/sample/scrollframe.rb
      配置したウィジェットの表示範囲をスクロールすることが
      できるようなスクロールバー付きフレームウィジェットク
      ラスのサンプル兼ライブラリ

---------------------------------------------------------------

残りは以下のような感じでしょうか．

--- ChangeLog-1.8.3	2005-12-14 05:26:45.000000000 +0900
+++ ChangeLog	2005-12-11 23:57:32.000000000 +0900
@@ -1,3 +1,854 @@
+Sun Dec 11 23:54:07 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/*: update to support libraries in ActiveTcl8.4.12.0
+	  (see ext/tk/ChangeLog.tkextlib).
+
+	* ext/tk/sample/scrollframe.rb: add a new sample.
+

不要(上記に含む)

+Wed Dec  7 01:02:04 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/README.macosx-aqua: [new document] tips to avoid the known
+	  bug on platform specific dialogs of Tcl/Tk Aqua on MacOS X.

MacOS X 上で Aqua 版の Tcl/Tk を用いた際，Aqua 特有のダイアログ表示で
フリーズしてしまうという known bug の回避策を記載したドキュメント
(ext/tk/README.macosx-aqua) が追加されました．

+
+	* ext/tk/tcltklib.c: fix bug on switching threads and waiting on the
+	  deleted interpreter on vwait and tkwait command.

削除された Tk インタープリタに対して vwait や tkwait での処理待ちを
終了せずに待ち続けてしまう可能性があるというバグを修正しました．

+
+	* ext/tk/lib/multi-tk.rb: kill the meaningless loop for the deleted Tk
+	  interpreter.

MultiTkIp で生成した Tk インタープリタを削除した後も，
不要となったはずのスレッドが動き続けるバグを修正しました．

+
+	* ext/tk/sample/demos-jp/image3.rb: [bug fix] wrong argument.
+
+	* ext/tk/sample/demos-en/image3.rb: ditto.
+
+	* ext/tk/sample/demos-jp/menu.rb: fix message for MacOS X.
+
+	* ext/tk/sample/demos-jp/menu8x.rb: ditto.
+
+	* ext/tk/sample/demos-en/menu.rb: ditto.
+

不要

+Wed Nov 23 20:59:01 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/lib/tk.rb: add Tk.pkgconfig_list and Tk.pkgconfig_get
+	  [Tk8.5 feature].
+
+	* ext/tk/lib/tk/text.rb: supports new indices modifires on a Text
+	  widget [Tk8.5 feature].
+

Tcl/Tk8.5a3 への対応のため，Tk.pkgconfig_list および Tk.pkgconfig_get
が追加されました．
同様に Tcl/Tk8.5a3 への対応のため，テキストウィジェット上のインデック
ス指定における新しい modifier である indices に対応しました．

+	* ext/tk/lib/tk/virtevent.rb: add TkNamedVirtualEvent.
+

Tcl/Tk 上で名前が規定されている仮想イベントの指定した仮想イベントオブ
ジェクトの生成を少し容易にするため，TkNamedVirtualEvent が別名として
定義されました．

+	* ext/tk/lib/tk/event.rb: add :data key for virtual events [Tk8.5
+	  feature].
+

Tcl/Tk8.5 への対応のため，仮想イベントのイベント情報の一つである data
キーの情報を :data で指定できるようになりました．

+Tue Nov 22 02:31:53 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/lib/tkextlib/tile.rb: bug fix (Tk::Tile::USE_TTK_NAMESPACE
+	  is not defined).
+

不要

+Sat Nov 19 07:34:32 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/lib/tk/font.rb: remove dependency on Ruby's version (1.8
+	  or 1.9).
+
+	* ext/tk/lib/tkextlib/ICONS/icons.rb: ditto.
+
+	* ext/tk/sample/tkextlib/treectrl/demo.rb: ditto.
+

不要

+Fri Nov 18 17:35:09 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/lib/multi-tk.rb: add restriction to access the entried
+	  command table and manipulate other IPs (for reason of security).
+	  Now, a IP object can be controlled by only its master IP or the
+	  default IP.
+
+	* ext/tk/lib/remote-tk.rb: add restriction to manipulate.
+
+	* ext/tk/tcltklib.c (ip_is_slave_of_p): add TclTkIp#slave_of?(ip)
+	  to check manipulability.
+

セキュリティ上の問題を回避するため，MultiTkIp において IP オブジェクト
上での操作が許可されるのは，その操作を呼び出した環境 (スレッド) の IP 
オブジェクトがデフォルトの IP オブジェクト (デフォルトのスレッドグルー
プに属するもの．require 'multi-tk' の際に生成される) であるか，操作し
ようとしている IP オブジェクトが自らの直接の slave IP であるかの場合に
限られるようになりました．

この修正により，IP オブジェクトの入手に成功することで，ある IP が権限
を持たないはずの他の IP を操作できてしまう危険を減少させます．ただし，
ObjectSpace にアクセスし，直接に TclTkIp オブジェクトを取り出して操作
されることは回避できませんので，ご注意ください (ObjectSpace にアクセス
できるような状況で危険性のあるスクリプトを動かすことはしないとは思いま
すが)．

+	* ext/tk/lib/tk.rb: bug fix on handling of Tcl's namespaces.
+
+	* ext/tk/lib/tk/namespace.rb: ditto.
+

Tcl/Tk 上の namespace の扱いが正常に行えないというバグを修正しました．

+Mon Nov  7 13:43:51 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/stubs.c (_nativethread_consistency_check): use simpler
+	  (low cost) way to check whether the Tcl interpreter was compiled
+	  with threads enabled of not.
+
+	* ext/tk/tcltklib.c: reduce warnings.
+
+	* ext/tk/tkutil/tkutil.c: ditto.
+

不要

+Sun Nov  6 21:46:59 2005  Hirokazu Yamamoto  <[e-mail]>
+
+	* ext/tk/stubs.c (ruby_tcl_create_ip_and_stubs_init): should touch
+	  interpreter after initialization is done. [ruby-dev:27638]
+

不要

+Wed Nov  2 20:25:28 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tk/extconf.rb: ext/tk/extconf.rb: change the check parameter
+	  for Win32.
+

不要

+Wed Nov  2 20:14:53 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tcltklib: merge into ext/tk and remove.
+

Ruby のソース上で tcltklib と tk とを Ruby 1.9 系と同様に一体化しました． 
これにより，tcltklib の生成に失敗した環境で，動くはずのない tk のライ
ブラリファイル群がインストールされてしまうことが避けられます．
今後はソースに含まれる tcltklib 関連のドキュメントを参照する場合には
ext/tk ディレクトリの下を見てください．

+Wed Nov  2 19:03:06 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tcltklib/tcltklib.c (ip_rbUpdateObjCmd,
+	  ip_rb_threadUpdateObjCmd): passed improper flags to DoOneEvent().
+
+	* ext/tk/tkutil.c: use rb_obj_respond_to() instead of rb_respond_to().
+

update 処理が不適切であるために，一部の環境で menubar のメニュー項目に
登録した処理が実行されない場合があるというバグ (ruby-1.8.3 で enbug し
ていたもの) を修正しました．

+Mon Oct 24 07:57:56 2005  Yukihiro Matsumoto  <[e-mail]>
+
+	* ext/tk/lib/tk/canvas.rb (TkCanvasItemConfig::__item_val2ruby_optkeys):
+	  typo fixed.  [ruby-talk:162187]
+
+	* ext/tk/lib/tk/menu.rb (TkMenuEntryConfig::__item_val2ruby_optkeys):
+	  ditto.  [ruby-core:06359]
+

不要

+Sun Oct 23 07:11:11 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tcltklib/extconf.rb: improve messages [ruby-core:06325].
+

不要

+	* ext/tk/lib/tk.rb, ext/tk/lib/tk/canvas.rb, ext/tk/lib/tk/entry.rb,
+	  ext/tk/lib/tk/frame.rb, ext/tk/lib/tk/image.rb,
+	  ext/tk/lib/tk/itemconfig.rb, ext/tk/lib/tk/labelframe.rb,
+	  ext/tk/lib/tk/listbox.rb, ext/tk/lib/tk/menu.rb,
+	  ext/tk/lib/tk/radiobutton.rb, ext/tk/lib/tk/scale.rb,
+	  ext/tk/lib/tk/spinbox.rb, ext/tk/lib/tk/text.rb,
+	  ext/tk/lib/tk/toplevel.rb: improve conversion of option values.
+
+	* ext/tk/lib/tkextlib/*: ditto.
+

ウィジェットオブジェクトの属性参照をした場合に属性値として返すオブジェ
クトをより適切なものにするように改善しました．その方がより便利であろう
と思いますが，一部の属性において，返されるのが文字列であることを期待し
てスクリプトを書いている場合には修正が必要になる場合があります．

例えば bool 値を返す属性については true または false を返すようになり
ます．よって，戻り値が "1", "0" の文字列，あるいは 1, 0 の数値であるこ
とを期待している場合には修正が必要となります．本来，Tcl/Tk の真偽値は
他にも "true", "false", "yes", "no" などもありますので，値の真偽判定は
TkComm.bool (TkUtil.bool) メソッドを使って判定することを推奨します．

また，Tcl/Tk 上の変数が割り当てられている属性において，属性値として
Tcl/Tk 上の変数名の文字列ではなく TkVariable オブジェクトが返されるよ
うになります．返された値を別のウィジェットの属性値とするなどでそのまま
Tk インタープリタに渡している場合や TkVarAccess.new(val) で TkVariable
オブジェクト化している場合 (val である TkVariable オブジェクトがそのま
ま返されます) には互換性が保たれますが，返された値をそのまま文字列と比
較しているような場合には非互換となります．

+	* ext/tk/lib/tkextlib/*: update to support ActiveTcl8.4.11.2.
+
+	* ext/tk/lib/tkextlib/trofs/*: support Trofs 0.4.3.
+
+	* ext/tk/lib/tkextlib/tile/*: support Tile 0.7.2.
+
+	* ext/tk/lib/tkextlib/vu/*: support vu 2.3.0.
+
+	* ext/tk/lib/tkextlib/tcllib/*: support Tcllib 1.8 (Tklib 0.3).
+

不要

+Wed Sep 28 10:45:44 2005  Hidetoshi NAGAI  <[e-mail]>
+
+	* ext/tcltklib/tcltklib.c: cannot compile with Tcl/Tk8.0.x
+	  [ruby-dev:27335].
+

不要

 Wed Sep 21 09:07:55 2005  Yukihiro Matsumoto  <[e-mail]>
 
 	* stable version 1.8.3 released.

-- 
                                       永井 秀利 （九工大 知能情報）
                                           [e-mail]