Annotation of OpenXM/doc/install.oxweave, Revision 1.42
1.42 ! takayama 1: %% $OpenXM: OpenXM/doc/install.oxweave,v 1.41 2000/12/22 02:07:55 takayama Exp $
1.1 takayama 2: OpenXM/doc/install.oxweave
3:
1.6 takayama 4: /*&C
5: OpenXM URL : http://www.math.kobe-u.ac.jp/OpenXM
1.34 takayama 6: http://www.openxm.org
1.16 takayama 7: Consult firstly the ERRATA section for your release on this web cite
8: for troubles.
1.6 takayama 9:
10: OpenXM package : Getting started.
11:
1.34 takayama 12: This document is for OpenXM version 1.1.3. (Draft)
1.42 ! takayama 13:
! 14:
! 15: ----------- An instruction for quick installation -----------------
! 16: (cd OpenXM/src ; make configure ; make install)
! 17: You will get binaries, libraries, and documents under
! 18: OpenXM/bin, OpenXM/lib, OpenXM/doc
! 19: (cd OpenXM/misc ; make install)
! 20: Shell scripts to start "asir", "sm1", ... will be copied to
! 21: /usr/local/bin
! 22:
! 23: *******************************************************************
! 24: (cd OpenXM/src ; make install-kan-ox ; make install-asir-contrib)
! 25: You will get only asir (OpenXM version) and kan/sm1.
! 26: -------------------------------------------------------------------
1.34 takayama 27:
1.6 takayama 28: */
1.1 takayama 29: /*&jp
1.23 takayama 30: ★ OpenXM GENERIC パッケージの利用方法
1.6 takayama 31: この節では, OpenXM package binary distribution のインストール法を説明します.
1.36 takayama 32: ソースからインストールする場合は
33: ★ OpenXM パッケージの Make 法
34: を御覧下さい.
1.40 takayama 35: RPM, Debian などのパッケージでインストールする場合は
36: Web ページの説明どうりにパッケージをインストールするだけで
37: 設定が終了します.
38:
1.6 takayama 39: インストールに必要なシステムの仕様については, 動作環境を御覧ください.
1.1 takayama 40: */
41: /*&eg
1.23 takayama 42: ***** HOW TO INSTALL OpenXM GENERIC PACKAGE?
1.6 takayama 43: In this section, we will explain how to install OpenXM package binary
44: distribution.
1.36 takayama 45: If you build from the source, see the section
46: * How to make OpenXM package?
1.40 takayama 47: If you install openxm by using RPM or Debian package,
48: install the system following the instruction given on our web page.
49:
1.6 takayama 50: As to the required environment, see the section "System Requirement"
51: */
52: /*&jp
53:
54: (1) Tar ボールより次のようにしてディレクトリ OpenXM を取り出します.
1.13 takayama 55: OpenXM はどこにおいてもかまいません. ルートになってインストール
56: する必要もありません.
57: できれば, /usr/local/OpenXM においてほしいと思います.
1.6 takayama 58:
1.1 takayama 59: */
1.6 takayama 60: /*&eg
1.1 takayama 61:
1.6 takayama 62: (1) Extract the directory OpenXM from the tar ball.
63: You can put the directory OpenXM at any place in the file system.
1.13 takayama 64: You do not need to be a root to install it.
65: We are happy if you put OpenXM at /usr/local/OpenXM
1.2 takayama 66:
67: */
1.6 takayama 68: /*&C
1.24 takayama 69:
70: tar xzvf OpenXM-shared.tgz
1.6 takayama 71: tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz
72:
1.2 takayama 73: */
1.6 takayama 74: /*&jp
75: 以下 (1) で生成されたディレクトリ OpenXM の絶対パスを /xxx/yyy/OpenXM
76: と書きます.
77:
1.1 takayama 78: */
1.6 takayama 79: /*&eg
80: In the sequel, we will denote the absolute path of the directory OpenXM
81: by /xxx/yyy/OpenXM.
1.1 takayama 82:
83: */
84: /*&jp
1.23 takayama 85: (2) OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc,
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.19 takayama 94: (2) Generate OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc and
1.23 takayama 95: OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, ...
96: The files openxm, asir, oxmath are shell scripts to invoke OpenXM clients.
97: If you want to install these shell scripts to /usr/local/bin,
98: type in as follows.
1.6 takayama 99:
1.5 takayama 100: */
1.6 takayama 101: /*&C
102:
1.8 takayama 103: cd /xxx/yyy/OpenXM/rc
1.23 takayama 104: make install
1.5 takayama 105:
106: */
107: /*&jp
1.23 takayama 108:
109: /usr/local/bin でなく, home directory の bin にインストールしたい
110: ときは, 次のように入力してください.
111:
112: */
113: /*&eg
114:
115: If you want to install them under the bin of your home directory,
116: type in as follows.
117:
118: */
119: /*&C
120:
121: cd /xxx/yyy/OpenXM/rc
122: make install PREFIX=$HOME/bin
123:
124: */
125: /*&C
126:
127: [Note] If you are Solaris user, you might have to type in like
128: /usr/ccs/bin/make install PREFIX=$HOME/bin
129:
130: */
131: /*&jp
132:
133: OpenXM/bin の下のファイルを直接実行したい場合は, 以下の設定が必要です.
134: OpenXM clients を実行するだけの場合は, (3), (3') は skip してください.
135:
1.6 takayama 136: (3) csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます.
137:
1.1 takayama 138: */
139: /*&eg
1.23 takayama 140:
141: If you want to execute binaries under OpenXM/bin, you need to perform
142: (3) and (3').
143: If you use only OpenXM clients, skip (3) and (3').
144:
1.6 takayama 145: (3) Append the following line to the end of ~/.cshrc when you are
146: using csh as your shell.
147:
1.1 takayama 148: */
149: /*&C
1.2 takayama 150:
1.6 takayama 151: source /xxx/yyy/OpenXM/rc/dot.cshrc
1.2 takayama 152:
1.1 takayama 153: */
154: /*&jp
1.38 takayama 155: (3') bash を利用してる場合, 次の行それぞれを ~/.bashrc および ~/.bash_profile
156: の最後に加えます.
1.6 takayama 157:
1.1 takayama 158: */
159: /*&eg
1.38 takayama 160: (3') Append the following lines to the end of ~/.bashrc and ~/.bash_profile
161: respectively when you are using bash as your shell.
1.6 takayama 162:
163: */
164: /*&C
165:
1.38 takayama 166: source /xxx/yyy/OpenXM/rc/dot.bashrc (.bashrc)
167:
168: source ~/.bashrc (.bash_profile)
1.6 takayama 169:
1.1 takayama 170: */
1.14 takayama 171:
172: /*&jp
173:
174: (3) または (3') を終了したら, いったん logout して login しなおすか
1.18 takayama 175: または, source コマンドで, dot.bashrc または dot.csh を読み込んで下さい.
1.14 takayama 176:
177: */
178: /*&eg
179:
180: After finishing the step (3) or (3'), logout and login again,
1.18 takayama 181: or read dot.bashrc or dot.cshrc file by the source command.
1.14 takayama 182:
183: */
184:
1.6 takayama 185:
1.32 takayama 186: /*&C
187:
188: FAQ
189:
190: */
191: /*&jp
192: Q. OpenXM の asir OpenXM client を icon でスタートするには?
193: A. 次の行を, .Xdefaults または, xrdb で読み込むファイルに書いておきます.
194: */
195: /*&eg
196: Q. How to start asir OpenXM clients in the iconic mode?
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.41 takayama 204: /*&C
205:
206: -------------------------------------------------------------
207:
208: */
1.28 takayama 209: /*&jp
210:
211: ★ OpenXM FreeBSD binary パッケージのインストール方法
212: openxm-version.tgz
213: を ftp サイトより copy して,
214: root になって,
215: pkg_add openxm-version.tgz
216: OpenXM は /usr/local/OpenXM にインストールされます.
1.40 takayama 217:
1.28 takayama 218: ここで version は OpenXM の version 番号で, たとえば,
219: 2000, 3/20(Mon) 版は 1.1.2
1.38 takayama 220: pkg_add に失敗した場合は, /var のサイズを大きくしてやりなおして
221: みて下さい.
1.28 takayama 222:
1.30 takayama 223: java および linux emulation が実行に必要です.
224: java が, サーチパスのなかにある必要がありますので,
225: たとえば,
226: set path=(/usr/local/jdk1.1.8 $path)
227: rehash
228: してから, pkg_add して下さい.
229: インストール終了後のメッセージにしたがい, 必要な設定を
230: おこなって下さい.
231:
1.34 takayama 232: jdk は /usr/ports/lang/jdk よりインストールできます.
233: Linux emulation を有効にするには,
234: /etc/rc.conf に
235: linux_enable="YES"
236: と書き,
237: /usr/ports/emulators/linux_base を用いて, linux 用の共有ライブラリ等を
238: インストールしておきます.
239: (FreeBSD 3.x, 4.x)
240:
241:
1.30 takayama 242: /usr/local にインストールしなかった場合は,
243: (2) を実行して下さい.
244:
1.28 takayama 245: */
246: /*&eg
247:
248: ***** HOW TO INSTALL OpenXM FreeBSD binary package
249: Copy
250: openxm-version.tgz
251: from our ftp cite.
252: Become the super user and type
253: pkg_add openxm-version.tgz
254: OpenXM will be installed to /usr/local/OpenXM
1.40 takayama 255:
1.28 takayama 256: Here, version is the version number of OpenXM.
257: For example, the version number of the OpenXM of May 20 (Mon), 2000
258: is 1.1.2
1.38 takayama 259: If you fail "pkd_add", increase the size of /var
1.28 takayama 260:
1.30 takayama 261: java and linux emulation are required to run OpenXM packages.
262: Java needs to be in the search path. So, for example, execute pkg_add
263: after
264: set path=(/usr/local/jdk1.1.8 $path)
265: rehash
266: Following the message of pkg_add after the installation,
1.34 takayama 267: set path.
268:
269: jdk can be installed by /usr/ports/lang/jdk.
270: Add the line
271: linux_enable="YES"
272: to /etc/rc.conf and install shared libraries for linux
273: by /usr/ports/emulators/linux_base.
274: Then, you can emulate linux.
275:
1.30 takayama 276: If you do not install under /usr/local,
277: goto (2).
278:
1.28 takayama 279: */
280: /*&jp
281:
282: ★ OpenXM Redhat Package manager (Linux)
283: binary パッケージのインストール方法
1.29 takayama 284: openxm-shared-version-suffix.noarch.rpm
1.28 takayama 285: openxm-binary-version-suffix.i386.rpm
286: を ftp サイトより copy して,
287: root になって,
1.29 takayama 288: rpm -i openxm-shared-version-suffix.noarch.rpm
1.28 takayama 289: rpm -i openxm-binary-version-suffix.i386.rpm
290: OpenXM は /usr/local/OpenXM にインストールされます.
1.40 takayama 291:
1.28 takayama 292: ここで version は OpenXM の version 番号で, たとえば,
293: 2000, 3/20(Mon) 版は 1.1.2
294: suffix は, RPM 版の minor version number.
295:
1.39 takayama 296: /usr/local の下へインストールしなかった場合は, (2) を実行して下さい.
1.28 takayama 297:
1.39 takayama 298: libgd のインストールが必要な場合もあります.
299: libgd がインストールしてない場合,
300: http://www.redhat.com/downloads へアクセスし, libgd をインストール
301: して下さい.
1.30 takayama 302:
1.28 takayama 303: */
304: /*&eg
305:
306: ***** HOW TO INSTALL OpenXM by the redhat Package manager (Linux)
307: Copy
1.29 takayama 308: openxm-shared-version-suffix.noarch.rpm
1.28 takayama 309: openxm-binary-version-suffix.i386.rpm
310: from our ftp cite.
311: Become the super user and type
1.29 takayama 312: rpm -i openxm-shared-version-suffix.noarch.rpm
1.28 takayama 313: rpm -i openxm-binary-version-suffix.i386.rpm
314: OpenXM will be installed to /usr/local/OpenXM
1.40 takayama 315:
1.28 takayama 316: Here, version is the version number of OpenXM.
317: For example, the version number of the OpenXM of May 20 (Mon), 2000
318: is 1.1.2
319: suffix is the minor version number of the package.
320:
1.30 takayama 321: If you do not install under /usr/local, goto (2).
322:
1.13 takayama 323:
1.39 takayama 324: You might need to install libgd.
325: If it is not installed in your system, access to
326: http://www.redhat.com/downloads and get libgd.
1.13 takayama 327: */
1.6 takayama 328:
329: /*&C
1.8 takayama 330:
1.41 takayama 331: ---------------------------------------------------------
332:
333: */
334:
335: /*&C
336:
1.27 takayama 337: ***** OpenXM client programs under OpenXM/bin or /usr/local/bin:
338: asir
339: oxmath
340: openxm sm1
341:
342: ***** OpenXM server programs:
343: OpenXM/bin/ox_asir
344: OpenXM/bin/ox_sm1
345: OpenXM/bin/ox_math
346: OpenXM/lib/sm1/bin/ox_sm1_gnuplot
347: OpenXM/lib/sm1/bin/ox_sm1_phc
348: OpenXM/lib/sm1/bin/ox_sm1_tigers
349: OpenXM/lib/java-support/OMproxy.class
350:
1.8 takayama 351: ***** QUALITY:
1.25 takayama 352: Experimental:
1.6 takayama 353: OpenXM/bin/k0, OpenXM/bin/d0
1.25 takayama 354: Asir client functions: m_* (Mathematica) , om_* (OpenMath)
1.29 takayama 355: OpenXM/lib/java-support/ *
1.25 takayama 356: 70%
1.6 takayama 357: OpenXM/bin/ox_math, OpenXM/bin/math2ox
1.11 takayama 358: OpenXM/bin/sm1, ox_sm1 on Linux libc6.
1.37 takayama 359:
360: **** OpenXM server and client programs (under development)
361: included only in the source distribution
362: OpenXM/src/Macaulay2 ( M2 server and client )
363: OpenXM/src/ruby ( Ruby client)
364:
365: **** Utilities
366: OpenXM/doc/oxlib ( how to link oxservers as libraries )
367:
1.6 takayama 368: */
369: /*&C
370:
371:
1.8 takayama 372: */
373: /*&jp
374: ★ Java に関する注意:
375: 注意 1.
376: OpenMath 用の OMproxy には現在のところ, jdk が必要です.
377: たとえば bash を利用している場合, .bashrc で
378: PATH=/usr/local/jdk1.1.8/bin:$PATH
379: export PATH
1.10 takayama 380: などとして, jdk の java, javac をサーチパスの先のほうへもっていくようにして
1.8 takayama 381: ください.
1.10 takayama 382: csh を利用している場合, .cshrc で
383: set path=(/usr/local/jdk1.1.8/bin $path)
384: として, jdk の java, javac をサーチパスにいれます.
1.17 takayama 385:
1.34 takayama 386: jdk の入手先: FreeBSD --- /usr/ports/java/jdk を見てください.
1.35 takayama 387: Linux --- http://java.sun.com/products/jdk/1.2/ja
388: http://java.sun.com/j2se/1.3/ja
1.33 takayama 389:
1.17 takayama 390: 注意:
391: なお, Kaffe 1.0.b4 の java は, class BigInteger に method
392: toByteArray が含まれてないため, OpenMath モジュールでは使用できません.
1.8 takayama 393: */
394: /*&eg
395: ***** JAVA
396: In order to use OMproxy, asir client om_*,
397: you need to install JDK.
398: The bin dir of the JDK must be in yur search path.
399: For example, you need to add the following line
1.10 takayama 400: to your .chsrc when your shell is csh
1.8 takayama 401: set path=(/usr/local/jdk1.1.8/bin $path)
1.10 takayama 402: Bash users put the following line to .bashrc
403: PATH=/usr/local/jdk1.1.8/bin:$PATH
404: export PATH
1.17 takayama 405:
1.33 takayama 406:
1.34 takayama 407: Where can I get jdk? : FreeBSD --- see /usr/ports/java/jdk
1.35 takayama 408: Linux --- http://java.sun.com/products/jdk/1.2/ja
409: http://java.sun.com/j2se/1.3/ja
410:
1.33 takayama 411:
1.17 takayama 412: Remark:
413: The Java interpreter of Kaffe 1.0.b4 does not contain the method
414: toByteArray in the class BigInteger.
415: So, it cannot be used for the OpenMath module.
1.8 takayama 416: */
417:
418: /*&C
419:
1.41 takayama 420: --------------------------------------------------------
1.6 takayama 421:
422:
423: */
424: /*&jp
425: ★ 動作環境
426:
427: */
428: /*&eg
1.7 takayama 429: ***** SYSTEM REQUIREMENTS
1.6 takayama 430:
431: */
432: /*&C
433:
1.34 takayama 434: OS: FreeBSD 3.3, 3.4, 4.x (Intel CPU),
1.11 takayama 435: Linux systems (Intel CPU):
1.15 takayama 436: Most Linux with libc5 and with libc6 (glibc 2.x).
1.7 takayama 437:
438: X window system is required.
439:
440: Most part of the OpenXM package may work on other versions of
1.11 takayama 441: FreeBSD 3.x and Linux, but we have not yet tested.
1.6 takayama 442:
443: */
444: /*&jp
1.8 takayama 445: 次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを
1.6 takayama 446: 必要とします.
447: */
448: /*&eg
449: The following modules require the listed softwares other than the standard
450: OS package.
451: */
452: /*&C
453:
1.27 takayama 454: (1) OpenXM/bin/oxmath : Mathematica Version 3.x or 4.x
1.6 takayama 455: (Mathematica server) at /usr/local/Mathematica
456: OpenXM/bin/math2ox [ see http://www.wolfram.com ]
457: Asir client functions m_*
458: (2) OpenXM/lib/java-support : JDK at /usr/local/jdk??
1.8 takayama 459: [ see the section on JAVA]
1.6 takayama 460: Asir client functions om_*
461: sm1 client functions om_*
1.7 takayama 462: (3) PHC pack (OpenXM/bin/phc) and asir client functions
463: phc_* run only on linux (glib5).
1.8 takayama 464: If you install the linux emulation^{note 1} on Free BSD, they run on
465: FreeBSD, too.
466: <note 1>
467: Add linux_enable="YES" in /etc/rc.conf
468: You need the following packages:
469: pkg_info | grep linu
470: linux_base-5.2 The base set of packages needed in Linux mode
471: linux_devtools-5.2 Packages needed for doing development in Linux mode
1.6 takayama 472:
473: */
474:
475:
1.1 takayama 476: /*&jp
1.7 takayama 477: 日本語版の注意.
1.3 maekawa 478: 注意 1.
479: asir で日本語のヘルプを利用するには,
1.1 takayama 480: PAGER=jless
481: export PAGER
1.3 maekawa 482: などで, 日本語を扱える PAGER を指定する必要があるかもしれません.
1.1 takayama 483: */
1.7 takayama 484:
485: /*&eg
486:
1.8 takayama 487: The installation is completed.
1.7 takayama 488:
489: */
490: /*&jp
491:
492: 以上.
493:
494: */
495:
1.41 takayama 496: /*&C
497:
498: -----------------------------------------------------
499:
500: */
501:
1.1 takayama 502: /*&jp
1.7 takayama 503: ★ 文書
504:
505: OpenXM パッケージでもっとも充実しているクライアントは,
506: asir です.
507: asir のつかいかたは
508: OpenXM/doc/asir2000/man-jp.dvi
509: または OpenXM/doc/asir2000/html-jp の HTML ファイルを見て下さい.
510: asir 用 OpenXM クライアントライブラリのつかい方は,
511: OpenXM/doc/asir-contrib/cman-jp.dvi
512: を見て下さい. dvi の付くファイルは xdvi で見ることができます.
513:
514: OpenXM の設計の概要については,
515: OpenXM/doc/issac2000/issac2000.ps
516: を見て下さい.
517: ps の付くファイルは, ghostview で見ることができます.
518:
1.25 takayama 519: Mathematica client については, OpenXM/doc/ox_math を御覧ください.
520: sm1 client については, OpenXM/doc/kan96xx を御覧ください.
521: asir は, 多項式処理用のライブラリとしてリンクできます.
522: これについては, OpenXM/doc/oxlib を御覧ください.
523:
524: OpenXM 対応の, サーバ を作成するには, OpenXM/src/ox_toolkit
525: が参考になるかもしれません. Java のクラスについては
526: OpenXM/src/OpenMath が参考になるかもしれません.
527:
1.7 takayama 528: */
529: /*&eg
530: ***** DOCUMENTS
531:
532: The best OpenXM client in the OpenXM package is now
533: asir.
534: Documents on asir are
535: OpenXM/doc/asir2000/man-eg.dvi
536: OpenXM/doc/asir2000/html-eg (HTML)
537:
538: The file
539: OpenXM/doc/asir-contrib/cman-eg.dvi
540: is a document on OpenXM client libraries for asir.
1.1 takayama 541:
1.7 takayama 542: The design outline is described in
543: OpenXM/doc/issac2000/issac2000.ps
544:
545: Dvi files can be previewed by xdvi and
546: ps files can be previewed by ghostview.
1.25 takayama 547:
548: As to Mathematica client, see OpenXM/doc/ox_math.
549: As to sm1 client, see OpenXM/doc/kan96xx.
550: The asir can be used as a C library for polynomial manupulation.
551: See OpenXM/doc/oxlib.
552:
553: If you are interested in writing a server for OpenXM, please refer to
554: OpenXM/src/ox_toolkit and OpenXM/src/OpenMath.
555:
1.7 takayama 556: */
1.1 takayama 557:
558:
1.8 takayama 559: /*&eg
560:
561:
562: ***** A QUICK TOUR OF OPENXM BY ASIR
563:
564: */
1.7 takayama 565: /*&jp
1.1 takayama 566:
567:
1.8 takayama 568: ★ ASIR による使用例
1.1 takayama 569:
570:
1.3 maekawa 571: asir を動作させるには, key が必要です.
1.8 takayama 572: OpenXM/lib/asir/asir_key のコメントまたは起動時のメッセージをみて,
573: key を E-mail でとりよせて下さい.
1.1 takayama 574:
1.8 takayama 575: */
576: /*&C
577: ---------------- Call ox_sm1 from asir.
578: bash-2.03$ asir
579: This is Risa/Asir, Version 20000120.
580: Copyright (C) FUJITSU LABORATORIES LIMITED.
581: 1994-1999. All rights reserved.
582: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
583: [269] sm1_genericAnn([x^3-y^2,[s,x,y]]);
584: /* The annihilating ideal of (x^3-y^2)^s */
585: [-2*y*dx-3*x^2*dy,2*x*dx+3*y*dy-6*s]
586:
587:
588: --------------- Call gnuplot from asir.
589: bash-2.03$ asir
590: This is Risa/Asir, Version 20000120.
591: Copyright (C) FUJITSU LABORATORIES LIMITED.
592: 1994-1999. All rights reserved.
593: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
594: [269] gnuplot("plot sin(x);");
595: 0
596: [270]
1.13 takayama 597:
598: */
599:
600: /*&jp
601:
602: ★ sm1 クライアントの利用例
603:
604: */
605: /*&eg
606:
607: ****** Example of the use of sm1 client
1.1 takayama 608:
1.8 takayama 609: */
1.1 takayama 610:
1.8 takayama 611: /*&C
612: -------------------------------------- call ox_asir from sm1
1.1 takayama 613: sm1
614: (oxasir.sm1) run ;
1.8 takayama 615: [(x^20-y^20) (x,y)] fctr pmat ; factorize x^20-y^20 by call ox_asir
1.1 takayama 616:
617:
1.8 takayama 618: */
1.1 takayama 619:
1.8 takayama 620: /*&jp
1.5 takayama 621: [著作権表示]
622: OpenXM/Copyright を御覧ください.
1.6 takayama 623: */
1.8 takayama 624: /*&eg
625: [COPYRIGHT]
626: See OpenXM/Copyright.
627: */
628:
1.41 takayama 629: //&C
630: //&C ----------------------------------------------
631: //&C
632:
1.8 takayama 633: /*&eg
634:
1.6 takayama 635:
1.7 takayama 636:
1.8 takayama 637: ***** TO COMPILE FROM A SOURCE *****
1.7 takayama 638:
639: */
1.6 takayama 640: /*&jp
1.8 takayama 641:
642:
1.6 takayama 643: ★ OpenXM パッケージの Make 法
1.36 takayama 644: FreeBSD 3.x, FreeBSD 4.x, Linux で動作するものと期待してます.
645: (Linux glib6 では, いまのところ, /usr/include/features.h
646: で #define __FAVOR_BSD 1 してコンパイルする必要がありしたが,
1.20 takayama 647: 一部のソースを
648: -D_BSD_SOURCE option をつけて gcc でコンパイルするように変えてます
1.36 takayama 649: (setjmp と sigsetjmp の問題, dirty trick) 現在では問題ありません. )
1.8 takayama 650:
1.6 takayama 651: OpenXM, OpenXM_contrib, OpenXM_contrib2 が必要です.
1.36 takayama 652: ftp.math.kobe-u.ac.jp/OpenXM/1.1.3 より
653: openxm-1.1.3.tar.gz
654: を get して展開して下さい.
655: tar xzvf openxm-1.1.3.tar.gz
656:
657: openxm-1.1.3/OpenXM openxm-1.1.3/OpenXM_contrib
658: openxm-1.1.3/OpenXM_contrib2
659: が生成されます.
660:
1.6 takayama 661: cvs コミッタの場合次のようにしてソースをとりよせます.
662: */
663: /*&eg
664: * How to make OpenXM package?
1.36 takayama 665: We have tested the OpenXM package on FreeBSD 3.x, FreeBSD 4.x, Linux.
666: (On Linux glib6, we needed to define
1.8 takayama 667: #define __FAVOR_BSD 1
1.20 takayama 668: in /usr/include/features.h,
669: but now we are compiling some sources with -D_BSD_SOURCE
1.36 takayama 670: (setjmp vs sigsetjmp). So, you do not need to make this change.)
1.8 takayama 671:
1.6 takayama 672: Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?
1.36 takayama 673: get
674: openxm-1.1.3.tar.gz
675: from ftp.math.kobe-u.ac.jp/OpenXM/1.1.3
676: Expand it by
677: tar xzvf openxm-1.1.3.tar.gz
678:
679: Then, you will get
680: openxm-1.1.3/OpenXM openxm-1.1.3/OpenXM_contrib
681: openxm-1.1.3/OpenXM_contrib2
682:
683:
1.6 takayama 684: If you are a CVS committer, then you can get all sources as follows:
685: */
686: //&C rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2
687: //&C
688: //&jp これらがそろっていたらあとは次のように入力するだけです.
689: //&eg Check that you have these directories, then just type in the following commands
690: /*&C
691:
692: cd OpenXM/src
693: make configure
694: make
695: make install
696:
697: */
698: /*&jp なお, OpenXM/src/ox_math のコンパイルおよび利用には Mathematica が,
699: OpenXM/src/OpenMath のコンパイルおよび利用には
700: には, jdk (java 環境) が必要です.
1.12 takayama 701:
702: Documents を生成するには, tex, ptex (ascii 日本語 tex), dvips, texinfo,
1.36 takayama 703: texi2html, nkf, jlatex2html
1.12 takayama 704: が必要です. 詳しくは Makefiles を見て下さい.
705: Document は, binary distribution の OpenXM/doc, OpenXM/lib
706: より得るのが簡単です.
1.6 takayama 707: */
708: /*&eg In order to use and compile OpenXM/src/ox_math, you need Mathematica.
709: In order to use and compile OpenXM/src/OpenMath,
710: you need jdk (java environment).
1.12 takayama 711:
712: In order to generate the full documentation including Japanese documents,
713: you need tex, ptex (ASCII Inc. Japanese tex), dvips, texinfo, texi2html,
1.36 takayama 714: nkf, jlatex2html. See each Makefile.
1.12 takayama 715: The generated documents are in OpenXM/doc and OpenXM/lib
716: in the binary distribution.
1.15 takayama 717: If you do not like to install Japanese environment such as ptex,
718: type in R for the tex error prompt ? or
719: prepare empty shell scripts ptex and nkf.
1.36 takayama 720: */
721: /*&C
722:
723: */
724:
725: /*&eg
726: To run the system, you need to read OpenXM/rc/dot.cshrc or
727: OpenXM/rc/dot.bashrc by the source
728: command for setting proper environmental variable values.
729:
730: By the commands
731: cd OpenXM/rc
732: make
733: you can generate dot.cshrc and dot.bashrc.
734: Read these file by the source command in your .cshrc
735: or .bashrc (or .bash_profile).
736: */
737: /*&jp
738: システムを動かすには, OpenXM/rc/dot.cshrc または
739: OpenXM/rc/dot.bashrc を source コマンドで
740: よみこみ環境変数の値を適切に設定する必要があります.
741:
742: コマンド
743: cd OpenXM/rc
744: make
745: で dot.cshrc および dot.bashrc が生成されます.
746: これらのファイルを source コマンドで,
747: .cshrc または .bashrc (または .bash_profile) より読むようにして下さい.
1.6 takayama 748: */
749: /*&C
1.1 takayama 750:
1.6 takayama 751: */
1.1 takayama 752:
1.41 takayama 753: //&C ---------------------------------------------------------
754:
755: /*&eg
756: ***** How to generate a subset of the full OpenXM package
757: from the head branch.
758: * The souce tarball of the head branch is at
759: ftp.math.kobe-u.ac.jp/pub/OpenXM/Head/openxm-head.tar.gz
760: Get this tarball by the ftp command. Extract the directories
761: OpenXM OpenXM_contrib OpenXM_contrib2
762: by
763: tar xzvf openxm-head.tar.gz
764: */
765: /*&jp
766: ★ OpenXM package の一部分のみ生成する方法 (head branch より).
767: * Head ブランチの tarball は
768: ftp.math.kobe-u.ac.jp/pub/OpenXM/Head/openxm-head.tar.gz
769: にあります. これを ftp で取得してから
770: tar xzvf openxm-head.tar.gz
771: を展開してください.
772: OpenXM OpenXM_contrib OpenXM_contrib2 が作成されます.
773: */
774: /*&C
775:
776: */
777: /*&eg
778: [Subpackage asir] If you want to generate only Risa/Asir,
779: type in as follows.
780: */
781: /*&jp
782: [部分パッケージ asir] Risa/Asir のみを生成したい場合は,
783: つぎのように入力します.
784: */
785: /*&C
786:
787: (cd OpenXM/src ; make install-asir)
788: (cd OpenXM/rc ; make )
789:
790: */
791: /*&eg
792: Copy the shell script "asir" at OpenXM/rc in your search path, e.g.,
793: /usr/local/bin or ~/bin
794: Or, read OpenXM/rc/dot.bashrc or OpenXM/rc/dot.bashrc by the source
795: command from your ~/.bashrc or ~/.cshrc.
796: */
797: /*&jp
798: OpenXM/rc の下のシェルスクリプト "asir" をサーチパスにコピーして
799: ください (たとえば, /usr/local/bin or ~/bin へ).
800: または OpenXM/rc/dot.bashrc か OpenXM/rc/dot.cshrc を
801: source コマンドで ~/.bashrc か ~/.cshrc より読み込んでください.
802: */
803: /*&C
804:
805: */
806: /*&eg
807: [Subpackage kan-ox] If you want to generate only kan/k0, kan/sm1 and asir
808: type in as follows.
809: */
810: /*&jp
811: [部分パッケージ kan-ox] Kan/k0, Kan/sm1, asir のみを生成したい場合は,
812: つぎのように入力します.
813: */
814: /*&C
815:
816: (cd OpenXM/src ; make install-kan-ox)
817: (cd OpenXM/rc ; make )
818:
819: */
820: /*&eg
821: Copy the shell script "asir", "sm1" and "openxm" at OpenXM/rc
822: to your search path, e.g.,
823: /usr/local/bin or ~/bin
824: Or, read OpenXM/rc/dot.bashrc or OpenXM/rc/dot.bashrc by the source
825: command from your ~/.bashrc or ~/.cshrc.
826: */
827: /*&jp
828: OpenXM/rc の下のシェルスクリプト "asir", "sm1", "openxm" を
829: サーチパスにコピーして
830: ください (たとえば, /usr/local/bin or ~/bin へ).
831: または OpenXM/rc/dot.bashrc か OpenXM/rc/dot.cshrc を
832: source コマンドで ~/.bashrc か ~/.cshrc より読み込んでください.
833: */
834:
835: //&C
836: //&C ------------------------------------------------------
837: //&C
1.6 takayama 838: /*&jp
1.1 takayama 839:
1.8 takayama 840: [OpenXM 下のファイルの構成メモ]
1.3 maekawa 841: lib/asir には, asir のライブラリ, ox_asir 本体
842:
1.8 takayama 843: cd OpenXM/src/kxx ; make install-for-debug した場合,
1.3 maekawa 844: lib/sm1 は src/SSkan/Doc への symbolic link
845: であり, sm1 のライブラリファイルが格納されています.
846: lib/sm1/bin には, binaryfiles
1.1 takayama 847: sm1, ox_sm1, ox, ox_log, ox_sm1_*
1.3 maekawa 848: へのシンボリックリンクが格納されます.
1.8 takayama 849: このシンボリックリンクは src/kxx で make install-for-debug を実行することにより
1.3 maekawa 850: 作成されます.
1.1 takayama 851:
1.3 maekawa 852: sm1 が ox_asir を利用するのに必要なファイル.
1.1 takayama 853: lib/asir/ox_asir,
854: lib/sm1/bin/ox, lib/sm1/bin/ox_log (src/kxx/ox, src/kxx/ox_log)
855: lib/sm1/ox.sm1, lib/sm1/oxasir.sm1
856:
1.3 maekawa 857: asir が ox_sm1_forAsir を利用するのに必要なファイル:
1.1 takayama 858: lib/asir/ox_launch
1.3 maekawa 859: lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク)
1.1 takayama 860: lib/asir/xm
1.3 maekawa 861: lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル.
1.1 takayama 862: callsm1.sm1 callsm1b.sm1
1.3 maekawa 863: (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c
864: ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.)
1.1 takayama 865:
1.3 maekawa 866: asir が ox_sm1_gnuplot を利用するのに必要なファイル:
1.1 takayama 867: lib/asir/ox_launch
1.3 maekawa 868: lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して
1.4 maekawa 869: gnuplot4ox を実行します.)
1.1 takayama 870: lib/asir/xm
871: lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1
1.3 maekawa 872: (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c
873: ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.)
1.4 maekawa 874: bin/gnuplot4ox, bin/gnuplot_x11 (gnuplot 本体, src/gnuplot*)
1.1 takayama 875:
876: ----------------------------------------
1.3 maekawa 877: [開発者用メモ]
1.1 takayama 878:
1.3 maekawa 879: << sm1, ox_sm1, ox, oxlog の debug >>
880: binary file は各 directory の make install により
881: OpenXM/bin にコピーされますが,
882: debug 用にいちいちコピーするのは面倒なので,
1.8 takayama 883: OpenXM/src/kan96xx で make install-for-debug
884: OpenXM/src/kxx で make install-for-debug
1.3 maekawa 885: を実行すると,
886: OpenXM/bin/sm1, ox, ox_sm1, oxlog より,
1.1 takayama 887: OpenXM/src/kan96xx/Kan/sm1
888: OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
1.3 maekawa 889: へのシンボリックリンクが作成されます.
1.1 takayama 890:
1.3 maekawa 891: [CVSコミッタ用メモ]
892: << OpenXM ディレクトリ配布版の作成方法 >>
1.1 takayama 893: rcvs export -rHEAD OpenXM
894: rcvs export -rHEAD OpenXM_contrib
895: rcvs export -rHEAD OpenXM_contrib2
1.21 takayama 896: cd OpenXM/src ; make generate-source-distribution
1.3 maekawa 897: して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip.
1.7 takayama 898: */
899:
900: /*&C
901:
902: */
903: /*&jp
904:
905: ★ Solaris に関する注意.
906: Solaris ではまだ問題が山積してます.
907: Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt
908: を見てください.
1.8 takayama 909: Solaris でコンパイルするには, /usr/ccs/bin をサーチパスの最初へもっていって
910: おきます.
1.7 takayama 911:
912: */
1.8 takayama 913: /*&eg
914: ***** COMPILE ON SOLARIS
915: There are a lot of troubles on Solaris for now.
916: At least,
917: /usr/ccs/bin must be at the top of the command search path to compile
918: on Solaris.
919: */
1.31 takayama 920: /*&jp
921:
922: ★ Redhat Linux 6.1 上でのコンパイル
923: m4-1.4 と autoconf-2.13 が必要.
924: (あらかじめはいっている, autoconf は 2.12 でありこれは
925: gnuplot の make で不具合を生じます.)
1.8 takayama 926:
1.31 takayama 927: */
928: /*&eg
929: ***** COMPILE ON Redhat Linux 6.1
930: m4-1.4 and autoconf-2.13 are required.
931: (Preinstalled autoconf is version 2.12. It causes a trouble when
932: you build gnuplot.)
933: */
1.7 takayama 934:
935: /*&C
936:
1.1 takayama 937: */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>