% 表題 地球流体電脳倶楽部 ごくらく AGCM5   準備
%
% 履歴
\Drireki{96/12/12  堀之内 武}
\Drireki{97/02/06  余田 成男}
%

\Dchapterhead

資源としては, agcm5, gtool(gt3-dcl5), sysmakeの3つが必要である.  また,
gtoolではdcl-5のサブルーチンを使っているので, これがないときにはdcl-5
も必要である. 以下では, dcl-5はすでにインストールされているとして, そ
の手続きは省略する.


\section{親ディレクトリ}

まず, 作業をするディレクトリをつくる. ディレクトリ名は各自の好みでよい.
\begin{verbatim}
% mkdir ~/dennou    
\end{verbatim}
ここでは, ホームディレクトリのしたに \verb!dennou! ディレクトリを作っ
た. 


\section{資源のftp}

agcm5, gtool(gt3-dcl5), sysmakeの3つの資源を近くの電脳サーバーより
anonymous ftpする.
\begin{verbatim}
% cd ~/dennou
% ftp dennou-k
Name: anonymous
Password: 自分のemailアドレス
230 Guest login ok, access restrictions apply.
ftp> cd saloon/dennou_develop/model/agcm5
ftp> dir
total 899
-rw-rw-r--  1 dennou   dennou        736 Nov 12 09:29 TEBIKI.agcm5
drwxrwxr-x  7 dennou   dennou        512 Nov 12 10:08 agcm5.940120
-rw-r--r--  1 dennou   dennou     901780 Nov 12 09:33 agcm5.940120.tar.gz
drwxrwxr-x  3 dennou   dennou        512 Nov 12 10:03 config_local
ftp> binary
ftp> get agcm5.940120.tar.gz
ftp> cd /saloon/dennou_develop/util/gtool
ftp> dir
total 621
drwxrwxr-x  2 60124    dennou        512 Jun 22 05:29 OLD
-rw-rw-rw-  1 60124    dennou       1619 Jun 22 05:28 TEBIKI.gtool
drwxrwxr-x  4 dennou   dennou        512 Oct 18  1995 config_local
lrwxrwxrwx  1 60121    dennou         22 Oct 27 07:30 gt3-dcl5.tar.gz -> gt3-dcl5_960906.tar.gz
-rw-rw-r--  1 60124    dennou     166977 Jun 22 05:37 gt3-dcl5_960110.tar.gz
-rw-rw-r--  1 60124    dennou     163876 Jun 22 07:17 gt3-dcl5_960622.tar.gz
-rw-rw-r--  1 60124    dennou     259415 Sep  6 08:48 gt3-dcl5_960906.tar.gz
ftp> get gt3-dcl5_960906.tar.gz
ftp> cd ../sysmake
ftp> dir
total 12
drwxrwxr-x  2 60124    dennou        512 Jun 22 05:29 OLD
-rw-rw-r--  1 60124    dennou        726 Jun 22 07:39 TEBIKI.sysmake
drwxrwxr-x  3 dennou   dennou        512 Jun 22 05:29 sysmake
lrwxrwxrwx  1 root     1              21 Jun 22 05:29 sysmake.tar.gz -> sysmake_960622.tar.gz
-rw-rw-r--  1 60124    dennou       3645 Jun 22 07:53 sysmake_960622.tar.gz
-rw-rw-r--  1 60124    dennou       3939 Sep  4 08:10 sysmake_960904.tar.gz
ftp> get sysmake_960904.tar.gz
ftp> bye
\end{verbatim}
\vspace{1em}

これで必要な資源が \verb!ftp! できたはずである.
\begin{verbatim}
% ls -l
total 1165
-rw-r--r--  1 horinout   901780 Dec 12 14:08 agcm5.940120.tar.gz
-rw-r--r--  1 horinout   259415 Dec 12 14:19 gt3-dcl5_960906.tar.gz
-rw-r--r--  1 horinout     3939 Dec 12 14:20 sysmake_960904.tar.gz
\end{verbatim}



\section{資源の解凍}

\verb!ftp! した \verb!tar! ファイルは \verb!gzip! で圧縮されているので,
\verb!gzcat! と \verb!tar! で解凍する.
\begin{verbatim}
% gzcat agcm5.940120.tar.gz | tar xvf -
% gzcat gt3-dcl5_960906.tar.gz | tar xvf -
% gzcat sysmake_960904.tar.gz | tar xvf -
% rm *.gz
% du -s *
9495    agcm5.940120
1480    gt3-dcl5
25      sysmake
\end{verbatim}
ここで, \verb!gzcat! (ファイル名) の代りに, \verb!gunzip <! (ファイル
名) としても良い.
\vspace{1em}

ファイル名 \verb!agcm5.940120! は, 標準的な名前に戻しておけばよい. 
\begin{verbatim}
% mv agcm5.940120 agcm5
\end{verbatim}



\section{ドキュメントのコンパイル}

インストールを始める前に, それぞれのドキュメントをコンパイルしておく.
ただし, sysmakeにはドキュメントがない.


\subsection{agcm5のドキュメント}

