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