===================================================================
RCS file: /home/cvs/OpenXM/doc/install.oxweave,v
retrieving revision 1.20
retrieving revision 1.51
diff -u -p -r1.20 -r1.51
--- OpenXM/doc/install.oxweave	2000/02/01 05:18:28	1.20
+++ OpenXM/doc/install.oxweave	2008/06/03 00:24:49	1.51
@@ -1,279 +1,299 @@
-%% $OpenXM: OpenXM/doc/install.oxweave,v 1.19 2000/01/27 01:13:17 takayama Exp $
+%% $OpenXM: OpenXM/doc/install.oxweave,v 1.50 2008/02/18 06:36:12 takayama Exp $
 OpenXM/doc/install.oxweave
 
 /*&C
+
 OpenXM URL :  http://www.math.kobe-u.ac.jp/OpenXM
-Consult firstly the ERRATA section for your release on this web cite
-for troubles.
+              http://www.openxm.org
 
-OpenXM package : Getting started.
-
 */
+
 /*&jp
-｡� OpenXM ･ﾑ･ﾃ･ｱ｡ｼ･ｸ､ﾎﾍﾑﾊ�ﾋ｡
-､ｳ､ﾎﾀ皃ﾇ､ﾏ, OpenXM package binary distribution ､ﾎ･､･ｹ･ﾈ｡ｼ･�｡､篶ﾀ､ｷ､ﾞ､ｹ.
-･､･ｹ･ﾈ｡ｼ･�ﾋﾉｬﾍﾗ､ﾊ･ｷ･ｹ･ﾆ･爨ﾎｻﾅﾍﾍ､ﾋ､ﾄ､､､ﾆ､ﾏ, ﾆｰｺ鋗ﾄｶｭ､賚ｯ､ﾀ､ｵ､､.
-*/
-/*&eg
-***** HOW TO USE OpenXM PACKAGE?
-In this section, we will explain how to install OpenXM package binary
-distribution.
-As to the required environment, see the section "System Requirement"
-*/
-/*&jp
 
-(1)  Tar ･ﾜ｡ｼ･�隍�｡､ﾎ､隍ｦ､ﾋ､ｷ､ﾆ･ﾇ･｣･�ｯ･ﾈ･� OpenXM ､隍�ﾐ､ｷ､ﾞ､ｹ.
-     OpenXM ､ﾏ､ﾉ､ｳ､ﾋ､ｪ､､､ﾆ､筅ｫ､ﾞ､､､ﾞ､ｻ､�. ･�ｼ･ﾈ､ﾋ､ﾊ､ﾃ､ﾆ･､･ｹ･ﾈ｡ｼ･�
-     ､ｹ､�ｬﾍﾗ､筅｢､熙ﾞ､ｻ､�.
-     ､ﾇ､ｭ､�ﾐ, /usr/local/OpenXM  ､ﾋ､ｪ､､､ﾆ､ﾛ､ｷ､､､ﾈｻﾗ､､､ﾞ､ｹ.
-     
-*/
-/*&eg
+------------ ･ｽ｡ｼ･ｹ､ｫ､鬣ｳ･ﾑ･､･�ｷ､ﾆ･､･ｹ･ﾈ｡ｼ･�ｹ､��ﾋ｡ ----
 
-(1)  Extract the directory OpenXM from the tar ball.
-     You can put the directory OpenXM at any place in the file system.
-     You do not need to be a root to install it.
-     We are happy if you put OpenXM at /usr/local/OpenXM
+(cd OpenXM/src ; make install)
+             ･ﾐ･､･ﾊ･熙ﾈ･鬣､･ﾖ･鬣熙ﾈ･ﾉ･ｭ･螂皈ﾈﾎ爨ﾏ
+             OpenXM/bin, OpenXM/lib, OpenXM/doc
+             ､ﾋ･､･ｹ･ﾈ｡ｼ･�ｵ､�ﾞ､ｹ.
+(cd OpenXM/rc ; make install)
+             "asir", "sm1", ... ､ﾊ､ﾉ､ﾎ･ｷ･ｧ･�ｹ･ｯ･�ﾗ･ﾈ､ｬﾀｸﾀｮ､ｵ､�ﾆ
+             /usr/local/bin
+             ､ﾋ･ｳ･ﾔ｡ｼ､ｵ､�ﾞ､ｹ.
+             ､ｳ､ﾎﾉｬ､ﾏ root ､ﾇｼﾂｹﾔ､ｷ､ﾆ､ｯ､ﾀ､ｵ､､.
 
-*/
-/*&C
-         tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz
 
-*/
-/*&jp
-ｰﾊｲｼ (1) ､ﾇﾀｸﾀｮ､ｵ､�ｿ･ﾇ･｣･�ｯ･ﾈ･� OpenXM ､ﾎﾀ萃ﾐ･ﾑ･ｹ､� /xxx/yyy/OpenXM
-､ﾈｽｭ､ﾞ､ｹ.
+､ｿ､ﾈ､ｨ､ﾐ 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
-In the sequel, we will denote the absolute path of the directory OpenXM 
-by /xxx/yyy/OpenXM.
 
+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.
+
 */
