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