Annotation of OpenXM/doc/install.oxweave, Revision 1.48
1.48 ! takayama 1: %% $OpenXM: OpenXM/doc/install.oxweave,v 1.47 2003/09/03 00:20:39 takayama Exp $
1.1 takayama 2: OpenXM/doc/install.oxweave
3:
1.6 takayama 4: /*&C
1.46 takayama 5:
1.6 takayama 6: OpenXM URL : http://www.math.kobe-u.ac.jp/OpenXM
1.34 takayama 7: http://www.openxm.org
1.46 takayama 8:
9: */
10:
11: /*&jp
12:
13: ------------ ソースからコンパイルしてインストールする方法 ----
1.47 takayama 14: (cd OpenXM/src ; make install)
1.46 takayama 15: バイナリとライブラリとドキュメント類は
16: OpenXM/bin, OpenXM/lib, OpenXM/doc
17: にインストールされます.
18: (cd OpenXM/rc ; make install)
19: "asir", "sm1", ... などのシェルスクリプトが生成されて
20: /usr/local/bin
21: にコピーされます.
22: この部分は root で実行してください.
23:
24: */
25:
26: /*&eg
1.6 takayama 27:
28: OpenXM package : Getting started.
29:
1.42 takayama 30:
1.44 takayama 31: ----------- An instruction for a quick installation from the source code ---
1.47 takayama 32: (cd OpenXM/src ; make install)
1.42 takayama 33: You will get binaries, libraries, and documents under
34: OpenXM/bin, OpenXM/lib, OpenXM/doc
1.43 takayama 35: (cd OpenXM/rc ; make install)
1.42 takayama 36: Shell scripts to start "asir", "sm1", ... will be copied to
37: /usr/local/bin
1.46 takayama 38: This part should be executed as the root.
39:
40:
41: */
42:
43:
44: /*&jp
45:
1.42 takayama 46:
1.46 takayama 47: ------- Asir と kan だけで十分な場合
1.42 takayama 48: (cd OpenXM/src ; make install-kan-ox ; make install-asir-contrib)
1.46 takayama 49: OpenXM 版の Risa/Asir と kan/sm1 が生成インストールされます.
1.43 takayama 50: (cd OpenXM/rc ; make install)
1.34 takayama 51:
1.46 takayama 52: -------------------------------------------
53: asir-contrib 付きの Risa/Asir は OpenXM パッケージのメインクライアントです.
54: Risa/asir はコマンド asir で起動できます.
55: Risa/Asir および Asir-contrib のマニュアルは
56: OpenXM/doc ディレクトリおよび http://www.openxm.org においてあります.
57:
1.40 takayama 58:
1.1 takayama 59: */
1.40 takayama 60:
1.6 takayama 61:
62: /*&eg
1.1 takayama 63:
1.46 takayama 64: ------- If you need only asir and kan,
1.47 takayama 65: (cd OpenXM/src ; make install-asir2000 ; make install-k097 )
66: You will get only asir and kan/sm1.
1.46 takayama 67: (cd OpenXM/rc ; make install)
1.2 takayama 68:
1.46 takayama 69: -------------------------------------------
70: Risa/Asir with asir-contrib is the main client system in the OpenXM project.
1.47 takayama 71: You can start Risa/Asir by the command "asir", which is called
72: OpenXM/Risa/Asir.
73: It is build by (cd OpenXM/src ; make install-asir-contrib)
1.46 takayama 74: The manual of Risa/Asir and Asir-contrib can be found in the
75: OpenXM/doc directory and http://www.openxm.org
1.24 takayama 76:
1.6 takayama 77:
1.2 takayama 78: */
1.46 takayama 79:
1.6 takayama 80: /*&jp
81:
1.1 takayama 82:
1.46 takayama 83: ----------- 幾つか解説 ------------------
84:
85: Q. (cd OpenXM/rc ; make all) はなにをやるの?
86: A.
87: OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc,
1.23 takayama 88: OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, 等の
89: ファイルを自動生成します.
90: openxm, asir, oxmath などは OpenXM クライアントを起動するための
91: シエルスクリプトです. これらを /usr/local/bin にインストールするには
92: 次のように入力します.
1.6 takayama 93:
1.5 takayama 94: */
95: /*&eg
1.46 takayama 96:
97: ----------- Some Tips ----------------------
98:
99: Q. What is done by the command (cd OpenXM/rc ; make all) ?
100: A.
101: It generates OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc and
1.23 takayama 102: OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, ...
103: The files openxm, asir, oxmath are shell scripts to invoke OpenXM clients.
104: If you want to install these shell scripts to /usr/local/bin,
105: type in as follows.
1.6 takayama 106:
1.5 takayama 107: */
1.6 takayama 108: /*&C
109:
1.46 takayama 110: cd OpenXM/rc
1.23 takayama 111: make install
1.5 takayama 112:
113: */
114: /*&jp
1.23 takayama 115:
116: /usr/local/bin でなく, home directory の bin にインストールしたい
117: ときは, 次のように入力してください.
118:
119: */
120: /*&eg
121:
122: If you want to install them under the bin of your home directory,
123: type in as follows.
124:
125: */
126: /*&C
127:
1.46 takayama 128: cd OpenXM/rc
1.23 takayama 129: make install PREFIX=$HOME/bin
130:
131: */
132: /*&C
133:
134: [Note] If you are Solaris user, you might have to type in like
135: /usr/ccs/bin/make install PREFIX=$HOME/bin
136:
137: */
138: /*&jp
139:
1.46 takayama 140: Q. OpenXM/bin の下のファイルを直接実行できるようにしたい.
141: A.
1.23 takayama 142: OpenXM/bin の下のファイルを直接実行したい場合は, 以下の設定が必要です.
143:
1.46 takayama 144: # csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます.
1.6 takayama 145:
1.1 takayama 146: */
147: /*&eg
1.23 takayama 148:
1.46 takayama 149: Q. I want to execute binaries under OpenXM/bin
150: A.
151: If you want to execute binaries under OpenXM/bin, you need to do
152: the following.
153:
1.23 takayama 154:
1.46 takayama 155: # Append the following line to the end of ~/.cshrc when you are
1.6 takayama 156: using csh as your shell.
157:
1.1 takayama 158: */
159: /*&C
1.2 takayama 160:
1.46 takayama 161: source OpenXM/rc/dot.cshrc
1.2 takayama 162:
1.1 takayama 163: */
164: /*&jp
1.46 takayama 165: # bash を利用してる場合, 次の行それぞれを ~/.bashrc および ~/.bash_profile
1.38 takayama 166: の最後に加えます.
1.6 takayama 167:
1.1 takayama 168: */
169: /*&eg
1.46 takayama 170: # Append the following lines to the end of ~/.bashrc and ~/.bash_profile
1.38 takayama 171: respectively when you are using bash as your shell.
1.6 takayama 172:
173: */
174: /*&C
175:
1.46 takayama 176: source OpenXM/rc/dot.bashrc (.bashrc)
1.38 takayama 177:
1.46 takayama 178: source ~/.bashrc (.bash_profile)
1.14 takayama 179:
180: */
181:
1.6 takayama 182:
1.32 takayama 183: /*&jp
1.46 takayama 184: Q. ox_asir を icon でスタートするには?
1.32 takayama 185: A. 次の行を, .Xdefaults または, xrdb で読み込むファイルに書いておきます.
186: */
187: /*&eg
1.46 takayama 188: Q. How to start ox_asir in the iconic mode?
1.32 takayama 189: A. Add the following line to .Xdefaults or a file you read by xrdb.
190: */
191: /*&C
192:
193: ox_xterm*iconic: on
1.28 takayama 194:
195: */
1.34 takayama 196:
1.28 takayama 197: /*&jp
198:
1.46 takayama 199: Q. Make は無事終了しますが, 途中でエラーがでます.
200: A.
201: OS の標準添付の環境以外が必要なコンポーネントのコンパイルエラーは
202: 無視されます.
1.8 takayama 203: 次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを
1.6 takayama 204: 必要とします.
205: */
206: /*&eg
1.46 takayama 207:
208: Q. Make finishes, but it outputs errors.
209: A.
210: Compilation errors due to missing commands other than
211: standard commands are ignored.
212: The following modules require the listed software systems
213: other than the standard OS package.
1.6 takayama 214: */
215: /*&C
216:
1.27 takayama 217: (1) OpenXM/bin/oxmath : Mathematica Version 3.x or 4.x
1.6 takayama 218: (Mathematica server) at /usr/local/Mathematica
219: OpenXM/bin/math2ox [ see http://www.wolfram.com ]
220: Asir client functions m_*
1.46 takayama 221: (2) OpenXM/lib/OpenMath : JDK
222:
1.6 takayama 223: Asir client functions om_*
224: sm1 client functions om_*
1.46 takayama 225: (3) PHC pack (OpenXM/bin/phc) and asir client functions phc_*
226: phc_* run only on linux.
227: If you install the linux emulation on Free BSD, they run on
1.8 takayama 228: FreeBSD, too.
229: <note 1>
230: Add linux_enable="YES" in /etc/rc.conf
231: You need the following packages:
232: pkg_info | grep linu
1.46 takayama 233: linux_base-* The base set of packages needed in Linux mode
234: linux_devtools-* Packages needed for doing development in Linux mode
235: (4) The document generation requires
236: latex, platex, tex, ptex, dvips, latex2html, texi2html, nkf
1.6 takayama 237:
238: */
239:
240:
1.1 takayama 241: /*&jp
1.46 takayama 242: Q. asir の help message が変.
243: A.
1.3 maekawa 244: asir で日本語のヘルプを利用するには,
1.1 takayama 245: PAGER=jless
246: export PAGER
1.3 maekawa 247: などで, 日本語を扱える PAGER を指定する必要があるかもしれません.
1.1 takayama 248: */
1.7 takayama 249:
1.41 takayama 250: /*&C
251:
252: -----------------------------------------------------
253:
254: */
255:
1.1 takayama 256: /*&jp
1.46 takayama 257: Q. OpenXM パッケージの文書は?
258: A.
1.7 takayama 259: OpenXM パッケージでもっとも充実しているクライアントは,
260: asir です.
261: asir のつかいかたは
262: OpenXM/doc/asir2000/man-jp.dvi
263: または OpenXM/doc/asir2000/html-jp の HTML ファイルを見て下さい.
264: asir 用 OpenXM クライアントライブラリのつかい方は,
265: OpenXM/doc/asir-contrib/cman-jp.dvi
266: を見て下さい. dvi の付くファイルは xdvi で見ることができます.
267:
268: OpenXM の設計の概要については,
269: OpenXM/doc/issac2000/issac2000.ps
270: を見て下さい.
271: ps の付くファイルは, ghostview で見ることができます.
272:
1.25 takayama 273: Mathematica client については, OpenXM/doc/ox_math を御覧ください.
274: sm1 client については, OpenXM/doc/kan96xx を御覧ください.
275: asir は, 多項式処理用のライブラリとしてリンクできます.
276: これについては, OpenXM/doc/oxlib を御覧ください.
277:
278: OpenXM 対応の, サーバ を作成するには, OpenXM/src/ox_toolkit
1.46 takayama 279: を見てください. Java のクラスについては
280: OpenXM/src/OpenMath を見てください.
1.25 takayama 281:
1.7 takayama 282: */
283: /*&eg
1.46 takayama 284: Q. Where can I find documents of the OpenXM package.
285: A.
286: The main OpenXM client in the OpenXM package is now
1.7 takayama 287: asir.
288: Documents on asir are
289: OpenXM/doc/asir2000/man-eg.dvi
290: OpenXM/doc/asir2000/html-eg (HTML)
291:
292: The file
293: OpenXM/doc/asir-contrib/cman-eg.dvi
294: is a document on OpenXM client libraries for asir.
1.1 takayama 295:
1.7 takayama 296: The design outline is described in
297: OpenXM/doc/issac2000/issac2000.ps
298:
299: Dvi files can be previewed by xdvi and
300: ps files can be previewed by ghostview.
1.25 takayama 301:
302: As to Mathematica client, see OpenXM/doc/ox_math.
303: As to sm1 client, see OpenXM/doc/kan96xx.
304: The asir can be used as a C library for polynomial manupulation.
305: See OpenXM/doc/oxlib.
306:
1.46 takayama 307: If you are interested in writing a server for OpenXM in C or Java,
308: please refer to
1.25 takayama 309: OpenXM/src/ox_toolkit and OpenXM/src/OpenMath.
310:
1.7 takayama 311: */
1.1 takayama 312:
1.41 takayama 313: /*&eg
1.46 takayama 314: Q. I want to install only Risa/Asir.
315: A.
316: If you want to generate only Risa/Asir, type in as follows.
1.41 takayama 317: */
318: /*&jp
1.46 takayama 319: Q. Risa/Asir のみ install したい.
320: A.
321: Risa/Asir のみを生成したい場合は, つぎのように入力します.
1.41 takayama 322: */
323: /*&C
324:
325: (cd OpenXM/src ; make install-asir)
326: (cd OpenXM/rc ; make )
327:
328: */
329: /*&eg
330: Copy the shell script "asir" at OpenXM/rc in your search path, e.g.,
331: /usr/local/bin or ~/bin
332: Or, read OpenXM/rc/dot.bashrc or OpenXM/rc/dot.bashrc by the source
333: command from your ~/.bashrc or ~/.cshrc.
334: */
335: /*&jp
336: OpenXM/rc の下のシェルスクリプト "asir" をサーチパスにコピーして
337: ください (たとえば, /usr/local/bin or ~/bin へ).
338: または OpenXM/rc/dot.bashrc か OpenXM/rc/dot.cshrc を
339: source コマンドで ~/.bashrc か ~/.cshrc より読み込んでください.
340: */
341:
1.6 takayama 342: /*&jp
1.46 takayama 343: Q. OpenXM の下のファイル構成はどうなっていますか?
344: A.
1.8 takayama 345: [OpenXM 下のファイルの構成メモ]
1.3 maekawa 346: lib/asir には, asir のライブラリ, ox_asir 本体
347:
1.8 takayama 348: cd OpenXM/src/kxx ; make install-for-debug した場合,
1.3 maekawa 349: lib/sm1 は src/SSkan/Doc への symbolic link
350: であり, sm1 のライブラリファイルが格納されています.
351: lib/sm1/bin には, binaryfiles
1.1 takayama 352: sm1, ox_sm1, ox, ox_log, ox_sm1_*
1.3 maekawa 353: へのシンボリックリンクが格納されます.
1.8 takayama 354: このシンボリックリンクは src/kxx で make install-for-debug を実行することにより
1.3 maekawa 355: 作成されます.
1.1 takayama 356:
1.3 maekawa 357: sm1 が ox_asir を利用するのに必要なファイル.
1.1 takayama 358: lib/asir/ox_asir,
359: lib/sm1/bin/ox, lib/sm1/bin/ox_log (src/kxx/ox, src/kxx/ox_log)
360: lib/sm1/ox.sm1, lib/sm1/oxasir.sm1
361:
1.3 maekawa 362: asir が ox_sm1_forAsir を利用するのに必要なファイル:
1.1 takayama 363: lib/asir/ox_launch
1.3 maekawa 364: lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク)
1.1 takayama 365: lib/asir/xm
1.3 maekawa 366: lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル.
1.1 takayama 367: callsm1.sm1 callsm1b.sm1
1.3 maekawa 368: (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c
369: ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.)
1.1 takayama 370:
1.3 maekawa 371: asir が ox_sm1_gnuplot を利用するのに必要なファイル:
1.1 takayama 372: lib/asir/ox_launch
1.3 maekawa 373: lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して
1.4 maekawa 374: gnuplot4ox を実行します.)
1.1 takayama 375: lib/asir/xm
376: lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1
1.3 maekawa 377: (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c
378: ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.)
1.4 maekawa 379: bin/gnuplot4ox, bin/gnuplot_x11 (gnuplot 本体, src/gnuplot*)
1.1 takayama 380:
381: ----------------------------------------
1.46 takayama 382: */
1.1 takayama 383:
1.46 takayama 384: /*&jp
385: Q. debug するとき make install は面倒. (開発者向け)
386: A.
1.3 maekawa 387: << sm1, ox_sm1, ox, oxlog の debug >>
388: binary file は各 directory の make install により
389: OpenXM/bin にコピーされますが,
390: debug 用にいちいちコピーするのは面倒なので,
1.8 takayama 391: OpenXM/src/kan96xx で make install-for-debug
392: OpenXM/src/kxx で make install-for-debug
1.3 maekawa 393: を実行すると,
394: OpenXM/bin/sm1, ox, ox_sm1, oxlog より,
1.1 takayama 395: OpenXM/src/kan96xx/Kan/sm1
396: OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
1.3 maekawa 397: へのシンボリックリンクが作成されます.
1.1 takayama 398:
1.46 takayama 399: Q. << OpenXM ディレクトリ配布版の作成方法 >>
400: A.
401:
1.1 takayama 402: rcvs export -rHEAD OpenXM
403: rcvs export -rHEAD OpenXM_contrib
404: rcvs export -rHEAD OpenXM_contrib2
1.21 takayama 405: cd OpenXM/src ; make generate-source-distribution
1.3 maekawa 406: して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip.
1.7 takayama 407: */
408:
409: /*&C
410:
411: */
412: /*&jp
1.46 takayama 413: Q. Solaris でコンパイルがうまくいきません.
414: A.
1.7 takayama 415: Solaris ではまだ問題が山積してます.
416: Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt
417: を見てください.
1.48 ! takayama 418: Solaris でコンパイルするには, 次が最低限必要です.
! 419: (1) gcc をインストールする.
! 420: http://www.gnu.org より Solaris 用 binary を入手できる.
! 421: それから [gnu file util と] bison.
! 422: (2) /usr/ccs/bin:/usr/local/bin:/usr/ucb
! 423: をサーチパスの最初へもっていっておきます.
! 424: C シェルなら
! 425: setenv PATH=/usr/ccs/bin:/usr/local/bin:/usr/ucb:$PATH
! 426:
! 427: これは /usr/ccs/bin/make, /usr/ucb/install を利用する必要があるためです.
1.7 takayama 428:
429: */
1.8 takayama 430: /*&eg
1.46 takayama 431: Q. I cannot make on Solaris.
432: A.
1.8 takayama 433: There are a lot of troubles on Solaris for now.
1.48 ! takayama 434: At least, the following two things are prerequisite.
! 435: (1) Installation of gcc (http://www.gnu.org), [gnu file util] and bison.
! 436: (2) /usr/ccs/bin:/usr/ucb must be at the top of the command search path
! 437: to compile on Solaris. In case of C shell, type in
! 438: setenv PATH=/usr/ccs/bin:/usr/local/bin:/usr/ucb:$PATH
! 439: This is because our making procedure requires
! 440: /usr/ccs/bin/make, /usr/ucb/install
1.8 takayama 441: */
1.7 takayama 442:
443:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>