+
+
 /*&jp
-(2) ｼ｡､ﾎ､隍ｦ､ﾋﾆ�ﾎﾏ､ｷ､ﾆ OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc,
-     OpenXM/rc/openxm
-    ･ﾕ･｡･､･�ｫﾆｰﾀｸﾀｮ､ｷ､ﾞ､ｹ.
-    ､ｳ､�鬢ﾎ･ﾕ･｡･､･�ﾋ､ﾏ, OpenXM/bin ､ﾎ･ﾕ･｡･､･�ﾂｹﾔ､ｹ､�ｿ､皃ﾎ
-    ｴﾄｶｭﾊﾑｿｬﾄ�ﾁ､ｵ､�ﾆ､､､ﾞ､ｹ.
 
+
+------- 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
-(2) Generate  OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc and 
-    OpenXM/rc/openxm
-    by the following command.
-    Environmental variables to execute commands in OpenXM/bin
-    are defined in these files.
 
-*/
-/*&C
+------- 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)
 
-     cd /xxx/yyy/OpenXM/rc
-     make
+-------------------------------------------
+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
-(3) csh ､ﾑ､ｷ､ﾆ､���, ｼ｡､ﾎｹﾔ､� ~/.cshrc ､ﾎｺﾇｸ螟ﾋｲﾃ､ｨ､ﾞ､ｹ.
 
+
+-----------  ｴﾄ､ｫｲ�  ------------------
+
+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
-(3) Append the following line to the end of  ~/.cshrc when you are
-    using csh as your shell.
 
+-----------  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
 
-    source /xxx/yyy/OpenXM/rc/dot.cshrc
+     cd OpenXM/rc
+     make install 
 
 */
 /*&jp
-(3') bash ､ﾑ､ｷ､ﾆ､���, ｼ｡､ﾎｹﾔ､� ~/.bashrc ､ﾎｺﾇｸ螟ﾋｲﾃ､ｨ､ﾞ､ｹ.
 
+     /usr/local/bin ､ﾇ､ﾊ､ｯ, home directory ､ﾎ bin ､ﾋ･､･ｹ･ﾈ｡ｼ･�ｷ､ｿ､､
+     ､ﾈ､ｭ､ﾏ, ｼ｡､ﾎ､隍ｦ､ﾋﾆ�ﾎﾏ､ｷ､ﾆ､ｯ､ﾀ､ｵ､､.
+
 */
 /*&eg
-(3') Append the following line to the end of  ~/.bashrc when you are
-    using bash as your shell.
+   
+    If you want to install them under the bin of your home directory,
+    type in as follows.
 
 */
 /*&C
 
-    source /xxx/yyy/OpenXM/rc/dot.bashrc
+   cd OpenXM/rc
+   make install PREFIX=$HOME/bin
 
 */
+/*&C
 
-/*&jp
+   [Note] If you are Solaris user, you might have to type in like
+     /usr/ccs/bin/make install PREFIX=$HOME/bin
 
- (3) ､ﾞ､ｿ､ﾏ (3') ､ｪﾎｻ､ｷ､ｿ､�, ､､､ﾃ､ｿ､� logout ､ｷ､ﾆ login ､ｷ､ﾊ､ｪ､ｹ､ｫ
- ､ﾞ､ｿ､ﾏ, source ･ｳ･ﾞ･ﾉ､ﾇ, dot.bashrc ､ﾞ､ｿ､ﾏ dot.csh ､ﾉ､ﾟｹ�､ﾇｲｼ､ｵ､､.
- (3)  ､ﾞ､ｿ､ﾏ (3') ､荀鬢ﾊ､､､ﾈ､､､ｦﾁｪﾂ筅｢､熙ﾞ､ｹ.
- ､ｳ､ﾎｾ��, ･ｷ･ｧ･�ｹ･ｯ･�ﾗ･ﾈ 
- OpenXM/rc/openxm ､� ･ｳ･ﾞ･ﾉ･ｵ｡ｼ･ﾁ･ﾑ･ｹ､ﾋｰﾜ､ｷ,
- OpenXM/bin ｰﾊｲｼ､ﾎﾁｴ､ﾆ､ﾎ･ｳ･ﾞ･ﾉ､ﾎｼﾂｹﾔ､ﾏ, 
-    openxm ･ｳ･ﾞ･ﾉﾌｾ
- ､ﾈ､､､ｦｷﾁ､ﾇｸﾆ､ﾓｽﾐ､ｷ､ﾞ､ｹ.
- ､ｿ､ﾈ､ｨ､ﾐ,  openxm asir ､ﾈ､ｫ  openxm sm1 ､ﾈ､､､ｦｷﾁ､ﾇ､隍ﾓ､ﾀ､ｷ､ﾞ､ｹ.
-
 */
