From 3ec84b5f7c7cdc50fa1c75cf838bbb982acc4349 Mon Sep 17 00:00:00 2001
From: Irene Knapp <ireneista@gmail.com>
Date: Tue, 19 May 2020 21:54:39 -0700
Subject: Import oneko-1.2.sakura.5 unchanged, from 1999.

---
 README | 194 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 194 insertions(+)
 create mode 100644 README

(limited to 'README')

diff --git a/README b/README
new file mode 100644
index 0000000..9cf783a
--- /dev/null
+++ b/README
@@ -0,0 +1,194 @@
+		oneko - Neko runs over the windows.
+		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+				Original program written by
+							Masayuki Koba
+				Modified by
+					Tatsuya Kato (kato@ntts.co.jp)
+
+
+以前、fj.sources に xneko という X Window 上で動く「猫」が投稿されてい
+ましたが、残念ながらこの「猫」は一つのウインドウを作ってそのウインドウ
+の中でマウスを追いかけて走り回るものでした。
+
+そこで私が「猫をおりに閉じ込めておくのは可哀想じゃないか」と思い、画面
+の上を縦横無尽に走り回るように改造してあげました。
+
+その名も "oneko"。最初は 'oclock' の 'o' を取ったつもりだったのですが、
+oclock って丸いから 'o' なんじゃなくて o'clock の 'o' ですよね。で、'
+o' のこじつけに "Neko runs Over the windows" の 'o' をつけました。（苦
+しい）
+
+＃ ｎとｍは隣合わせのキーなのでくれぐれも間違って入力しないようにして
+＃ 下さい。
+
+このプログラムを実行するには X Window System が必要です。X のバージョ
+ンは R3 または R4 ですが、R4 で採り入れられた Shape extention を使って
+いますので R3 で実行する場合はつまらない実行結果になってしまいます。
+（Shape extention がなくてもコンパイルはできるようにしてあります。）
+
+実行するマシンは Sun4/330 と、NCD のＸ端末でしか試してませんが、Ｘ端末
+でははっきりいって遅いです。Sun のコンソールでやった時にはパラメータの
+設定でかなりの速度まであげられるのですが ......。
+
+お試しください。
+
+＜バージョンアップによる機能拡張＞
+
+◎ オプションはすべてリソースからも指定できるようになりました。ただし、
+   Xrm ライブラリ関数を使用せず、XGetDefault でリソースの取得を行なっ
+   ています（X11R1 相当の機能）ので、アプリケーションデフォルト
+   (/usr/lib/X11/app-default にあるファイル）でのリソース指定はまだで
+   きません。
+
+◎ NTTSOFT local で好評だった（？）とら猫にする機能を採り入れました。
+   実行時に
+
+   % oneko -tora
+
+   とすると猫の模様が変わります。
+
+◎ 色の指定ができるようになりました。起動時のオプションで -fg, -bg を
+   指定して下さい。
+
+◎ この猫は、寝ている時にねずみをゆっくり移動させると気づかずに寝て
+   います。これは一定時間内にマウスの動いた距離がある値を越えなければ
+   気がつかないようになっているのですが、この「ある値」をオプションで
+   変えられるようにしました。デフォルトは６になっているのですが、
+
+   % oneko -idle 20
+
+   とすると「より鈍い」猫の出来上がりです。
+
+◎ コンパイラに gcc を使うと動かないそうです。（私も確認した）このため
+   今度の Imakefile では強制的に cc でコンパイルするように指定していま
+   す。
+
+◎ Shape extention のライブラリがなくてもコンパイルできます。もしあな
+   たの使用しているＸが R4 ではなくて、かつ SONY NEWS ではない場合は
+   Imakefile の
+
+          DEFINES = -DSHAPE
+
+   という行を消して下さい。（NEWS で使えるかどうかは試してません。誰か
+   確認して下さい。）
+
+＜コンパイルの仕方＞
+
+1. まず、この記事を unshar してソース一式を取り出してください。
+
+2. Makefile を作ります。oneko のディレクトリに移って、
+
+% xmkmf
+
+を実行してください。もし、このコマンドがなければ、
+
+% imake -DUseInstalled -I/usr/lib/X11/config
+
+でも同じです。
+
+3. make を実行します。
+
+% make
+
+これで、実行可能な「猫」が出来ます。もし、/usr/bin/X11 にいれて、みん
+なで使いたいのでしたら
+
+# make install
+
+を（スーパユーザで）実行してください。
+
+これでコンパイルは終了です。あとは、
+
+% oneko &
+
+を実行して楽しんでください :-)
+
+＜使用方法＞
+
+基本的にオプションはいりません。が、こんなおぷしょんもあります。
+help を除くオプションはリソースからも変更できます。
+
+-help		オプションの help を表示します。
+
+-tora		猫がとら猫に変わります。
+
+-time <n>	猫が使うインターバルタイマの値を変えます。デフォルトは 
+		micro second 単位で 125000 になっていますが、この値を
+		小さくするほど猫が速く動きます。
+
+-speed <n>	猫が一度に移動する距離をドットの数で指定します。デフォ
+		ルトは 16 ですが、この値を大きくするほど猫が速く移動し
+		ます。
+
+-idle <n>	猫が寝ている時、どれだけの速度でねずみが動いたら起きる
+		のかを指定できます。デフォルトは 6 です。
+
+-rv		色を反転します。（カラーのディスプレイでは fg, bg で指
+		定できるので、あんまり意味がありません。）
+
+-noshape	X の Shape Extension を使わずに実行します。速度はかな
+		り速くなりますが、表示がつまらなくなります。（実際にやっ
+		てみてください。）
+
+-fg <color>	フォアグラウンドの色を指定します。モノクロームのディス
+		プレイでは無視されてしまいます。
+
+-bg <color>	バックグラウンドの色を指定します。モノクロームのディス
+		プレイでは無視されてしまいます。
+
+また、インストールすると tora にも symbolic link を張ります。tora とい
+うコマンド名で起動した時にはデフォルトで -tora オプションをつけた時と
+同じになります。
+
+リソースで指定した場合はこうです。
+
+oneko.foreground:	black
+oneko.background:	red
+oneko.time:		100000
+oneko.reverse:		true
+
+コマンドが oneko ではなく、tora という名前で起動された場合リソース名は 
+tora.* になりますから
+
+tora.foreground:	sienna
+tora.background:	moccasin
+
+としてとら猫の設定と普通の猫の設定を別にすることも可能です。とら猫の色
+はそのままでは白黒になってしまうので上の２行を resoerce にいれて下さい。
+
+また、コマンド名でなくてクラス名（"Oneko"）で始まるリソースも読むよう
+にしました。ですから speed, time など、全ての猫に共通なリソースはクラ
+ス名で、猫の種類（普通の猫、とら猫）によって変えたい色などのリソースは
+コマンド名（インスタンス名）で指定するのがいいでしょう。
+
+この辺の implement は始めから Xrm* を使えばよかったのですが、この関数
+の存在を知らなかったので XGetDefault を使って「無理矢理」書いています。
+
+＜ばぐ、これからバージョンアップしたいところ＞
+
+複数の猫を同時に動かせるようにしたい。今のままでは oneko を２つ実行す
+ると同じ動きをするので重なってしまいます。（-speed や -time を変えて実
+行するとそれなりに動いてくれますが。試してみて下さい。）
+
+猫が走った後の領域に Expose が起きるので、kterm 等だとちらちらします。
+Save Under も試してみましたが、遅くてやめてしまいました。何かいい方法
+がないでしょうか？
+
+カーソルがルートウィンドウの上と猫の上にある時にはネズミに変わりますが、
+ネズミの色は単に猫の色を反転したものになっています。時間があれば直すの
+はすぐなのですが、急いだのでそのままになっています。バージョンアップを
+期待していて下さい。
+
+速度を早くしたい ...... けど、これ以上は無理かな？ どなたか「こうした
+らもっと速くなる」という方法を教えて下さい。（近藤＠ふ研 さんの提案し
+て下さった Map/Unmap を使った方法はまだ試してません。暇がなくって。）
+
+仕事している時、猫を動かしていると時々猫にキー入力を邪魔されることがあ
+ります。キー入力を無視して下のウインドウに渡すことが出来るのでしょうか？
+（そういっている割には今のバージョンの猫はキーイベントを Select input 
+しています。）
+
+＃ 基本的にＰＤＳですが、バグ修正や機能拡張は（こっそりでもいいですか
+＃ ら）私（kato@ntts.co.jp）に教えて下さいね。バージョンアップもするつ
+＃ もりです。
-- 
cgit 1.4.1