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