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