===================================================================
RCS file: /home/cvs/OpenXM/doc/install.oxweave,v
retrieving revision 1.2
retrieving revision 1.52
diff -u -p -r1.2 -r1.52
--- OpenXM/doc/install.oxweave	1999/12/15 05:53:04	1.2
+++ OpenXM/doc/install.oxweave	2009/02/22 17:30:02	1.52
@@ -1,233 +1,481 @@
-%% $OpenXM: OpenXM/doc/install.oxweave,v 1.1 1999/12/15 03:30:13 takayama Exp $
+%% $OpenXM: OpenXM/doc/install.oxweave,v 1.51 2008/06/03 00:24:49 takayama Exp $
 OpenXM/doc/install.oxweave
 
+/*&C
+
+OpenXM URL :  http://www.math.kobe-u.ac.jp/OpenXM
+              http://www.openxm.org
+
+*/
+
 /*&jp
-$B!z(B OpenXM $B%Q%C%1!<%8$N(B Make $BK!(B
-  FreeBSD 2.2.8, FreeBSD 3.3, Linux $B$GF0:n$9$k$b$N$H4|BT$7$F$^$9(B.
-   OpenXM, OpenXM_contrib, OpenXM_contrib2 $B$,I,MW$G$9(B.
-   cvs $B%3%_%C%?$N>l9g<!$N$h$&$K$7$F%=!<%9$r$H$j$h$;$^$9(B.
+
+------------ ソースからコンパイルしてインストールする方法 ----
+
+(cd OpenXM/src ; make install)
+             バイナリとライブラリとドキュメント類は
+             OpenXM/bin, OpenXM/lib, OpenXM/doc
+             にインストールされます.
+(cd OpenXM/rc ; make install)
+             "asir", "sm1", ... などのシェルスクリプトが生成されて
+             /usr/local/bin
+             にコピーされます.
+             この部分は root で実行してください.
+
+
+たとえば openxm asir と入力して, asir がスタートすればインストール
+はうまくいっていると思われます.
+
+なお一部のソースは ftp://ftp.math.kobe-u.ac.jp/pub/OpenXM/misc より
+OpenXM_dist に make 中に wget コマンドでダウンロードされます.  
+したがって, make するときは
+インターネットに接続されている必要があります.
+
+ファイアウオール内でもし passive ftp が使えない場合は,
+環境変数 ftp_proxy を正しく設定すればうまくいく場合があるかもしれません.
+詳しくは wget のマニュアルを見てください.
+ダウンロードしたライブラリのソースは
+OpenXM_dist ( OpenXM と並列した場所です ) に格納されます.
+ここに手動で必要なライブラリのソースをおいとけば,  offline でも
+コンパイル可能です.
+
 */
+
 /*&eg
-* How to make OpenXM package?
- We have tested the OpenXM package on FreeBSD 2.2.8, FreeBSD 3.3, Linux.
- Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?
- If you are a CVS committer, then you can get all sources as follows:
+
+OpenXM package : Getting started.
+
+
+----------- An instruction for a quick installation from the source code ---
+
+(cd OpenXM/src ;  make install)
+             You will get binaries, libraries, and documents under
+             OpenXM/bin, OpenXM/lib, OpenXM/doc
+(cd OpenXM/rc ; make install)
+             Shell scripts to start "asir", "sm1", ... will be copied to
+             /usr/local/bin
+             This part should be executed as the root.
+
+Please try 
+  openxm asir
+If asir starts, then your installation seems to be successful.
+
+
+Some sources are downloaded from ftp://ftp.math.kobe-u.ac.jp/pub/OpenXM/misc
+to OpenXM_dist during the make by the wget command. 
+So, your machine must be accessible to the internet. 
+
+If you are in a firewall and cannot use even the passive
+ftp, the environmental variable ftp_proxy may help you.
+See the document of wget.  All necessary library sources are downloaded in
+OpenXM_dist at the same level of OpenXM. If you are offline, please put
+all library sources necessary in this directory by hand.
+
 */
