
【このファイルについて】
  これはTopazシステムのインストール方法について
  記述したものである。Topaz システムのインストールは、OSあるいはパッケー
  ジ内容（ソース、バイナリ）によって異なるため、該当の項目を参照された
  い。


【インストールを始める前に】
  動作を確認を行った環境を以下に示す。必要なライブラリがない場合や、ライブラ
  リのバージョンが古い場合、正しく動作しない可能性があるので注意されたい。

  Linux
  kernel 2.2.14(x86), libc-2.1.2.so, XFree86 3.3.3.6, egcs-2.91.66
  ncurses-4.2, regex-0.12, readline-2.2.1_jp

  Win32(Windows98, WindowsNT)
  Cygwin 1.1.4
  ncurses-5.2, regex-4.4-2, readline-4.2a-1

【インストール】
1. Unix系OS
      ここでは、Linuxの場合を例に説明する。他のUnix系OSの場合、各プラット
      ホーム用のMakefileを用いれば良い。
           Makefile.lnx        Linux用
           Makefile.sol        Solaris用
           Makefile.freebsd    FreeBSD用

  (1) Topazシステムはライブラリとしてncurses、getopt、regex, readline
      を用いている。システムにこれらのライブラリがインストールされてい
      るか確認する。

      (FreeBSDの場合、ncursesおよびgetoptは、PackagesかPortsで
             devel/libgnugetopt-1.1, devel/ncurses-4.2 
      からインストールするとよい。)

      オリジナルソースは、
           http://www.gnu.org
      から入手可能である。
      また、Topazソースファイルのコンパイルにはgccが必要である。Solaris
      標準のccではコンパイルできない事に注意。

  (2) 適当なディレクトリでソースファイルを展開する。展開されたtop directory
      中のMakefile.lnxを編集する。編集する個所は最初の"INSTALLDIR="の一カ所
      のみであり、ここでTopazシステムをインストールするディレクトリを指定す
      る。
      通常インストールディレクトリは、/usr/local/lib/topazであるので、
            INSTALLDIR=/usr/local/lib/topaz
      と指定する。
      編集が終了したら、以下のようにソースをコンパイルする。
            make -f Makefile.lnx
      コンパイルが正常終了したら、root権限であることを確かめ、以下のように
      インストールを行う。
            su
            make -f Makefile.lnx install

  (3) 次にパスの通ったディレクトリからtopaz.shにシンボリックリンクを張る。

      例：
          cd /usr/local/bin
          ln -s /usr/local/lib/topaz/topaz.sh topaz

      注意) topaz.shは、Topaz実行に必要な環境変数の設定を行った後Topaz本体を
           起動するためのシェルスクリプトである。Topazを/usr/local/lib/以
           外にインストールする場合、topaz.sh中のTOPAZDIRをインストールした
           ディレクトリに合わせて変更する必要がある。

  (4) 初期化スクリプトのカスタマイズを行う。自分のホームディレクトリに、 
      .topazディレクトリおよび.topaz/tmp ディレクトリを作成する。

      例：
           cd ~
           mkdir .topaz
           cd .topaz
           mkdir tmp

      ~/.topazは個人用の初期化スクリプト格納用ディレクトリであり、
      ~/.topaz/tmpはテンポラリファイル用ディレクトリである。初期化スクリプト
      のカスタマイズのためには、/usr/local/lib/topaz/_topaz以下に格納されて
      いる初期化スクリプトのうち、カスタマイズを行うスクリプトを~/.topaz
      にコピーしてからカスタマイズ作業を行う。全てのスクリプトをコピーする
      必要はない。必要なもののみコピーしカスタマイズを行えば良い。初期化スク
      リプトのサーチは/usr/local/lib/topaz/_topaz/よりも~/.topazの方が優先的
      に行われる。
      initparamsを~/.topazにコピーした後、以下の設定を行う。

      ビューア(tpvview)の起動位置およびウインドウサイズを規定するため、
            $graph->init->set('viewer_x', '0');
            $graph->init->set('viewer_y', '0');
            $graph->init->set('viewer_w', '600');
            $graph->init->set('viewer_h', '800');
      を変更する。また印刷処理のため、プリンタ環境に合わせて、例えば以下のよ
      うに変更する。
            $graph->init->set('printscript', '| tpv2ps | lpr -Prps');

     初期化以外の個人用スクリプトは、環境変数TOPAZMACRODIRで指定されたディレ
     クトリに格納するとよい。CUIメニューのMacro|Fileで指定されたスクリプト
     ファイルは、このディレクトリがサーチされ、見つかった場合実行される。

  (5) メニューのリソースファイルの設定を行う。(オプショナル)
     cui.rcはポップアップメニューのカスタマイズを行うための、リソースファ
     イルである。ホットキーの色、メニューエリアの行数、メッセージエリアの
     バッファサイズ、メニュー記述言語のカスタマイズが行える。カスタマイズ
     する場合は、${TOPAZDIR}/_topaz/cui.rcを${HOME}/.topazにコピーしてから、
     ${HOME}/.topaz/cui.rcの編集を行う。cui.rcは${TOPAZDIR}/_topaz/cui.rc
     が最初にサーチされ、見つからない場合${TOPAZDIR}/_topaz/cui.rcがサーチ
     される。
     メニュー記述言語はデフォルトで日本語になっている(kanjimenu = 1)。
     英語メニューを用いる場合は、kanjimenu = 0 とすればよい。

  (6) topazfontmap、topazkfontmapのカスタマイズ。(オプショナル)
     ビューアでテキストがうまく表示されない場合や、TruTypeフォントを用いる
     等でデフォルトのフォントを変更したい場合、設定変更の必要がある。詳し
     くは、doc/tpvview.htmlを参照されたい。

  (7) Topazの起動は、コマンドラインから
          topaz
      と入力する。引数が与えられていないため、Topazは標準の初期化スクリプト
      inittopazを実行することで、ビューアおよびcuimenuをを起動する。


