<!doctype linuxdoctr system>
<article>
<title>XPostIt README</title>
<author>David A. Curry &lt;davy@ecn.purdue.edu&gt;
<date>v3.3.2, 17 November 1995
<trans>川岸良治 &lt;kawagisi@yk.rim.or.jp&gt;
<tdate>v3.3.2j, 1998年11月18日


<![IGNORE[
==============================================================================
  XPostIt README

  XPostIt は、ちょっとしたメモを付箋紙に書いて貼るようなことを X の画面上で
  実現するユーティリティです。このドキュメントは XPostIt Version 3.3.2 に
  付属の README を作者の許可を得て翻訳したものです。

    ＜原文＞     ファイル名： README (XPostIt Version 3.3.2 に付属)
                 作者      ： David A. Curry &lt;davy@ecn.purdue.edu&gt;
                                             &lt;davy@ers.ibm.com&gt;
                 最終変更日： 17 November 1995

    ＜日本語版＞ ファイル名： XPostIt-README.euc
                 翻訳者    ： 川岸 良治  &lt;kawagisi@yk.rim.or.jp&gt;
                 作成日    ： 1998年11月18日
==============================================================================
]]>


<abstract>
XPostIt は、ちょっとしたメモを付箋紙に書いて貼るようなことを X の画面上で
実現するユーティリティです。このドキュメントは XPostIt Version 3.3.2 に
付属の README を作者の許可を得て翻訳したものです。
</abstract>

<sect>この文書について
<p>
<sect1>Copyright
<p>
Copyright 1991 by David A. Curry

Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting documentation.  The
author makes no representations about the suitability of this software for
any purpose.  It is provided "as is" without express or implied warranty.

このソフトウェアおよびドキュメントをあらゆる目的のために使用／コピー／変更／
配布／販売することは、これを無料で提供し、全てのコピーに上記の著作権表示をし、
サポートするドキュメントに著作権表示とこの許可の旨の両方を表示することにより
許可します。作者は、あらゆる目的に対するこのソフトウェアの適合性についての
説明はしません。このソフトウェアは、明示的にもあるいは暗黙的にも保証せず
"as is" (あるがままの形)で提供されます。

</sect1>

<sect1>XPostIt とは
<p>
<!--
This is XPostIt Version 3.3.2 for X11 Releases 4, 5 and 6.  XPostIt allows
you to create small notes to yourself in windows on the screen, and save
them in disk files.  This is generally neater than having numerous real
Post-it notes stuck all around the edges of your monitor.
-->
これは X11 Releases 4, 5, 6 用の XPostIt Version 3.3.2 です。
XPostIt は、画面上のウィンドウ内にあなた用の小さなノート(メモ)を作り、それを
ディスクファイルとしてセーブします。これは、本当の Post-it のノートを画面の
端のあちこちに沢山貼り付けるよりもスマートです。

<footnote>
【訳注１】Post-it とは 3M(スリーエム)社が販売している付箋紙の商品名です。
また、XPostIt のメインウィンドウには格子縞 (plaid) の模様が表示され
ますがこの模様は同社の登録商標です。
</footnote>
<!--
【訳注１終り】
-->

</sect1>

<sect1>v3.3.1 から v3.3.2 への変更点
<p>
<!--
The only difference between Version 3.3.2 and Version 3.3.1 (which has been
the current release for some time) is the addition of support for X11R6,
which required a couple of minor changes.
-->
Version 3.3.2 と 3.3.1(しばらくの間カレントリリースでした) との違いは X11R6 の
サポートを追加したことで、いくつかのマイナーチェンジが必要でした。

<!--
This release of XPostIt has the following changes over version 3.0, which
was the version released when X11 Release 5 came out.
-->
X11 Release 5 が出た時にリリースされたバージョンである version 3.0 以降の
XPostIt のこのリリースでは、下記に示す変更をしました。

<!--
Major new features:
-->
主な新しい機能：

<itemize>
<item>
<!--
- The current state of the note (normal, iconic, or hidden) is now stored
  in the file when a note is saved.  When xpostit starts up again, it
  will put all the notes back into their state at the last save.  The new
  file format is upward-compatible with the old one (in other words, this
  version can read old files, but old versions won't be able to read new
  files).