-//&C  rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2
-//&C  
-//&jp $B$3$l$i$,$=$m$C$F$$$?$i$"$H$O<!$N$h$&$KF~NO$9$k$@$1$G$9(B.
-//&eg Check that you have these directories, then just type in the following commands
+
+
+/*&jp
+
+
+------- Asir と kan だけで十分な場合
+(cd OpenXM/src ; make install-kan-ox ; make install-asir-contrib)
+             OpenXM 版の Risa/Asir と kan/sm1 が生成インストールされます. 
+(cd OpenXM/rc ; make install)
+
+-------------------------------------------
+asir-contrib 付きの Risa/Asir は OpenXM パッケージのメインクライアントです.
+Risa/asir はコマンド asir で起動できます.
+Risa/Asir および Asir-contrib のマニュアルは
+OpenXM/doc ディレクトリおよび http://www.openxm.org においてあります.
+
+
+*/
+
+
+/*&eg
+
+------- If you need only asir and kan,
+(cd OpenXM/src ; make install-asir2000 ; make install-k097 )
+             You will get only asir and kan/sm1.
+(cd OpenXM/rc ; make install)
+
+-------------------------------------------
+Risa/Asir with asir-contrib is the main client system in the OpenXM project.
+You can start Risa/Asir by the command "asir", which is called
+OpenXM/Risa/Asir.
+It is build by (cd OpenXM/src ; make install-asir-contrib)
+The manual of Risa/Asir and Asir-contrib can be found in the 
+OpenXM/doc directory and http://www.openxm.org
+
+
+*/
+             
+/*&jp
+
+
+-----------  幾つか解説  ------------------
+
+Q.  (cd OpenXM/rc ; make all) はなにをやるの?
+A.   
+    OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc,
+    OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, 等の
+    ファイルを自動生成します.  
+    openxm, asir, oxmath などは OpenXM クライアントを起動するための
+    シエルスクリプトです.  たとえば openxm asir と入力すれば OpenXM 環境で
+    asir が動作します. 
+    これらを /usr/local/bin にインストールするには
+    次のように入力します. 
+
+*/
+/*&eg
+
+-----------  Some Tips ----------------------
+
+Q.   What is done by the command (cd OpenXM/rc ; make all) ?
+A.
+    It generates  OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc and 
+    OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, ...
+    The files openxm, asir, oxmath are shell scripts to invoke OpenXM clients.
+    For example, if you input  
+       openxm asir
+    then asir starts in the OpenXM enviroment.
+    If you want to install these shell scripts to /usr/local/bin,
+    type in as follows.
+
+*/
 /*&C
 
-   cd OpenXM/src
-   make configure
-   make
+     cd OpenXM/rc
+     make install 
 
 */
-/*&jp $B$J$*(B, OpenXM/src/ox_math $B$NMxMQ$K$O(B Mathematica $B$,(B, OpenXM/src/OpenMath
-$B$K$O(B, jdk (java $B4D6-(B) $B$,I,MW$G$9(B.
+/*&jp
+
+     /usr/local/bin でなく, home directory の bin にインストールしたい
+     ときは, 次のように入力してください.
+
 */
-/*&eg In order to use OpenXM/src/ox_math, you need Mathematica. 
-In order to use OpenXM/src/OpenMath, you need jdk (java environment).
+/*&eg
+   
+    If you want to install them under the bin of your home directory,
+    type in as follows.
+
 */
 /*&C
 
+   cd OpenXM/rc
+   make install PREFIX=$HOME/bin
+
 */
+/*&C
+
+   [Note] If you are Solaris user, you might have to type in like
+     /usr/ccs/bin/make install PREFIX=$HOME/bin
+
+*/
 /*&jp
-$B!z(B OpenXM $B%Q%C%1!<%8$NMxMQJ}K!(B
-OpenXM $B$r%[!<%`$ND>2<$KE83+$7$?>l9g(B, $B<!$N$h$&$K$7$^$9(B.
+
+Q. OpenXM/bin の下のファイルを直接実行できるようにしたい.
+A.
+OpenXM/bin の下のファイルを直接実行したい場合は, 以下の設定が必要です.
+
+ # csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます.
+
 */
 /*&eg
-* How to use the OpenXM package?
-If you have OpenXM under your home directory, do as follows.
+
+Q. I want to execute binaries under OpenXM/bin
+A.
+If you want to execute binaries under OpenXM/bin, you need to do 
+the following.
+
+
+ # Append the following line to the end of  ~/.cshrc when you are
+    using csh as your shell.
+
 */
 /*&C
 
-    cp OpenXM/rc/asirrc ~/.asirrc 
-    source OpenXM/rc/bashrc (in case of bash)
-    source OpenXM/rc/cshrc  (in case of csh)
+    source OpenXM/rc/dot.cshrc
 
 */
 /*&jp
-OpenXM $B$r%[!<%`$ND>2<$KE83+$7$F$J$$>l9g$O(B OpenXM/rc/bashrc, OpenXM/rc/cshrc $B$r(B
-$BE,Ev$KJQ99$7$F;HMQ$7$F$/$@$5$$(B.
+ # bash を利用してる場合, 次の行それぞれを ~/.bashrc および ~/.bash_profile
+の最後に加えます.
+
 */
 /*&eg
-If you have OpenXM in a different place, edit OpenXM/rc/bashrc or
-OpenXM/rc/cshrc properly.
+ # Append the following lines to the end of  ~/.bashrc and ~/.bash_profile
+     respectively when you are using bash as your shell.
+
 */