-/*&eg 
-   
-   After finishing the step (3) or (3'), logout and login again,
-   or read dot.bashrc or dot.cshrc file by the source command.
-   You may skip the step (3) or (3').
-   In this case, move the shell script OpenXM/rc/openxm to your
-   command search path. To execute commands in OpenXM/bin,  type in
-       openxm command-name
-   For example,  "openxm asir"  starts asir and "openx sm1" starts sm1
-   with a proper setting of environmental variables.
+/*&jp
 
-*/
+Q. OpenXM/bin ､ﾎｲｼ､ﾎ･ﾕ･｡･､･�ｾﾀﾜｼﾂｹﾔ､ﾇ､ｭ､�隍ｦ､ﾋ､ｷ､ｿ､､.
+A.
+OpenXM/bin ､ﾎｲｼ､ﾎ･ﾕ･｡･､･�ｾﾀﾜｼﾂｹﾔ､ｷ､ｿ､､ｾ�遉ﾏ, ｰﾊｲｼ､ﾎﾀﾟﾄ熙ｬﾉｬﾍﾗ､ﾇ､ｹ.
 
+ # csh ､ﾑ､ｷ､ﾆ､���, ｼ｡､ﾎｹﾔ､� ~/.cshrc ､ﾎｺﾇｸ螟ﾋｲﾃ､ｨ､ﾞ､ｹ.
 
-//&C 
-//&jp (4) asir ､ﾎﾍﾑ､ﾋ､ﾏ  key ､ｬﾉｬﾍﾗ､ﾇ､ｹ.  
-//&eg (4) You need a key to use asir.  
-//&C  
-/*&jp 
-    asir ､ﾎｵｯﾆｰｻ�､ﾎ･皈ﾃ･ｻ｡ｼ･ｸ､ﾞ､ｿ､ﾏ OpenXM/lib/asir/asir_key ､�
-    ｻｲｾﾈ､ｷ､ﾆ, key ､霹ﾀ､ｷ､ﾆｲｼ､ｵ､､ (ｿﾃ､ｷ､ｫ､ｫ､ｫ､熙ﾞ､ｻ､�).
-
 */
 /*&eg
-    Please get the key by following the instruction from asir itself or
-    that in OpenXM/lib/asir/asir_key (it takes only a few seconds
-    to get the key).
 
-*/
+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.
 