\verb!agcm5! の下の \verb!doc! ディレクトリにドキュメントがある.
\begin{verbatim}
% cd agcm5/doc/
% ls -l
total 42
-rw-r--r--  1 horinout     2897 Mar  6 13:24 HISTORY.AGCM5.DOC
-rw-r--r--  1 horinout      516 Mar  6 13:24 Makefile
-rw-r--r--  1 horinout      654 Mar  6 13:24 Mkinclude
-rw-r--r--  1 horinout     4116 Mar  6 13:24 STATUS.AGCM5.DOC
-rw-r--r--  1 horinout    26204 Mar  6 13:24 TAGS
drwxr-xr-x 10 horinout      512 Mar  6 13:41 dai1bu/
drwxr-xr-x 10 horinout      512 Mar  6 13:41 dai2bu/
drwxr-xr-x  3 horinout      512 Mar  6 13:41 dai3bu/
drwxr-xr-x 12 horinout      512 Mar  6 13:41 dai4bu/
drwxr-xr-x  8 horinout      512 Mar  6 13:41 gokuraku/
drwxr-xr-x  8 horinout      512 Mar  6 13:41 guide/
\end{verbatim}

{\verb HISTORY.AGCM5.DOC} にはドキュメンテーションに関する経緯が書いて
あり, \verb!STATUS.AGCM5.DOC! にはドキュメントの概略が書いてあるので参
照のこと.  \verb!dai1bu/! などのディレクトリの下には同名の TeX ファイ
ルがあるので, \verb!jlatex! をかける. 
\vspace{1em}

まず, \verb!Mkinclude! を各サイトの状況にあわせて編集する. 
具体的には,マクロ \verb!LPR!, \verb!GUNZIP!,
\verb!MAKE!, \verb!JLATEX!, \verb!DVI2JPS!, \verb!RM! の定義を違うとこ
ろだけ書き換える. もし, sysmake がすでにインストールされているのであれ
ば, そのファイルをインクルードしてその中の定義を利用することも可能であ
る.
\vspace{1em}

{\verb make} でそれぞれのドキュメントの ps ファイルができる. ちゃんと 
ps ファイルが出来ているかを確認して出力する. プリンタ出力は 
\verb!make lpr! とすればよい.
\begin{verbatim}
% make
Making gokuraku/
jlatex gokuraku.tex
(中略)
% ls -l */*.ps
-rw-r--r--  1 horinout   285414 Mar  6 13:30 dai1bu/dai1bu.ps
-rw-r--r--  1 horinout  1242088 Mar  6 13:31 dai2bu/dai2bu.ps
-rw-r--r--  1 horinout  2790150 Mar  6 13:32 dai3bu/dai3bu.ps
-rw-r--r--  1 horinout   949703 Mar  6 13:34 dai4bu/dai4bu.ps
-rw-r--r--  1 horinout   352904 Mar  6 13:29 gokuraku/gokuraku.ps
-rw-r--r--  1 horinout   413994 Mar  6 13:30 guide/guide.ps
% make lpr
Making gokuraku/
lpr -s gokuraku.ps
(中略)
% make clean
\end{verbatim}

設定がわからず \verb!make! に頼れない場合には, 自分で \verb!jlatex! を
かければよい. 例えば, 次のように \verb!foreach! を使って一度にやる.
\begin{verbatim}
% ls */*.tex
dai1bu/dai1bu.tex       dai3bu/dai3bu.tex       gokuraku/gokuraku.tex
dai2bu/dai2bu.tex       dai4bu/dai4bu.tex       guide/guide.tex
% foreach dir ( [a-z]* )
foreach? cd $dir
foreach? jlatex $dir.tex
foreach? jlatex $dir.tex
foreach? jlatex $dir.tex
foreach? dvi2ps $dir.dvi >! $dir.ps
foreach? cd ..
foreach? end
\end{verbatim}
\vspace{1em}

%(参考文献：石渡ノート のコンパイル)
% dai1bu/rikigaku/doushutu/modelm.tex がメインプログラムになっているの
%で、cd dai1bu/rikigaku/doushutu/ して jlatex modelm.tex とすること



\subsection{gtoolのドキュメント}

こちらも \verb!gt3-dcl5! の下の \verb!doc! ディレクトリにドキュメント
がある. やはり \verb!Makefile! がついているので, \verb!make! コマンド
でドキュメントが作れるはずである.
\begin{verbatim}
% cd ../../gt3-dcl5/doc
% make gtool.ps
\end{verbatim}
ただし, \verb!make! を使う場合には \verb!../Mkinclude! を適当に書き換
えていなければ失敗する. また, コマンド \verb!makeindex! がインストール
されてない場合にも失敗する.
\vspace{1em}

\verb!make! に頼れない場合には, 自分で \verb!jlatex! をかければよい. 
\begin{verbatim}
% jlatex gtool.tex
% jlatex gtool.tex
% jlatex gtool.tex
% dvi2ps gtool.dvi >! gtool.ps
% lpr gtool.ps
\end{verbatim}
\vspace{1em}

なお, お掃除は, 
\begin{verbatim}
% make clean
\end{verbatim}
とする. このディレクトリには, TeX ファイル以外に「サンプルプログラム」
(実行型コマンド)の使い方の例が \verb! howtoloo.doc!(テキストファイル)
にもあるので, これも出力しておくとよい.