-//&C 
-//&jp asir $B$NMxMQ$K$O(B  key $B$,I,MW$G$9(B.  $B0J2<$N%U%!%$%k$r8fMw$/$@$5$$(B.
-//&eg You need key to use asir.  See the following file:
-//&C OpenXM/lib/asir/asir_key
-//&C  
+/*&C
+
+    source OpenXM/rc/dot.bashrc             (.bashrc)
+
+    source ~/.bashrc                        (.bash_profile)
+
+*/
+
+
 /*&jp
-$BCm0U(B 1.
-asir $B$GF|K\8l$N%X%k%W$rMxMQ$9$k$K$O(B, 
+Q. ox_asir を icon でスタートするには?
+A. 次の行を, .Xdefaults または, xrdb で読み込むファイルに書いておきます.
+*/
+/*&eg
+Q. How to start ox_asir in the iconic mode?
+A. Add the following line to .Xdefaults or a file you read by xrdb.
+*/
+/*&C
+
+       ox_xterm*iconic: on
+
+*/
+
+/*&jp
+
+Q. Make は無事終了しますが, 途中でエラーがでます.
+A.
+OS の標準添付の環境以外が必要なコンポーネントのコンパイルエラーは
+無視されます.
+次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを
+必要とします.
+*/
+/*&eg
+
+Q. Make finishes, but it outputs errors.
+A.
+Compilation errors due to missing commands other than
+standard commands are ignored.
+The following modules require the listed software systems 
+other than the standard OS package.
+*/
+/*&C
+
+(1) OpenXM/bin/oxmath  :       Mathematica Version 3.x or 4.x 
+   (Mathematica server)         at /usr/local/Mathematica
+    OpenXM/bin/math2ox          [ see http://www.wolfram.com ]
+    Asir client functions  m_*
+(2) OpenXM/lib/OpenMath :   JDK
+
+    Asir client functions  om_*
+    sm1 client functions   om_*
+(3) PHC pack (OpenXM/bin/phc)  and  asir client functions phc_*
+    phc_*  run only on linux.
+    If you install the linux emulation on Free BSD, they run on
+    FreeBSD, too. 
+    <note 1>
+      Add linux_enable="YES" in /etc/rc.conf 
+      You need the following packages:
+      pkg_info | grep linu
+      linux_base-*      The base set of packages needed in Linux mode
+      linux_devtools-*  Packages needed for doing development in Linux mode
+(4) The document generation requires
+     latex, platex, tex, ptex, dvips, latex2html, texi2html, nkf
+
+*/
+
+
+/*&jp
+Q. asir の help message が変.
+A.
+asir で日本語のヘルプを利用するには, 
 PAGER=jless
 export PAGER
-$B$J$I$G(B, $BF|K\8l$r07$($k(B PAGER $B$r;XDj$9$kI,MW$,$"$k$+$b$7$l$^$;$s(B.
-$BCm0U(B 2.
-FreeBSD 3.3 $B$J$I$K$O(B, /usr/local/bin/javac $B$,$D$$$F$$$^$9(B.
-$B$3$N(B javac $B$G$O(B, OpenXM/src/OpenMath $B0J2<$N%U%!%$%k$,%3%s%Q%$%k$G$-$^$;$s(B.
-PATH=/usr/local/jdk1.1.8/bin:$PATH
-export PATH
-$B$J$I$H$7$F(B, jdk $B$N(B javac $B$r%5!<%A%Q%9$N@h$N$[$&$X$b$C$F$$$/$h$&$K$7$F(B
-$B$/$@$5$$(B.
+などで, 日本語を扱える PAGER を指定する必要があるかもしれません.
 */