-/*&C
 
-***** QUALITY:
-  the following modules and functions have still experimental qualities:
-   OpenXM/bin/k0,  OpenXM/bin/d0
-   OpenXM/bin/ox_math,  OpenXM/bin/math2ox
-   OpenXM/lib/java-support/ *
-   Asir client functions:   m_* (Mathematica)  ,  om_*  (OpenMath)
-   OpenXM/bin/sm1, ox_sm1 on Linux libc6.
+ # Append the following line to the end of  ~/.cshrc when you are
+    using csh as your shell.
+
 */
 /*&C
 
+    source OpenXM/rc/dot.cshrc
 
 */
 /*&jp
-｡� Java ､ﾋｴﾘ､ｹ､�擎ﾕ:
-ﾃ擎ﾕ 1.
-OpenMath ﾍﾑ､ﾎ OMproxy ､ﾋ､ﾏｸｽｺﾟ､ﾎ､ﾈ､ｳ､�, jdk ､ｬﾉｬﾍﾗ､ﾇ､ｹ.
-､ｿ､ﾈ､ｨ､ﾐ bash ､ﾑ､ｷ､ﾆ､､､���, .bashrc ､ﾇ
-PATH=/usr/local/jdk1.1.8/bin:$PATH
-export PATH
-､ﾊ､ﾉ､ﾈ､ｷ､ﾆ, jdk ､ﾎ java, javac ､ｵ｡ｼ･ﾁ･ﾑ･ｹ､ﾎﾀ隍ﾎ､ﾛ､ｦ､ﾘ､筅ﾃ､ﾆ､､､ｯ､隍ｦ､ﾋ､ｷ､ﾆ
-､ｯ､ﾀ､ｵ､､.
-csh ､ﾑ､ｷ､ﾆ､､､���, .cshrc ､ﾇ
-set path=(/usr/local/jdk1.1.8/bin $path)
-､ﾈ､ｷ､ﾆ, jdk ､ﾎ java, javac ､ｵ｡ｼ･ﾁ･ﾑ･ｹ､ﾋ､､､�ﾞ､ｹ.
+ # bash ､ﾑ､ｷ､ﾆ､���, ｼ｡､ﾎｹﾔ､ｽ､�ｾ､�� ~/.bashrc ､ｪ､隍ﾓ ~/.bash_profile
+､ﾎｺﾇｸ螟ﾋｲﾃ､ｨ､ﾞ､ｹ.
 
-ﾃ擎ﾕ:
-､ﾊ､ｪ, Kaffe 1.0.b4 ､ﾎ java ､ﾏ, class BigInteger ､ﾋ method
-toByteArray ､ｬｴﾞ､ﾞ､�ﾆ､ﾊ､､､ｿ､�, OpenMath ･筵ｸ･蝪ｼ･�ﾇ､ﾏｻﾈﾍﾑ､ﾇ､ｭ､ﾞ､ｻ､�.
 */
 /*&eg
-***** JAVA
-In order to use OMproxy, asir client om_*,
-you need to install JDK.
-The bin dir of the JDK must be in yur search path.
-For example, you need to add the following line
-to your .chsrc when your shell is csh
-set path=(/usr/local/jdk1.1.8/bin $path)
-Bash users put the following line to .bashrc
-PATH=/usr/local/jdk1.1.8/bin:$PATH
-export PATH
+ # Append the following lines to the end of  ~/.bashrc and ~/.bash_profile
+     respectively when you are using bash as your shell.
 
-Remark:
-The Java interpreter of Kaffe 1.0.b4 does not contain the method
-toByteArray in the class BigInteger.
-So, it cannot be used for the OpenMath module.
 */
-
 /*&C
 
+    source OpenXM/rc/dot.bashrc             (.bashrc)
 
+    source ~/.bashrc                        (.bash_profile)
 
-
 */
-/*&jp
-｡� ﾆｰｺ鋗ﾄｶｭ
 
+
+/*&jp
+Q. ox_asir ､� icon ､ﾇ･ｹ･ｿ｡ｼ･ﾈ､ｹ､�ﾋ､ﾏ?
+A. ｼ｡､ﾎｹﾔ､�, .Xdefaults ､ﾞ､ｿ､ﾏ, xrdb ､ﾇﾆﾉ､ﾟｹ�､爭ﾕ･｡･､･�ﾋｽ､､ﾆ､ｪ､ｭ､ﾞ､ｹ.
 */
 /*&eg
-***** SYSTEM REQUIREMENTS
-
+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
 
-OS:  FreeBSD 3.3 (Intel CPU),  
-     Linux systems (Intel CPU):
-         Most Linux with libc5 and with libc6 (glibc 2.x).  
+       ox_xterm*iconic: on
 
-     X window system is required.
-
-     Most part of the OpenXM package may work on other versions of 
-     FreeBSD 3.x and Linux, but we have not yet tested.
-
 */
+
 /*&jp
+
+Q. Make ､ﾏﾌｵｻｪﾎｻ､ｷ､ﾞ､ｹ､ｬ, ﾅﾓﾃ讀ﾇ･ｨ･鬘ｼ､ｬ､ﾇ､ﾞ､ｹ.
+A.
+OS ､ﾎﾉｸｽ倏ｺﾉﾕ､ﾎｴﾄｶｭｰﾊｳｰ､ｬﾉｬﾍﾗ､ﾊ･ｳ･ﾝ｡ｼ･ﾍ･ﾈ､ﾎ･ｳ･ﾑ･､･�ｨ･鬘ｼ､ﾏ
+ﾌｵｻ�ｵ､�ﾞ､ｹ.
 ｼ｡､ﾎ modules ､ﾏ, OS ､ﾎﾉｸｽ� distribution ｰﾊｳｰ､ﾋ, ､ｵ､鬢ﾋｲｼ､ﾋｵｭ､ｷ､ｿ･ｽ･ﾕ･ﾈ､�
 ﾉｬﾍﾗ､ﾈ､ｷ､ﾞ､ｹ.
 */
 /*&eg
-The following modules require the listed softwares other than the standard
-OS package.
+
+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/ox_math  :       Mathematica Version 3.x or 4.x 
+(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/java-support :   JDK at /usr/local/jdk??
-                                [ see the section on JAVA]
+(2) OpenXM/lib/OpenMath :   JDK
+
     Asir client functions  om_*
     sm1 client functions   om_*
-(3) PHC pack (OpenXM/bin/phc)  and  asir client functions
-    phc_*  run only on linux (glib5).
-    If you install the linux emulation^{note 1} on Free BSD, they run on
+(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-5.2      The base set of packages needed in Linux mode
-      linux_devtools-5.2  Packages needed for doing development in Linux mode
+      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
-ﾆ�ﾜｸ�ﾇ､ﾎﾃ擎ﾕ.
-ﾃ擎ﾕ 1.
+Q. asir ､ﾎ help message ､ｬﾊﾑ.
+A.
 asir ､ﾇﾆ�ﾜｸ�ﾎ･ﾘ･�ﾗ､ﾑ､ｹ､�ﾋ､ﾏ, 
 PAGER=jless
 export PAGER
 ､ﾊ､ﾉ､ﾇ, ﾆ�ﾜｸ�ｷ､ｨ､� PAGER ､ﾘﾄ熙ｹ､�ｬﾍﾗ､ｬ､｢､�ｫ､筅ｷ､�ﾞ､ｻ､�.
 */
 