-->
  ノートの現在の状態(ノーマル、アイコン化、隠し)をノートがセーブされる時に
  格納するようにしました。xpostit を再起動した時に、全てのノートを最後に
  セーブした時の状態に戻します。新しいファイルフォーマットは古いものに対し
  て上位互換です。(言い換えれば、このバージョンでは古いファイルを読み込み
  可能ですが、古いージョンは新しいファイルを読むことはできません。)
<item>
<!--
- You can now "tear off" a default-sized note by holding down the left
  mouse button on the plaid window and dragging it off the window.  This
  is faster and simpler than the menu, for making quick notes.
-->
  格子縞のウィンドウでマウス左ボタンを押し続けることにより、デフォルトサイ
  ズのノートを作ることができるようになりました。これはメニュー方式に比べ速
  く簡単にノートを作ることができます。
<item>
<!--
- Keyboard accelerators have been installed to allow setting the title
  without using the mouse, and to allow saving without using the mouse.
-->
  キーボード・アクセラレーションがインストールされました。これはマウスを使
  わずにタイトルを設定でき、且つマウスを使わずにセーブできます。
<item>
<!--
- It can now be compiled with the contributed international langage
  version of the Athena widgets, by defining the XI18N symbol.  See the
  "XPostit-intl" app-defaults file for how to set the resources you need
  for this.
-->
  XI18N シンボルを定義することにより、Athena ウィジェットの国際化対応でコン
  パイル可能になりました。これが必要な場合は、必要なリソースの設定方法について
  "XPostit-intl" app-defaults ファイルをご覧下さい。
</itemize>

<!--Assorted bug fixes and changes:-->バグ修正と変更：
<p>
<itemize>
<item>
<!--
- The botched include files (trying to include X11/copyright.h) have been
  fixed.
-->
  やり損ないのインクルードファイル (<tt>X11/copyright.h</tt> をインクルード
  しようとする) を修正しました。
<item>
<!--
- Assorted System V patches have been applied to allow XPostIt to compile
  on System V UNIX.  It will also compile and run under Solaris 2.x.
-->
  System V UNIX 上で XPostIt をコンパイルするためのパッチを適用しました。
  これは Solaris 2.x でもコンパイルと実行が可能です。
<item>
<!--
- The application defaults file has been split into b&amp;w and color versions;
  you can use the "xpostit*customization: -color" resource to enable use of
  the color file.  (R5 only)
-->
  アプリケーション・デフォルト・ファイルを白黒用とカラー用のバージョンに分割
  しました。カラーのファイルの使用を有効にするには
  "<tt>xpostit*customization: -color</tt>" というリソースを使います。(R5 のみ)
<item>
<!--
- The ".postitnotes" directory is now created if it does not exist.  It
  gets created the first time a note is saved.
-->
  "<tt>.postitnotes</tt>" ディレクトリが存在しない場合は、これを作成します。
  これは初めてノートをセーブする際に作成されます。
<item>
<!--
- The type of shell widget used to hold a note has been changed; now the
  note title will show up with the icon as well as the note itself.
-->
  変更されたノートを保持するために、シェルのウィジェットの型が使用されます。
  これでノート自体と同じようにノートのタイトルがアイコンを伴って表示されます。
<item>
<!--
- The title dialog box and confirmation button box should now work
  properly under mwm and olwm.
-->
  タイトルのダイアログボックスと、確認ボタン用のボックスが mwm と olwm の
  下でも適切に動作するようになりました。
<item>
<!--
- The title dialog now gives each note a separate title (this was broken
  under 3.0 and fixed in patch 1).
-->
  タイトルのダイアログは、各々のノートで分離したタイトルとして設定できます。
  (これは 3.0 では壊されましたが patch 1 で修正されました)
<item>
<!--
- The keyboard focus is now set to the text widget, so you can type with
  the cursor anywhere in the note.
-->
  キーボードのフォーカスをテキストのウィジェットに設定しました。
  従ってノート内のどこにでもカーソルでキー入力できます。