-/*&jp
 
-$B0J>e(B.  $B0J2<$N;HMQNc$X?J$s$G2<$5$$(B.
+/*&C
 
-$B!z(B(1) asir $B$N%^%K%e%"%k$O(B,
-   OpenXM_contrib2/asir2000/doc $B$N(B README $B$r8+$F$M(B.
-  (2) asir-contrib $B$N%^%K%e%"%k$O(B,
-  OpenXM/src/asir-contrib/packages/doc $B$G(B make $B$7$?$"$H(B,
-  ptex cman.texi ($BF|K\8l(B)
-  tex cman-eg.texi ($B1Q8l(B)
-  $B$9$l$P$h$m$7$$(B.
-  Online manual : ox_help(xxx) $B$rMxMQ$9$k$K$O(B, 
-   (cd OpenXM/src/asir-contrib/packages/doc ; make install-help)
-  $B$H$7$^$9(B.
+-----------------------------------------------------
 
-$BCm0U(B:
-$OpenXM_HOME/bin $B$N2<$N(B, fep, phc $B$O(B, $B$$$^$N$H$3$m(B
-linux $BMQ$N%P%$%J%j$^$?$O%P%$%J%j$X$N%7%s%\%j%C%/%j%s%/$G$9(B. 
-Linux $B0J30$N>l9g$O%P%$%J%j$rF~$l49$($kI,MW$,$"$j$^$9(B.
+*/
 