-/*&eg
+/*&C
 
-The installation is completed. 
+-----------------------------------------------------
 
 */
-/*&jp
 
-ｰﾊｾ�. 
-
-*/
-
 /*&jp
-｡� ﾊｸｽ�
-
+Q. OpenXM ･ﾑ･ﾃ･ｱ｡ｼ･ｸ､ﾎﾊｸｽﾏ｡ｩ
+A.
   OpenXM ･ﾑ･ﾃ･ｱ｡ｼ･ｸ､ﾇ､筅ﾃ､ﾈ､篆ｼｼﾂ､ｷ､ﾆ､､､�ｯ･鬣､･｢･ﾈ､ﾏ,
   asir ､ﾇ､ｹ.
   asir ､ﾎ､ﾄ､ｫ､､､ｫ､ｿ､ﾏ 
@@ -288,11 +308,20 @@ The installation is completed. 
   ､ｫ､ﾆｲｼ､ｵ､､.
   ps ､ﾎﾉﾕ､ｯ･ﾕ･｡･､･�ﾏ, ghostview ､ﾇｸｫ､�ｳ､ﾈ､ｬ､ﾇ､ｭ､ﾞ､ｹ.
 
+  Mathematica client ､ﾋ､ﾄ､､､ﾆ､ﾏ, OpenXM/doc/ox_math ､賚ｯ､ﾀ､ｵ､､.
+  sm1 client ､ﾋ､ﾄ､､､ﾆ､ﾏ, OpenXM/doc/kan96xx ､賚ｯ､ﾀ､ｵ､､.
+  asir ､ﾏ, ﾂｿｹ狆ｰｽ靉�ﾍﾑ､ﾎ･鬣､･ﾖ･鬣熙ﾈ､ｷ､ﾆ･�ｯ､ﾇ､ｭ､ﾞ､ｹ.
+  ､ｳ､�ﾋ､ﾄ､､､ﾆ､ﾏ, OpenXM/doc/oxlib ､賚ｯ､ﾀ､ｵ､､. 
+
+  OpenXM ﾂﾐｱ�､ﾎ, ･ｵ｡ｼ･ﾐ ､鋿ｮ､ｹ､�ﾋ､ﾏ, OpenXM/src/ox_toolkit
+  ､ｫ､ﾆ､ｯ､ﾀ､ｵ､､. Java ､ﾎ･ｯ･鬣ｹ､ﾋ､ﾄ､､､ﾆ､ﾏ 
+  OpenXM/src/OpenMath ､ｫ､ﾆ､ｯ､ﾀ､ｵ､､.
+
 */
 /*&eg
-***** DOCUMENTS
-
-  The best OpenXM client in the OpenXM package is now 
+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-eg.dvi
@@ -307,170 +336,50 @@ The installation is completed. 
 
   Dvi files can be previewed by xdvi and
   ps files  can be previewed by ghostview.
-*/
 
+  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.
 
-/*&eg
+  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.
 
-
-***** A QUICK TOUR OF OPENXM BY ASIR
-
 */