2. Win32(Windows95/98, NT)
  2.1 バイナリパッケージ

  (1) Topazを動作させるためにはcygwin環境が必要である。cygwinのパッケー
      ジは、Cygnus(http://sources.redhat.com/cygwin)から入手できる。
      ただしTopazを動作させるためには、libreadline5やlibncurses6等の
　　　ランタイムライブラリがインストールされている必要がある。

  (2) 配布されたアーカイブをインストールするディレクトリで解凍する。
      /usr/local/libでパッケージを解凍し、/usr/local/binからシンボリッ
      クリンクを張る。

           cd /usr/local/lib
           tar xvzf topaz-x_yz-win32.tar.gz
           cd /usr/local/bin
           ln -s /usr/local/lib/topaz/topaz.sh topaz	

      パッケージにはTopaz起動シェルスクリプトとして、topaz.shが梱包さ
      れている。topaz.shは、shあるいはbash上から、Topaz実行に必要な環
      境変数の設定を行った後、Topaz本体を起動するためのシェルスクリプ
      トである。環境変数の意味を以下に示す。

      TOPAZDIR:    Topazシステムをインストールしたディレクトリ。
                   例：/usr/local/lib/topaz
      TOPAZINIDIR: Topazの個人用初期化スクリプト格納ディレクトリ。
                   例：/home/hogehoge/.topaz (hogehogeはユーザ名)
      TOPAZBIN:    Topaz本体のファイル名(通常はtopaz)

  (3) この状態で一度topazを起動すると、環境変数TOPAZINIDIRで指定された
      ディレクトリ${TOPAZINIDIR}及び、${TOPAZINIDIR}/tmpが作成される。
      ${TOPAZINIDIR}は個人用の初期化スクリプト格納用ディレクトリであり、
      ${TOPAZINIDIR}/tmpはテンポラリファイル用ディレクトリである。
      初期化スクリプトのカスタマイズのためには、
                /usr/local/lib/topaz/_topaz
      以下に格納されている初期化スクリプトのうち、カスタマイズを行う
      スクリプトを${TOPAZINIDIR}にコピーしてからカスタマイズ作業を行う。
      全てのスクリプトをコピーする必要はない。必要なもののみコピーし
      カスタマイズを行えば良い。初期化スクリプトのサーチは
      /usr/local/lib/topaz/_topaz/よりも${TOPAZINIDIR}の方が優先的に行
      われるからである。

      必要なカスタマイズとしては、ビューアの大きさ・位置の指定がある。
      まず、/usr/local/lib/topaz/_topaz/initparamsを
      ${TOPAZINIDIR}にコピーした後、以下の部分を書き換える。
            $graph->init->set('viewer_x', '0');
            $graph->init->set('viewer_y', '0');
            $graph->init->set('viewer_w', '600');
            $graph->init->set('viewer_h', '800');


     初期化以外の個人用スクリプトは、環境変数TOPAZMACRODIRで指定さ
     れたディレクトリに格納するとよい。CUIメニューのMacro|fileで指定された
     スクリプトファイルは、このディレクトリがサーチされ、見つかった場合実
     行される。

  (4) メニューのリソースファイルの設定を行う。(オプショナル)
     cui.rcはポップアップメニューのカスタマイズを行うための、リソースファ
     イルである。ホットキーの色、メニューエリアの行数、メッセージエリアの
     バッファサイズ、メニュー記述言語のカスタマイズが行える。カスタマイズ
     する場合は、${TOPAZDIR}/_topaz/cui.rcを${TOPAZINIDIR}にコピーしてから、
     ${TOPAZINIDIR}/cui.rcの編集を行う。cui.rcは${TOPAZDIR}/_topaz/cui.rc
     が最初にサーチされ、見つからない場合${TOPAZDIR}/_topaz/cui.rcがサーチ
     される。
     メニュー記述言語はデフォルトで日本語になっている(kanjimenu = 1)。
     英語メニューを用いる場合は、kanjimenu = 0 とすればよい。


  2.2 ソースパッケージ

  (1) Topazをコンパイルするためには、cygwin環境が必要である。cygwinのパッ
　　　ケージは、Cygnus(http://sources.redhat.com/cygwin)から入手できる。
      ただしコンパイルのためには、Topaz動作に必要なlibreadline5やlibncurses6等
　　　のランタイムライブラリ以外に、ncurses、readline、regex等のパッケージが
　　　インストールされていなければならない。

  (2) 次にTopazのソースを適当なディレクトリ、例えば/tmpで展開する。/tmp以外
      で展開する場合、適宜以下の/tmpディレクトリ名を適切な名前に読み替える。
      Topazのバージョンが3.00の場合、
          cd /tmp
          tar xvzf topaz-3_00-src.tar.gz
      とする。topaz-3.00ディレクトリがつくられ、この下にパッケージ内容が展開
      される。

  (3) Topazのコンパイルを行う。新しくつくられたtopaz-3.00ディレクトリに移り、
            cd /tmp/topaz-3.00
      このディレクトリ中の中のMakefile.winを編集する。編集する個所は最初
      の"INSTALLDIR="の一カ所のみであり、ここでTopazシステムをインストールす
      るディレクトリを指定する。
      例えば、/usr/local/lib/topazにインストールしたい場合、
            INSTALLDIR=/usr/local/lib/topaz
      の様に指定する。
      編集が終了したら、以下のようにソースをコンパイルする。
            make -f Makefile.win
      コンパイルが正常終了したら、(NTの場合administrator権限であることを確か
      め)、以下のようにインストールを行う。
            make -f Makefile.lnx install
  (6) これ以降の設定は、2.1の(2)、(3)、(4)と同様。

3. その他のUnix系OS
  現在のところ、Linux以外のバイナリパッケージは用意していない。各プラット
  ホーム用のMakefileを用いて、ソースからビルドする必要がある。プラットホーム
  別のMakefileは以下のようになっている。コンパイル方法については、1.2を参照
  されたい。

     Makefile.lnx        Linux用
     Makefile.sol        Solaris用
     Makefile.win        Win32用
     Makefile.freebsd    FreeBSD用