-Solaris $B$G$N(B make $B$NLdBjE@$K$D$$$F$O(B, OpenXM/doc/OpenXM-FAQ-jp.txt
-$B$r8+$F$/$@$5$$(B.
+/*&jp
+Q. OpenXM パッケージの文書は?
+A.
+  OpenXM パッケージでもっとも充実しているクライアントは,
+  asir です.
+  asir のつかいかたは 
+        OpenXM/doc/asir2000/man-ja.pdf
+       または OpenXM/doc/asir2000/html-ja の HTML ファイルを見て下さい.
+  asir 用 OpenXM クライアントライブラリのつかい方は,
+        OpenXM/doc/asir-contrib/cman-ja.pdf
+  を見て下さい.  dvi の付くファイルは xdvi で見ることができます.
 
----------------  $B%$%s%9%H!<%k40N;(B ---------------------------
+  OpenXM の設計の概要については, 
+      OpenXM/doc/issac2000/issac2000.ps
+  を見て下さい.
+  ps の付くファイルは, ghostview で見ることができます.
 
-$B!z;HMQNc(B
+  Mathematica client については, OpenXM/doc/ox_math を御覧ください.
+  sm1 client については, OpenXM/doc/kan96xx を御覧ください.
+  asir は, 多項式処理用のライブラリとしてリンクできます.
+  これについては, OpenXM/doc/oxlib を御覧ください. 
 
-OpenXM $B$O(B X Window System $B>e$G$7$+F0:n$7$^$;$s(B. 
+  OpenXM 対応の, サーバ を作成するには, OpenXM/src/ox_toolkit
+  を見てください. Java のクラスについては 
+  OpenXM/src/OpenMath を見てください.
 
-asir $B$rF0:n$5$;$k$K$O(B, key $B$,I,MW$G$9(B.
-OpenXM/lib/asir/asir_key $B$N%3%a%s%H$r$_$F(B, key $B$r(B E-mail $B$G(B
-$B$H$j$h$;$F2<$5$$(B.
+*/
+/*&eg
+Q. Where can I find documents of the OpenXM package.
+A.
+  The main OpenXM client in the OpenXM package is now 
+  asir.
+  Documents on asir are
+    OpenXM/doc/asir2000/man-en.pdf
+    OpenXM/doc/asir2000/html-en (HTML)
 
-----------------  Asir $B%/%i%$%"%s%H$N;H$$$+$?(B.
-----------------   $BNc(B : asir $B$K(B kan/sm1  $B$rAH$_9~$`(B.
-asir
-load("xm");
-P=sm1_start();    /* P $B$O%W%m%;%9HV9f(B */
-load("katsura");
-sm1_pgb(P,[katsura(4),[u0,u1,u2,u3,u4]]); /* sm1 $B$G%0%l%V%J4pDl$r7W;;(B */
+  The file
+    OpenXM/doc/asir-contrib/cman-en.pdf
+  is a document on OpenXM client libraries for asir.
 
----------------    $BNc(B : asir $B$h$j(B gnuplot $B$r8F$S=P$9(B.
-asir
-load("xm");
-P=gnuplot_start();
-gnuplot(P,"plot  tan(x); ");
-gnuplot(P,"splot sin(x)*cos(x); ");
+  The design outline is described in
+      OpenXM/doc/issac2000/issac2000.ps
 
----------------    $BNc(B : asir $B$h$j(B tigers $B$r8F$S=P$9(B.
-asir
-load("xm");
-tigers_start();
-B = tigers(0,[[1,1,1,1],[0,1,2,3]]);
-length(B) $B$O(B 8 $B$G$9(B.  $B$3$l$O(B, $B9TNs(B A = [[1,1,1,1],[0,1,2,3]]
-$B$KIU?o$7$?(B, toric ideal I_A $B$N(B Grobner fan $B$,(B 8 $B$D$N(B maximal
-dimensional fan $B$r;}$D$3$H$r0UL#$7$^$9(B.
-A[i] $B$O(B i $BHVL\$N(B GB ($B%0%l%V%J4pDl(B)$B$G$9(B.
-Binomial polynomial x^a-x^b $B$r(B [[a_1, ..., a_n],[b_1, ..., b_n]] $B$J$k7A<0$G(B
-$BI=<($7$^$9(B.
-$B$?$H$($P(B A[0];
-[[[1,0,1,0],[0,2,0,0]],[[1,0,0,1],[0,1,1,0]],[[0,1,0,1],[0,0,2,0]]]
-$B$G$9$+$i(B,
-x1 x3 - x2^2, x1 x4 - x2 x3, x2 x4 - x3^2
-$B$,(B GB $B$G$"$j(B, initial ideal $B$O(B
-x1 x3 , x1 x4 , x2 x4 
-$B$G@8@.$5$l$F$$$^$9(B.
+  Dvi files can be previewed by xdvi and
+  ps files  can be previewed by ghostview.
 
-----------------------------------
-sm1
-(oxasir.sm1) run  ;
-(x^20-1). fctr pmat ;       sm1 $B$h$j(B ox_asir $B$r8F$S=P$7$F0x?tJ,2r$5$;$k(B.
+  As to Mathematica client, see OpenXM/doc/ox_math.
+  As to sm1 client, see OpenXM/doc/kan96xx.
+  The asir can be used as a C library for polynomial manupulation.
+  See OpenXM/doc/oxlib.
 
+  If you are interested in writing a server for OpenXM in C or Java, 
+  please refer to
+  OpenXM/src/ox_toolkit and OpenXM/src/OpenMath.
 
+*/
 
-[$BCx:n8"I=<((B] ($B8=:_%F%9%HHG$N$?$a>pJs$,40Hw$7$F$^$;$s(B)
-$B$3$N%=%U%H%&%(%"$OF0:n$*$h$S$=$N7k2L$K$D$-(B, $B0l@Z$NJ]>Z$r$7$^$;$s(B.
-$B%i%$%;%s%97ABV$K$D$$$F$O8=:_8!F$Cf$G$"$j$^$9(B.  $BK!L3(Bcommitter $B$r(B
-$BJg=8Cf(B.
+/*&eg
+Q. I want to install only Risa/Asir.
+A.  
+   If you want to generate only Risa/Asir,  type in as follows.
+*/
+/*&jp
+Q. Risa/Asir のみ install したい.
+A.
+   Risa/Asir のみを生成したい場合は,  つぎのように入力します.
+*/
+/*&C
 
-OpenXM : url http://www.math.kobe-u.ac.jp/openXM
-         cvs cite : kerberos.math.kobe-u.ac.jp
-sm1 :  $B:n<T(B Nobuki Takayama, url http://www.math.kobe-u.ac.jp/KAN, 
-       $B%i%$%;%s%97ABV(B   GPL??
-asir :    $B:n<T(B  url
-         $B%i%$%;%s%97ABV(B   ??
-gnuplot : $B:n<T(B  url
-         $B%i%$%;%s%97ABV(B   GPL?
-phc : $B:n<T(B Jan Verschelde,  url
-         $B%i%$%;%s%97ABV(B   ??
-tigers : $B:n<T(B Birk Hubert,  url
-         $B%i%$%;%s%97ABV(B   ??
+          (cd OpenXM/src ;  make install-asir)
+          (cd OpenXM/rc ; make )
 
-[OpenXM $B$K$D$$$F$NO"Mm@h(B]
-takayama@math.sci.kobe-u.ac.jp
+*/
+/*&eg
+        Copy the shell script "asir" at OpenXM/rc in your search path, e.g.,
+        /usr/local/bin or ~/bin
+        Or, read OpenXM/rc/dot.bashrc or OpenXM/rc/dot.bashrc by the source
+        command from your ~/.bashrc or ~/.cshrc.
+*/
+/*&jp
+        OpenXM/rc の下のシェルスクリプト "asir" をサーチパスにコピーして
+        ください (たとえば, /usr/local/bin or ~/bin へ).
+        または OpenXM/rc/dot.bashrc か OpenXM/rc/dot.cshrc を
+        source コマンドで ~/.bashrc か ~/.cshrc より読み込んでください.
+*/
 
-[OpenXM_HOME $B2<$N%U%!%$%k$N9=@.(B]
-lib/asir $B$K$O(B, asir $B$N%i%$%V%i%j(B, ox_asir $BK\BN(B
-(ox_asir.xxyyzz.os $B$J$kL>A0$G3JG<$5$l$F$$$^$9(B)
+/*&jp 
+Q. OpenXM の下のファイル構成はどうなっていますか?
+A.
+[OpenXM 下のファイルの構成メモ]
+lib/asir には, asir のライブラリ, ox_asir 本体
 
-lib/sm1 $B$O(B src/SSkan/Doc $B$X$N(B symbolic link
-$B$G$"$j(B, sm1 $B$N%i%$%V%i%j%U%!%$%k$,3JG<$5$l$F$$$^$9(B.
-lib/sm1/bin $B$K$O(B, binaryfiles
+cd OpenXM/src/kxx ; make install-for-debug した場合,
+lib/sm1 は src/SSkan/Doc への symbolic link
+であり, sm1 のライブラリファイルが格納されています.
+lib/sm1/bin には, binaryfiles
     sm1, ox_sm1, ox,  ox_log, ox_sm1_*
-$B$X$N%7%s%\%j%C%/%j%s%/$,3JG<$5$l$^$9(B.
-$B$3$N%7%s%\%j%C%/%j%s%/$O(B src/kxx $B$G(B make install $B$r<B9T$9$k$3$H$K$h$j(B
-$B:n@.$5$l$^$9(B.
+へのシンボリックリンクが格納されます.
+このシンボリックリンクは src/kxx で make install-for-debug を実行することにより
+作成されます.
 
-sm1 $B$,(B ox_asir $B$rMxMQ$9$k$N$KI,MW$J%U%!%$%k(B.
+sm1 が ox_asir を利用するのに必要なファイル.
    lib/asir/ox_asir, 
    lib/sm1/bin/ox, lib/sm1/bin/ox_log  (src/kxx/ox, src/kxx/ox_log)
    lib/sm1/ox.sm1, lib/sm1/oxasir.sm1
 
-asir $B$,(B ox_sm1_forAsir $B$rMxMQ$9$k$N$KI,MW$J%U%!%$%k(B:
+asir が ox_sm1_forAsir を利用するのに必要なファイル:
    lib/asir/ox_launch
-   lib/sm1/bin/ox_sm1_forAsir (ox_sm1 $B$X$N%j%s%/(B)
+   lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク)
    lib/asir/xm  
-   lib/sm1/ $B0J2<$N(B *.sm1 $B$J$k$9$Y$F$N(B $B%i%$%V%i%j%U%!%$%k(B.
+   lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル.
      callsm1.sm1 callsm1b.sm1 
-     (ox_sm1_forAsir $B$NDj5A%U%!%$%k(B, src/kxx/oxserver00.c 
-      ox_sm1 $B$,(B ox_sm1_forAsir $B$H$$$&L>A0$G8F$P$l$k$H$3$l$i$N%U%!%$%k$r%m!<%I(B.)
+     (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c 
+      ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.)
 
-asir $B$,(B ox_sm1_gnuplot $B$rMxMQ$9$k$N$KI,MW$J%U%!%$%k(B:
+asir が ox_sm1_gnuplot を利用するのに必要なファイル:
     lib/asir/ox_launch
-    lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 $B$X$N%j%s%/(B, ox_sm1_gnuplot $B$O(B fork $B$7$F(B
-                                gnuplot_forox $B$r<B9T$7$^$9(B.)
+    lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して
+                                gnuplot4ox を実行します.)
     lib/asir/xm  
     lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1
-     (ox_sm1_gnuplot $B$NDj5A%U%!%$%k(B, src/kxx/oxserver00.c 
-      ox_sm1 $B$,(B ox_sm1_gnuplot $B$H$$$&L>A0$G8F$P$l$k$H$3$l$i$N%U%!%$%k$r%m!<%I(B.)
-    bin/gnuplot_forox,  bin/gnuplot_x11  (gnuplot $BK\BN(B, src/gnuplot*)
+     (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c 
+      ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.)
+    bin/gnuplot4ox,  bin/gnuplot_x11  (gnuplot 本体, src/gnuplot*)
 
 ----------------------------------------
-[$B3+H/<TMQ%a%b(B]
+*/
 
-<< sm1, ox_sm1, ox, oxlog $B$N(B debug >>
-binary file $B$O3F(B directory $B$N(B make install $B$K$h$j(B
-OpenXM/bin $B$K%3%T!<$5$l$^$9$,(B,
-debug $BMQ$K$$$A$$$A%3%T!<$9$k$N$OLLE]$J$N$G(B,
-OpenXM/src/kan96xx $B$G(B make install2
-OpenXM/src/kxx $B$G(B make install2
-$B$r<B9T$9$k$H(B, 
-OpenXM/bin/sm1, ox, ox_sm1, oxlog $B$h$j(B,
+/*&jp
+Q. debug するとき make install は面倒. (開発者向け)
+A. 
+<< sm1, ox_sm1, ox, oxlog の debug >>
+binary file は各 directory の make install により
+OpenXM/bin にコピーされますが,
+debug 用にいちいちコピーするのは面倒なので,
+OpenXM/src/kan96xx で make install-for-debug
+OpenXM/src/kxx で make install-for-debug
+を実行すると, 
+OpenXM/bin/sm1, ox, ox_sm1, oxlog より,
 OpenXM/src/kan96xx/Kan/sm1
 OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
-$B$X$N%7%s%\%j%C%/%j%s%/$,:n@.$5$l$^$9(B.
+へのシンボリックリンクが作成されます.
 
-[CVS$B%3%_%C%?MQ%a%b(B]
-<<  OpenXM $B%G%#%l%/%H%jG[I[HG$N:n@.J}K!(B >>
+Q. <<  OpenXM ディレクトリ配布版の作成方法 >>
+A.
+
 rcvs export -rHEAD OpenXM
 rcvs export -rHEAD OpenXM_contrib
 rcvs export -rHEAD OpenXM_contrib2
-$B$7$F(B, OpenXM, OpenXM_contrib, OpenXM_contrib2 $BA4BN$r(B tar+gzip.
+cd OpenXM/src ; make generate-source-distribution
+して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip.
 */
 
+/*&C
+
+*/
+/*&jp
+Q. Solaris でコンパイルがうまくいきません.
+A.
+Solaris ではまだ問題が山積してます.
+Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt
+を見てください.
+Solaris でコンパイルするには, 次が最低限必要です.
+(1) gcc をインストールする.   
+  http://www.gnu.org より Solaris 用 binary を入手できる.  
+ それから [gnu file util と] bison.
+(2) /usr/ccs/bin:/usr/local/bin:/usr/ucb 
+をサーチパスの最初へもっていっておきます.
+C シェルなら
+setenv PATH=/usr/ccs/bin:/usr/local/bin:/usr/ucb:$PATH
+
+これは /usr/ccs/bin/make, /usr/ucb/install を利用する必要があるためです.
+
+*/
+/*&eg
+Q. I cannot make on Solaris.
+A.
+ There are a lot of troubles on Solaris for now.
+ At least, the following two things are prerequisite.
+(1) Installation of gcc (http://www.gnu.org), [gnu file util] and  bison.
+(2) /usr/ccs/bin:/usr/ucb must be at the top of the command search path 
+   to compile on Solaris.  In case of C shell, type in
+   setenv PATH=/usr/ccs/bin:/usr/local/bin:/usr/ucb:$PATH
+   This is because our making procedure requires
+   /usr/ccs/bin/make, /usr/ucb/install
+*/