-/*&jp
 
-
-｡� ASIR ､ﾋ､隍�ﾈﾍﾑﾎ�  
-
-
-asir ､ｰｺ釥ｵ､ｻ､�ﾋ､ﾏ, key ､ｬﾉｬﾍﾗ､ﾇ､ｹ.
-OpenXM/lib/asir/asir_key ､ﾎ･ｳ･皈ﾈ､ﾞ､ｿ､ﾏｵｯﾆｰｻ�､ﾎ･皈ﾃ･ｻ｡ｼ･ｸ､ﾟ､ﾆ, 
-key ､� E-mail ､ﾇ､ﾈ､熙隍ｻ､ﾆｲｼ､ｵ､､.
-
-*/
-/*&C
-----------------   Call ox_sm1 from asir.
-bash-2.03$ asir
-This is Risa/Asir, Version 20000120.
-Copyright (C) FUJITSU LABORATORIES LIMITED.
-1994-1999. All rights reserved.
-xm Version 20000116. ox_help(0); ox_help("keyword"); for help message 
-[269] sm1_genericAnn([x^3-y^2,[s,x,y]]); 
-   /* The annihilating ideal of (x^3-y^2)^s */
-[-2*y*dx-3*x^2*dy,2*x*dx+3*y*dy-6*s]
-
-
----------------    Call gnuplot from asir.
-bash-2.03$ asir
-This is Risa/Asir, Version 20000120.
-Copyright (C) FUJITSU LABORATORIES LIMITED.
-1994-1999. All rights reserved.
-xm Version 20000116. ox_help(0); ox_help("keyword"); for help message 
-[269] gnuplot("plot sin(x);");
-0
-[270] 
-
-*/
-
-/*&jp 
-
-｡�  sm1 ･ｯ･鬣､･｢･ﾈ､ﾎﾍﾑﾎ�
-
-*/
 /*&eg
-
-******  Example of the use of sm1 client
-
+Q. I want to install only Risa/Asir.
+A.  
+   If you want to generate only Risa/Asir,  type in as follows.
 */
-
-/*&C
---------------------------------------  call ox_asir from sm1
-sm1
-(oxasir.sm1) run  ;
-[(x^20-y^20) (x,y)] fctr pmat ;     factorize x^20-y^20 by call ox_asir
-
-
-*/
-
 /*&jp
-[ﾃ鋕｢ﾉｽｼｨ] 
-OpenXM/Copyright ､賚ｯ､ﾀ､ｵ､､.
+Q. Risa/Asir ､ﾎ､ﾟ install ､ｷ､ｿ､､.
+A.
+   Risa/Asir ､ﾎ､ﾟ､ｸﾀｮ､ｷ､ｿ､､ｾ�遉ﾏ,  ､ﾄ､ｮ､ﾎ､隍ｦ､ﾋﾆ�ﾎﾏ､ｷ､ﾞ､ｹ.
 */
-/*&eg
-[COPYRIGHT]
-See OpenXM/Copyright.
-*/
+/*&C
 
-/*&eg
+          (cd OpenXM/src ;  make install-asir)
+          (cd OpenXM/rc ; make )
 
-
-
-*****  TO COMPILE FROM A SOURCE *****
-
 */
-/*&jp
-
-
-｡� OpenXM ･ﾑ･ﾃ･ｱ｡ｼ･ｸ､ﾎ Make ﾋ｡
-  FreeBSD 2.2.8, FreeBSD 3.3, Linux ､ﾇﾆｰｺ釥ｹ､�筅ﾎ､ﾈｴ�ﾔ､ｷ､ﾆ､ﾞ､ｹ.
-  Linux glib6 ､ﾇ､ﾏ, ､､､ﾞ､ﾎ､ﾈ､ｳ､�, /usr/include/features.h
-  ､ﾇ #define __FAVOR_BSD 1 ､ｷ､ﾆ･ｳ･ﾑ･､･�ｹ､�ｬﾍﾗ､ｬ､｢､熙ｷ､ｿ､ｬ,
-  ｰ�ﾎ･ｽ｡ｼ･ｹ､�
-  -D_BSD_SOURCE option ､ﾄ､ｱ､ﾆ gcc ､ﾇ･ｳ･ﾑ･､･�ｹ､�隍ｦ､ﾋﾊﾑ､ｨ､ﾆ､ﾞ､ｹ
-  (setjmp ､ﾈ sigsetjmp ､ﾎﾌ萃�, dirty trick).
-
-   OpenXM, OpenXM_contrib, OpenXM_contrib2 ､ｬﾉｬﾍﾗ､ﾇ､ｹ.
-   cvs ･ｳ･ﾟ･ﾃ･ｿ､ﾎｾ�郛｡､ﾎ､隍ｦ､ﾋ､ｷ､ﾆ･ｽ｡ｼ･ｹ､ﾈ､熙隍ｻ､ﾞ､ｹ.
-*/
 /*&eg
-* How to make OpenXM package?
- We have tested the OpenXM package on FreeBSD 2.2.8, FreeBSD 3.3, Linux.
- On Linux glib6, we needed to define 
-   #define  __FAVOR_BSD 1
- in /usr/include/features.h,
- but now we are compiling some sources with -D_BSD_SOURCE
- (setjmp vs sigsetjmp).
-
- Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?
- If you are a CVS committer, then you can get all sources as follows:
+        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.
 */