<item>
<!--
- Notes catch WM_DELETE_WINDOW and hide themselves.
-->
  ノートは <tt>WM_DELETE_WINDOW</tt> を捉えると、それ自身を隠します。
<item>
<!--
- The plaid window catches WM_DELETE_WINDOW and exits.  It also catches
  WM_SAVE_YOURSELF and saves all notes (if .saveNotes is on).
-->
  格子縞のウィンドウは <tt>WM_DELETE_WINDOW</tt> を捉えると、終了します。
  また <tt>WM_SAVE_YOURSELF</tt> を捉えると全てのノートをセーブします。
  (<tt>.saveNotes</tt> が on の場合)
<item>
<!--
- All notes will get iconified if the plaid window is iconified.
-->
  格子縞のウィンドウをアイコン化すると全てノートもアイコン化されます。
</itemize>

<!--
Thanks to the folks who contributed patches and suggestions, especially
Hiroshi Kuribayashi, Brian Walker, Rainer Klute, and Joe English.
-->
パッチと助言を頂いた方々、特に Hiroshi Kuribayashi, Brian Walker, Rainer 
Klute, Joe English に感謝します。

</sect1>
</sect>

<sect>インストール
<p>
<!--
Building XPostIt is simple.  It comes with an Imakefile (one of the best
parts about X), so you just say
-->
XPostIt のビルドは簡単です。<tt>Imakefile</tt> (X のベストパーツの一つです) 
が添付されているので以下のようにします。

<tscreen><verb>
% xmkmf
% make
</verb></tscreen>

<!--
If you don't have xmkmf, then whoever installed your release of X screwed
up.  You can get around this by saying
-->
<tt>xmkmf</tt> をお持ちでないなら、X をインストールした人から貰って下さい。
これは以下のように対処することができます。

<tscreen><verb>
% imake -DUseInstalled -I&lt;LIBDIR&gt;/X11/config
% make
</verb></tscreen>

<!--
where "&lt;LIBDIR&gt;" should point to wherever your X11 stuff is installed.  
If you can't find imake, then once again whoever installed your release of X
screwed up.  Please bug them, not me.
-->
"<tt>&lt;LIBDIR&gt;</tt>" は X11 がインストールされているところをポイント
します。<tt>imake</tt> が見つからないときは、再度 X をインストールした人から
貰って下さい。私ではなく彼らを怨んで下さいね。

<!--
You can install XPostIt by saying
-->
XPostIt のインストールは、次のようにします。

<tscreen><verb>
% make install
</verb></tscreen>

<!--
You can install the XPostIt manual page by saying
-->
XPostIt のマニュアルは、次のようにしてインストールします。

<tscreen><verb>
% make install.man
</verb></tscreen>

<!--
Please send all bug reports, fixes, modifications, and features requests
to me.  Please include the version string from version.c.  If you send
diffs, please use "diff -c".
-->
全てのバグ報告／バグ対策／変更／機能の要求は私にお送り下さい。
その際 <tt>version.c</tt> のバージョンの文字列も書き添えて下さい。
差分を送る場合は "<tt>diff -c</tt>" を使って下さい。

<verb>
Dave Curry
Purdue University
Engineering Computer Network
West Lafayette, IN 47907
davy@ecn.purdue.edu
</verb>

</sect>

<sect>訳注
<p>

<sect1>【訳注２】パッケージの入手とインストール
<p>
<tt>xpostit3.3.2.tar.gz</tt> は、
<url url="http://www.ers.ibm.com/~davy/software/xpostit.html"> 
から入手できます。このパッケージが <tt>~</tt> ディレクトリにある場合、展開、
インストールは

<tscreen><verb>
$ su                                ; 1. root になる
# cd /usr/local/src                 ; 2. インストール先に移動
# tar zxvf ~/xpostit3.3.2.tar.gz    ; 3. 展開する
# cd /usr/local/src/xpostit         ; 4. 展開された所に移動
# xmkmf                             ; 5. Makefile を作る
# make                              ; 6. make する
# make install                      ; 7. バイナリをコピー
# make install.man                  ; 8. マニュアルをコピー
</verb></tscreen>

