Mei+alpha on Smalltalk/V for Mac

Enhanced Mei for ST/V Mac 2.0.2

● What's this kit?

●このキットを使用するには以下のソフトウェアが必要です。

Smalltalk/V version 2.0.2 for Macintosh (+ Patch 2.0.2-2)
MeiSystem 0.15

　必ず、2.0.2-2 のパッチを当てた Smalltalk/V version 2.0.2 for Macintosh にインストールした「明 (MeiSystem) 」を使用してください。

動作環境：「明(MeiSystem)」0.15 on Smalltalk/V 2.0.2 (+ Patch 2.0.2-2)
          IIci 8MB with VM / 漢字Talk 7.1 /
          PPC 8500/120 48MB / 漢字Talk 7.5.2
          カラー環境
開発環境：IIci 8MB with VM / 漢字Talk 7.1
開発言語：「明(MeiSystem)」0.15 on Smalltalk/V 2.0.2 (+ Patch 2.0.2-2)

　「明(MeiSystem)」の Smalltalk/V Mac 版は、(株)SRAのソフトウェア工学研究所に所属する青木淳さん、渡邊克宏さんによって作成されました。

　dagTSO-kit は上記 Smalltalk/V version 2.0.2 for Macintosh (+ Patch 2.0.2-2) 用「明(MeiSystem)」 version 0.15 を拡張する（つもりの） for-thrill-seekers-only のフリーソフトウェア・ライブラリです。ハンドルの頭３文字を取って dagTSO-kit という名前にしました。日本語では『駄愚キット』とでもしておきましょう。f(^^;)

　おおよそ、以下のような内容を「移植」しました。

集まりを表すオブジェクト群　　
- (Collection クラス階層の再実装)
プラガブルゲージ類　　
- (Model-View-Controllerフレームワークに基づいたゲージ)
GUIエディタ　　
- (グラフィカルユーザインタフェース構築ツール)
文房具　　
- (カレンダー, かなり妖し気な(移植の)時計, 電卓, 15パズル)
メソッド変更管理ツール
メトリクス・ツール
簡単な CASE ツール
ツール＆グッディーズ　　
- (ヒストグラム, ソースコード退避, トランスクリプト退避, 並列（直列）回路モニタ, 行解を得るための観照のひととき（シダと銀河です。おまけつき）)
部品＆モデル　　
- (BoolModel, Button, Switch, HyperText, ActionText (evaluate(:) を除く), ValueModel (ダイアログ関連のみ))
その他

　出典は、

「明(MeiSystem)」0.60 - 0.67
EngiSystem (OW / VW 用 Smalltalk TextBook)
SuperAscii の連載
sra の goodies
for OW R4.* のフリーウェア・ソース等です。

＜規模＞

classes: 138
instance messages: 1228 (1674 methods)
class messages: 516 (933 methods)
instance variables: 193 (181 + 12)
class variables: 26
pool variabels: 0
source code steps: 31833 (16989 + 14844)
methods: 2607
messages: 1744
source code steps per methods: 12.21
redefined messages: 863

　上記クラスはすべてで始まるクラス名を持ち、聖典がヴァージョン・アップしてもクラス名がバッティングしないようにしています。Smalltalk/V と ObjectWorks, VisualWorks は、フレームワーク等の枠組みなど、かなり違っています。本来ならば、後者用に書かれたアプリケーションを前者用に組み直して初めて「移植した」と言えるのでしょうが、そこまでやっていません。力ずくで動かしています。

　メインの環境は IIci 8MB with VM / 漢字Talk 7.1 ですが、動作は非常に重いです。030 マシンの方は腹をくくってください。(^^;)　ごく最近 PPC 8500/120 を手に入れましたが、これぐらいだと、けっこう軽快に動いてくれます。

　移植したクラス群は判る範囲で動くようにしていますが、なにせ、smalltalk ワナビー志願者なもんで、完動品を期待しないでください。移植者はチュートリアルの４章レベルです。