-//&C  rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2
-//&C  
-//&jp ､ｳ､�鬢ｬ､ｽ､惕ﾃ､ﾆ､､､ｿ､鬢｢､ﾈ､ﾏｼ｡､ﾎ､隍ｦ､ﾋﾆ�ﾎﾏ､ｹ､�ﾀ､ｱ､ﾇ､ｹ.
-//&eg Check that you have these directories, then just type in the following commands
-/*&C
-
-   cd OpenXM/src
-   make configure
-   make 
-   make install
-
-*/
-/*&jp ､ﾊ､ｪ, OpenXM/src/ox_math ､ﾎ･ｳ･ﾑ･､･�ｪ､隍ﾓﾍﾑ､ﾋ､ﾏ Mathematica ､ｬ, 
-OpenXM/src/OpenMath ､ﾎ･ｳ･ﾑ･､･�ｪ､隍ﾓﾍﾑ､ﾋ､ﾏ
-､ﾋ､ﾏ, jdk (java ｴﾄｶｭ) ､ｬﾉｬﾍﾗ､ﾇ､ｹ.
-
-Documents ､ｸﾀｮ､ｹ､�ﾋ､ﾏ,  tex, ptex (ascii ﾆ�ﾜｸ� tex), dvips, texinfo, 
-texi2html, nkf, 
-､ｬﾉｬﾍﾗ､ﾇ､ｹ. ｾﾜ､ｷ､ｯ､ﾏ Makefiles ､ｫ､ﾆｲｼ､ｵ､､.
-Document ､ﾏ, binary distribution ､ﾎ OpenXM/doc, OpenXM/lib 
-､隍�ﾀ､�ﾎ､ｬｴﾊﾃｱ､ﾇ､ｹ.
-*/
-/*&eg In order to use and compile OpenXM/src/ox_math, you need Mathematica. 
-In order to use and compile OpenXM/src/OpenMath, 
-you need jdk (java environment).
-
-In order to generate the full documentation including Japanese documents,
-you need tex, ptex (ASCII Inc. Japanese tex), dvips, texinfo, texi2html,
-nkf. See each Makefile.
-The generated documents are in OpenXM/doc and OpenXM/lib 
-in the binary distribution.
-If you do not like to install Japanese environment such as ptex, 
-type in R for the tex error prompt ? or 
-prepare empty shell scripts ptex and nkf.
-*/
-/*&C
-
-*/
 /*&jp
-  
-  OpenXM_contrib2/asir2000 ､ﾎﾇﾛﾉﾛ､ｱ､ﾆ､ﾊ､､ｾ�� (･ｽ｡ｼ･ｹ･鬣､･ｻ･ｹ､�
-  ﾉﾙｻﾎﾄﾌ､隍�ｱ､�ｬﾍﾗ､ｬ､｢､熙ﾞ､ｹ),
-  OpenXM/src/Makefile ､ﾎｳﾆ･筵ｸ･蝪ｼ･�ｾ ､ｿ､ﾈ､ｨ､ﾐ
-   make all-kan96xx
-  ､ﾊ､ﾉ､ﾈｳﾆ･筵ｸ･蝪ｼ･�ｾ､ﾘﾄ熙ｷ､ﾆ･ｳ･ﾑ･､･�ｷ､ﾆｲｼ､ｵ､､.
-
+        OpenXM/rc ､ﾎｲｼ､ﾎ･ｷ･ｧ･�ｹ･ｯ･�ﾗ･ﾈ "asir" ､ｵ｡ｼ･ﾁ･ﾑ･ｹ､ﾋ･ｳ･ﾔ｡ｼ､ｷ､ﾆ
+        ､ｯ､ﾀ､ｵ､､ (､ｿ､ﾈ､ｨ､ﾐ, /usr/local/bin or ~/bin ､ﾘ).
+        ､ﾞ､ｿ､ﾏ OpenXM/rc/dot.bashrc ､ｫ OpenXM/rc/dot.cshrc ､�
+        source ･ｳ･ﾞ･ﾉ､ﾇ ~/.bashrc ､ｫ ~/.cshrc ､隍�ﾉ､ﾟｹ�､ﾇ､ｯ､ﾀ､ｵ､､.
 */