のようにすれば OK な筈なのですが、私の環境(Slackware 3.4, PJE0.1)では、
すんなりとはいきませんでした。

先ず６番目の <tt>make</tt> のところで
<tscreen><verb>
xpostit.c:124: macro 'rindex' used without args
make:***&lsqb;xpostit.o&rsqb; error 1
</verb></tscreen>

というエラーがでました。そこで <tt>xpostit.c</tt> の 124 行目を
<tscreen><verb>
//      char *rindex();
</verb></tscreen>

のように先頭に <tt>'//'</tt> を付けてコメントアウトしてみたところ 
<tt>make</tt> できました。

次に７番目の <tt>make install</tt> では、

<tscreen><verb>
install -c -s xpostit /usr/X11R6/bin/xpostit
make: install: Command not found
make:***&lsqb;install&rsqb; error 127
</verb></tscreen>

というエラーになりました。
<tt>install</tt> というコマンドは <tt>cp</tt> と同じようにファイルをコピー
するが、さらにディレクトリの作成、ファイルのパーミッション、オーナー、
グループ等の設定もできる、つまり 
<tt>install = mkdir + cp + chmod + chown + chgrp</tt> といった感じです。
この <tt>install</tt> コマンドが無いというのは変だなと思って調べたところ、
<tt>/usr/bin/ginstall</tt> というのがあるのを発見しました。そこで、

<tscreen><verb>
# cd /usr/bin
# ln -s ginstall install
</verb></tscreen>

とリンクを張ってみたたところ無事 <tt>make install</tt> できました。

</sect1>
<sect1>
【訳注３】起動と簡単な動作確認
<p>
<tscreen><verb>
$ xpostit &amp;
</verb></tscreen>

と入力すると xpostit が起動し格子縞のメイン画面が表示されます。格子縞の上で
マウスの右ボタンをクリックするとメニューが表示され、その中から例えば 
"<tt>Creaate 3X4 Note</tt>" を選択するとノート(いわゆる付箋紙)のウィンドウが
表示されます。このノートに文字を書き込んだり、他のウィンドウからペーストしたり
できます。ノートはいくつでも開けます。Save ボタンでセーブしておくと次回
起動時にそれが表示されます。詳しい使い方は <tt>man xpostit</tt> で調べて
下さい。

</sect1>
<sect1>
【訳注４】日本語化
<p>
前記のようにして xpostit が動くことは確認できたのですが、付箋(ノート)に英語
しか入力できないのでは利用する場面が限られてしまいます。この xpostit は
国際化対応されているので簡単に日本語化できるとのこと (下記、参考文献を参照) 
なので試してみました。先ず、先程作った英語版バイナリは

<tscreen><verb>
# make clean
</verb></tscreen>

で全て削除します。そして <tt>Imakefile</tt> の

<tscreen><verb>
# DEFINES = -DXI18N
</verb></tscreen>

という行の先頭の <tt>#</tt> を削除(アンコメント)します。これは国際化(I18N)
対応のためのフラグを有効にするということです。この後、

<tscreen><verb>
# xmkmf
# make
</verb></tscreen>

と実行していけばよい筈なのですが、<tt>xmkmf</tt> の実行時に 
<tt>X/Xaw/Xawi18n.h</tt> というファイルが無いという旨のエラーが表示されました。
本当は <tt>Xawi18n.h</tt> をどこかから見つけてくるべきでしょうが面倒なので、

<tscreen><verb>
59  #ifdef XI18N
60  // #include &lt;X11/Xaw/Xawi18n.h&gt;
61  #endif
</verb></tscreen>

のように <tt>xpostit.h</tt> の６０行目の先頭に <tt>'//'</tt> を入れてコメント
アウトしてみたらエラーは出なくなり <tt>make, make install</tt> もできました。

次に <tt>~/.Xdefaults</tt> の最後に以下の行を追加しました。

<tscreen><verb>
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! XPostit
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
xpostit*International:       True
xpostit*inputMethod:         vje 
xpostit*fontSet:\
-misc-fixed-medium-r-normal--14-130-75-75-c-70-iso8859-1,\
-misc-fixed-medium-r-normal--14-*-*-*-*-*-jisx0208.1983-0
</verb></tscreen>