　聖典のヴァージョン・アップがいちばん望ましいのですが、わたしなんぞより、もっと優秀な方が「こんな移植のやり方ではダメだ！」と拡張キットを作っていただけたらありがたいです。「明(MeiSystem)」の Smalltalk/V Mac 版が伝説になるのは困ります。

　このキットを公開する理由はただひとつ「MeiV0.15 が早くヴァージョン・アップしないかなぁ……」。

●「明(MeiSystem)」の Smalltalk/V Mac 版は以下から入手できます。

niftyserve FAI 02-274 95/03/28 1077120 明(MeiSystem) for ST/V Mac 2.0.2
ftp://ftp.sra.co.jp/pub/lang/smalltalk/mei/MeiV0.15.sea.hqx

● Patch2.0.2-2 は以下から入手できます。

CompuServe　parcplace digitalk forum MAC202.SEA (in Support Library #5)

　およそ 252KB あります。Patch2.0.2-2 を当てると、アプリケーションのヴァージョンは V.2.0.3d4 となります。

○参考　「明(MeiSystem)」の (OW) VW 版は以下から入手できます。

niftyserve FAI 02-219 94/04/10 855296 「明」(Mei0.60) for Macintosh
ftp://ftp.sra.co.jp/pub/lang/smalltalk/mei/
- Mei0.60.tar.gz Mei0.60 (OW R4.1, VW V1.0 用)
- Mei0.67.tar.gz Mei0.67 (VW V2.0 用)

● 移植にあたって、暖かい励ましのお言葉をいただいた、青木淳さん、渡邊克宏さん、矢野勉さんに深謝いたします。タコな質問にも丁寧にレスをいただいた、まさるさん、村上雅章さん、阿部和広さん、中嶋睦月さんをはじめとする、FAI「Lisp/Prolog/Smalltalkなどの言語と実践」会議室の諸賢兄にお礼申し上げます。

● How to Install?

オリジナルの「明(MeiSystem)」の image と changes および、Smalltalk/V アプリケーションは、必ずバックアップを取っておいてください。
キットをインストールする前に、Tools:Object Filer ディレクトリにある Object Filer.st をインストールしておいてください。
「明(MeiSystem)」のあるディレクトリで、キットを解凍します。dagClass と dagDocs、dagTSO-kit の３つのディレクトリができます。
- dagClass ディレクトリ
  - :dagSrcs (ソース・ファイル群)
  - :dagClassDocs (クラスのドキュメント・ファイル群)
- dagDocs ディレクトリ (ブラウジング用のドキュメント等)
- dagTSO-kit ディレクトリ (リソース・パッチ・ファイル、イントール手順書等)
Smalltalk/V アプリケーションに RedEdit 等で dagTSO-kit ディレクトリの "appl.rsrc" をコピーし上書きします。
「明(MeiSystem)」を立ち上げ、dagClass:dagSrcs のディレクトリの中の "Dag00000.stv" をインストールします。これで、全クラスの読み込みが始まります。ファイルインするファイルはおよそ 140 近くあり、けっこうな時間が掛かります。インストールが終了すると、ランチャとクラス・リスト、ユーザ名を登録するウィンドウが開きます。
使用するユーザ名を登録します。ユーザ名を登録するウィンドウにあなたのログイン名を加えて下さい。２つめのランチャも開きます。オリジナルのランチャを閉じても結構です。新しいランチャが、（多少くどいですが）その代わりをします。現段階ではユーザ名はたいして活用されていませんが、たとえば、　ClassBrowser>>methodTemplate メソッドを以下のように変更すれば、コメントに日付とユーザ名を付加することができます。
```
methodTemplate
    "Private"

^'messagePattern
    "Comment"',
'
    "', DagMiscellany dateNowString, ' ',
    DagMiscellany userName, '"', 
'

    | temporaries |
    statements'
```
PixMap 等を乱発しすぎると、ヒープを喰い漁られて、「ヒープ領域が足りないよ」と怒られた上に、'Connection attempt failed.'（詳査したわけではありませんが、これはヒープ内に PixMap を確保するだけの領域がないから発生するのでしょうか）等のメッセージを出して Walkback が出る場合があります。デフォルトの設定では、Smalltalk/V の Minimum Toolbox Memory サイズは 102400 bytes なので、たとえば Metrics ツールなどでは明らかに足りません（Metrics ツールでは 20 枚近くの PixMap を要します）。というわけで、上記 Walkback が出てきた場合は、一度システムを停止して、Smalltalk setImageSize を評価して、Minimum Toolbox Memory サイズを増やしてください。10 倍程度にしておけばいいと思います。

● How to play this kit?

Launcher

GUI Editor

　GUI Editor は、各種ビュー・ボタン・ゲージなどのウィンドウ内での位置と大きさを対話的に編集し、ビューのモデルへの接続方法(plug-in メッセージ)を対話的に設定するためのツールです。編集しながら、アプリケーションの実際の画面表現と動きをいつでも確認することができます。また、そのまま do it して動く Smalltalk のコードを掃き出すことができます。実際に、明のツールの多くで、ユーザーインターフェース部分のコードはこの GUI Editor が生成したコードを利用しています(OW / VW 版)。

　部品の位置や大きさだけでなく、plug-in のしかたも設定しますから、先にモデルを完成させてから GUI Editor を利用するほうが作業がうまくいきます。対象のモデルを選択するには、黄色ボタンメニューの(goodies のなかの)select model class を選んでください。各部品の plug-in のしかたは、editで指定できます。

　メニューの中の scaled size/fixed size は、選択されている部品が、window の大きさの変化に従って自分の大きさを変化させるか否かを指定します。

　GUI Editor の利用法を例示するものとして、DagGuiExample があります。

	DagGuiExample edit

　以下に、部品と実際のクラスとの対応表を示します。

部品		クラス
selection list view	single	MeiListView
selection list view	multi	MeiList2View
text view		MeiTextView
label view		MeiDisplayView
button view		DagButtonView
switch view		DagSwitchView
display view	no scroll	MeiDisplayView
display view	scroll	MeiScrollDisplayView
show view	no scroll	MeiShowView
show view	scroll	MeiScrollShowView
gauge view	bar	DagGaugeView
	oval	DagOvalGaugeView
	circle	DagCircleGaugeView
	color	DagColorGaugeView
	mask	DagMaskGaugeView

MeiShowView は黄ボタンメニューを備えていますが、MeiDisplayView にはありません。

●　DagGuiExample を experiment して動くツールは、ObjectFiler 形式のバイナリ・ファイルのほか、PICT のファイルも読み書きできます。　部品には２通りの見せ方があります。片一方は動作がやや軽いが実際の有り様は experiment するまで判りませんが、もう一方は部品がひと目で判る代わりに動作が鈍重です。このツールを最初に立ちあげたときに、どちらの view を使用するかを決定します。一度決定した view を変更したいときは、

  DagGuiModel flushInstanceClassVariables

クラスのメトリックス
クラスごとのドキュメント
Interface and Circuit
SourceCodeSaver
Benchmark
Histogram
トランスクリプトの退避
My libraries
yellowButtonView
クラスのツリー表示
Classes or Instances
Enhancements
Additional methods
browser

Created: Mar 15, 1996, Updated: Apr 20, 1996

Mei*** ->	red
Dag*** ->	darkGreen
Mac*** ->	olive
****** ->	black

Mei+alpha on Smalltalk/V for Mac

Enhanced Mei for ST/V Mac 2.0.2

● What's this kit?

● How to Install?

● How to play this kit?

Launcher

GUI Editor

クラスのメトリックス

クラスごとのドキュメント

Interface and Circuit

SourceCodeSaver

Benchmark

Histogram

トランスクリプトの退避

My libraries

yellowButtonView

クラスのツリー表示

Classes or Instances

Enhancements

Additional methods

browser