-/*&eg
-  
-  If you cannot get a source liscence of OpenXM_contrib2/asir2000
-  from Fujitsu labs,
-  compile each modules independently, e.g.,
-    make all-kan96xx
 
-*/
-
 /*&jp 
-
+Q. OpenXM ､ﾎｲｼ､ﾎ･ﾕ･｡･､･�ｽﾀｮ､ﾏ､ﾉ､ｦ､ﾊ､ﾃ､ﾆ､､､ﾞ､ｹ､ｫ?
+A.
 [OpenXM ｲｼ､ﾎ･ﾕ･｡･､･�ﾎｹｽﾀｮ･皈秕
 lib/asir ､ﾋ､ﾏ, asir ､ﾎ･鬣､･ﾖ･鬣�, ox_asir ﾋﾜﾂﾎ
 
@@ -508,8 +417,11 @@ asir ､ｬ ox_sm1_gnuplot ､ﾑ､ｹ､�ﾎ､ﾋﾉｬﾍﾗ､ﾊ･ﾕ･｡･､･�:
     bin/gnuplot4ox,  bin/gnuplot_x11  (gnuplot ﾋﾜﾂﾎ, src/gnuplot*)
 
 ----------------------------------------
-[ｳｫﾈｯｼﾔﾍﾑ･皈秕
+*/
 
+/*&jp
+Q. debug ､ｹ､�ﾈ､ｭ make install ､ﾏﾌﾌﾅﾝ. (ｳｫﾈｯｼﾔｸ�､ｱ)
+A. 
 << sm1, ox_sm1, ox, oxlog ､ﾎ debug >>
 binary file ､ﾏｳﾆ directory ､ﾎ make install ､ﾋ､隍�
 OpenXM/bin ､ﾋ･ｳ･ﾔ｡ｼ､ｵ､�ﾞ､ｹ､ｬ,
@@ -522,11 +434,13 @@ OpenXM/src/kan96xx/Kan/sm1
 OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
 ､ﾘ､ﾎ･ｷ･ﾜ･�ﾃ･ｯ･�ｯ､ｬｺ鋿ｮ､ｵ､�ﾞ､ｹ.
 
-[CVS･ｳ･ﾟ･ﾃ･ｿﾍﾑ･皈秕
-<<  OpenXM ･ﾇ･｣･�ｯ･ﾈ･�ﾛﾉﾛﾈﾇ､ﾎｺ鋿ｮﾊ�ﾋ｡ >>
+Q. <<  OpenXM ･ﾇ･｣･�ｯ･ﾈ･�ﾛﾉﾛﾈﾇ､ﾎｺ鋿ｮﾊ�ﾋ｡ >>
+A.
+
 rcvs export -rHEAD OpenXM
 rcvs export -rHEAD OpenXM_contrib
 rcvs export -rHEAD OpenXM_contrib2
+cd OpenXM/src ; make generate-source-distribution
 ､ｷ､ﾆ, OpenXM, OpenXM_contrib, OpenXM_contrib2 ﾁｴﾂﾎ､� tar+gzip.
 */
 
@@ -534,24 +448,34 @@ rcvs export -rHEAD OpenXM_contrib2
 
 */
 /*&jp
-
-｡� Solaris ､ﾋｴﾘ､ｹ､�擎ﾕ.
+Q. Solaris ､ﾇ･ｳ･ﾑ･､･�ｬ､ｦ､ﾞ､ｯ､､､ｭ､ﾞ､ｻ､�.
+A.
 Solaris ､ﾇ､ﾏ､ﾞ､ﾀﾌ萃熙ｬｻｳﾀﾑ､ｷ､ﾆ､ﾞ､ｹ.
 Solaris ､ﾇ､ﾎ make ､ﾎﾌ萃�ﾀ､ﾋ､ﾄ､､､ﾆ､ﾏ, OpenXM/doc/OpenXM-FAQ-jp.txt
 ､ｫ､ﾆ､ｯ､ﾀ､ｵ､､.
-Solaris ､ﾇ･ｳ･ﾑ･､･�ｹ､�ﾋ､ﾏ, /usr/ccs/bin ､ｵ｡ｼ･ﾁ･ﾑ･ｹ､ﾎｺﾇｽ鬢ﾘ､筅ﾃ､ﾆ､､､ﾃ､ﾆ
-､ｪ､ｭ､ﾞ､ｹ.
+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
-***** COMPILE ON SOLARIS
+Q. I cannot make on Solaris.
+A.
  There are a lot of troubles on Solaris for now.
- At least,
- /usr/ccs/bin must be at the top of the command search path to compile
- on Solaris.
+ 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
 */
 
 
-/*&C
-
-*/