inputMethod は VJE-Delta を使用している場合は上記のように "<tt>vje</tt>" を、
kinput2 の場合は "<tt>kinput2</tt>" と指定します。これて日本語の表示、入力が
できるようになりました。

    参考文献：「Linux を 256倍使うための本」の「Xをいじり倒そう」の章と
              「コンパイルしよう」の章

</sect1>
<sect1>
【訳注５】カラー化などリソースの設定方法
<p>
デフォルトでは xpostit のウィンドウは白黒の２色で表示されますが、これは 
<tt>make install</tt> で <tt>/usr/X11R6/lib/X11/app-defaults</tt> 
ディレクトリにインストールされた白黒用の XPostit という名前のファイルの内容に
基づいてリソースが設定されるためです。このディレクトリには <tt>XPostit-color
</tt> というカラー用の設定ファイルもインストールされます。そこで、

<tscreen><verb>
# cd /usr/X11R6/lib/X11/app-defaults
# mv XPostit XPostit-ORIGIN             ; 元の XPostit をリネーム
# mv XPostit-color XPostit              ; カラーの方を XPostit にリネーム
</verb></tscreen>

としたら背景色が黄色などの色付きで表示できました。好みに合わせて色やフォントを
変更したい場合は、<tt>XPostit-color</tt> の内容を <tt>~/.Xdefaults</tt> に
追加してから編集するようにすればユーザ毎に異なる設定ができます。

なお X で使える色の名前は <tt>/usr/lib/X11/rgb.txt</tt> に一覧があるので、
その中から選びます。名前からおおよそどんな色かは見当がつきますが、実際には
どんな色なのかを目で確認したい場合は以下のようにします。
(Tcl/Tk がインストールされていること)

<tscreen><verb>
$ cd /usr/lib/tk4.2jp/demos.jp      ; 英語版 Tcl/Tk の場合は .jp が付きません
$ widget                            ; デモ用のプログラムを起動
</verb></tscreen>

次に「リストボックス 2.色・アプリケーションのための配色を変える」というデモを
実行し、色の名前をダブルクリックします。

</sect1>
<sect1>
【訳注６】XPostit と XPostitPlus, tkPostit
<p>
XPostit とよく似た名前の XPostitPlus というものがあります。これは
<url url="ftp://ftp.x.org/contrib/office/XPostitPlus-2.3.tar.gz"> 
から入手できます。
また、Slackware 3.4.0 の 4枚組 CD-ROM の 2枚目 
<tt>/cdrom/sunsite/apps/reminder/</tt> 
にも入っていました。XPostitPlus は XPostit をベースに別の作者によってカレンダ
表示とかメール送信などオリジナルに対して多くの機能追加や変更がされたものです。
こちらは残念ながら国際化対応していないので日本語の表示と入力ができません。
XPostit の国際化対応の箇所(grep I18Nで検索する)を参考にすれば XPostitPlus の
国際化も割と簡単に実現できるのではないかと思う(前述の参考文献からの受け売り)
ので、どなたか挑戦して、うまくいったら発表して欲しいなぁと思います。(他力本願)

もう一つ tkPostit というのもあって、こちらは
<url url="http://hpux.u-aizu.ac.jp/hppd/hpux/Tcl/tkPostit-1.4/"> 
から入手できます。これは名前からわかるように Tcl/Tk で書かれています。
これを私の環境 (Tcl7.6jp/Tk4.2jp) で起動してみたところエラーが出たり変な動き
をしました。ドキュメントを見ると、これが作られたのは 1995年9月であり当時の
Tcl7.0/Tk3.3 を使って開発されているようです。
ちなみに Tcl7.0/Tk3.3 ---&gt; Tcl7.6/Tk4.2 は、削除されたり変更されたコマンドや
オプションが結構沢山あるようです。

<verb>
===================================================
  Ryoji Kawagishi
    E-mail:    kawagisi@yk.rim.or.jp
    Homepage:  (R.K's Linux Homepage)
               http://www.yk.rim.or.jp/~kawagisi/
===================================================
</verb>
</sect1>
</sect>
</article>
