[BACK]Return to install.oxweave CVS log [TXT][DIR] Up to [local] / OpenXM / doc

Annotation of OpenXM/doc/install.oxweave, Revision 1.16

1.16    ! takayama    1: %% $OpenXM: OpenXM/doc/install.oxweave,v 1.15 2000/01/21 12:48:47 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.16    ! takayama    6: Consult firstly the ERRATA section for your release on this web cite
        !             7: for troubles.
1.6       takayama    8:
                      9: OpenXM package : Getting started.
                     10:
                     11: */
1.1       takayama   12: /*&jp
1.6       takayama   13: ★ OpenXM パッケージの利用方法
                     14: この節では, OpenXM package binary distribution のインストール法を説明します.
                     15: インストールに必要なシステムの仕様については, 動作環境を御覧ください.
1.1       takayama   16: */
                     17: /*&eg
1.6       takayama   18: ***** HOW TO USE OpenXM PACKAGE?
                     19: In this section, we will explain how to install OpenXM package binary
                     20: distribution.
                     21: As to the required environment, see the section "System Requirement"
                     22: */
                     23: /*&jp
                     24:
                     25: (1)  Tar ボールより次のようにしてディレクトリ OpenXM を取り出します.
1.13      takayama   26:      OpenXM はどこにおいてもかまいません. ルートになってインストール
                     27:      する必要もありません.
                     28:      できれば, /usr/local/OpenXM  においてほしいと思います.
1.6       takayama   29:
1.1       takayama   30: */
1.6       takayama   31: /*&eg
1.1       takayama   32:
1.6       takayama   33: (1)  Extract the directory OpenXM from the tar ball.
                     34:      You can put the directory OpenXM at any place in the file system.
1.13      takayama   35:      You do not need to be a root to install it.
                     36:      We are happy if you put OpenXM at /usr/local/OpenXM
1.2       takayama   37:
                     38: */
1.6       takayama   39: /*&C
                     40:          tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz
                     41:
1.2       takayama   42: */
1.6       takayama   43: /*&jp
                     44: 以下 (1) で生成されたディレクトリ OpenXM の絶対パスを /xxx/yyy/OpenXM
                     45: と書きます.
                     46:
1.1       takayama   47: */
1.6       takayama   48: /*&eg
                     49: In the sequel, we will denote the absolute path of the directory OpenXM
                     50: by /xxx/yyy/OpenXM.
1.1       takayama   51:
                     52: */
                     53: /*&jp
1.6       takayama   54: (2) 次のように入力して OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc
                     55:     ファイルを自動生成します.
                     56:     これらのファイルには, OpenXM/bin のファイルを実行するための
                     57:     環境変数が定義されています.
                     58:
1.5       takayama   59: */
                     60: /*&eg
1.6       takayama   61: (2) Generate  OpenXM/rc/dot.cshrc and OpenXM/rc/dot.bashrc
                     62:     by the following command.
                     63:     Environmental variables to execute commands in OpenXM/bin
                     64:     are defined in these files.
                     65:
1.5       takayama   66: */
1.6       takayama   67: /*&C
                     68:
1.8       takayama   69:      cd /xxx/yyy/OpenXM/rc
1.6       takayama   70:      make
1.5       takayama   71:
                     72: */
                     73: /*&jp
1.6       takayama   74: (3) csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます.
                     75:
1.1       takayama   76: */
                     77: /*&eg
1.6       takayama   78: (3) Append the following line to the end of  ~/.cshrc when you are
                     79:     using csh as your shell.
                     80:
1.1       takayama   81: */
                     82: /*&C
1.2       takayama   83:
1.6       takayama   84:     source /xxx/yyy/OpenXM/rc/dot.cshrc
1.2       takayama   85:
1.1       takayama   86: */
                     87: /*&jp
1.6       takayama   88: (3') bash を利用してる場合, 次の行を ~/.bashrc の最後に加えます.
                     89:
1.1       takayama   90: */
                     91: /*&eg
1.6       takayama   92: (3') Append the following line to the end of  ~/.bashrc when you are
                     93:     using bash as your shell.
                     94:
                     95: */
                     96: /*&C
                     97:
                     98:     source /xxx/yyy/OpenXM/rc/dot.bash
                     99:
1.1       takayama  100: */
1.14      takayama  101:
                    102: /*&jp
                    103:
                    104:  (3) または (3') を終了したら, いったん logout して login しなおすか
                    105:  または, source コマンドで, dot.bash または dot.csh を読み込んで下さい.
                    106:
                    107: */
                    108: /*&eg
                    109:
                    110:    After finishing the step (3) or (3'), logout and login again,
                    111:    or read dot.bash or dot.cshrc file by the source command.
                    112:
                    113: */
                    114:
1.6       takayama  115:
1.2       takayama  116: //&C
1.13      takayama  117: //&jp (4) asir の利用には  key が必要です.
                    118: //&eg (4) You need a key to use asir.
1.2       takayama  119: //&C
1.13      takayama  120: /*&jp
                    121:     asir の起動時のメッセージまたは OpenXM/lib/asir/asir_key を
                    122:     参照して, key を取得して下さい (数秒しかかかりません).
                    123:
                    124: */
                    125: /*&eg
                    126:     Please get the key by following the instruction from asir itself or
                    127:     that in OpenXM/lib/asir/asir_key (it takes only a few seconds
                    128:     to get the key).
                    129:
                    130: */
1.6       takayama  131:
                    132: /*&C
1.8       takayama  133:
                    134: ***** QUALITY:
                    135:   the following modules and functions have still experimental qualities:
1.6       takayama  136:    OpenXM/bin/k0,  OpenXM/bin/d0
                    137:    OpenXM/bin/ox_math,  OpenXM/bin/math2ox
                    138:    OpenXM/lib/java-support/ *
                    139:    Asir client functions:   m_* (Mathematica)  ,  om_*  (OpenMath)
1.11      takayama  140:    OpenXM/bin/sm1, ox_sm1 on Linux libc6.
1.6       takayama  141: */
                    142: /*&C
                    143:
                    144:
1.8       takayama  145: */
                    146: /*&jp
                    147: ★ Java に関する注意:
                    148: 注意 1.
                    149: OpenMath 用の OMproxy には現在のところ, jdk が必要です.
                    150: たとえば bash を利用している場合, .bashrc で
                    151: PATH=/usr/local/jdk1.1.8/bin:$PATH
                    152: export PATH
1.10      takayama  153: などとして, jdk の java, javac をサーチパスの先のほうへもっていくようにして
1.8       takayama  154: ください.
1.10      takayama  155: csh を利用している場合, .cshrc で
                    156: set path=(/usr/local/jdk1.1.8/bin $path)
                    157: として, jdk の java, javac をサーチパスにいれます.
1.8       takayama  158: */
                    159: /*&eg
                    160: ***** JAVA
                    161: In order to use OMproxy, asir client om_*,
                    162: you need to install JDK.
                    163: The bin dir of the JDK must be in yur search path.
                    164: For example, you need to add the following line
1.10      takayama  165: to your .chsrc when your shell is csh
1.8       takayama  166: set path=(/usr/local/jdk1.1.8/bin $path)
1.10      takayama  167: Bash users put the following line to .bashrc
                    168: PATH=/usr/local/jdk1.1.8/bin:$PATH
                    169: export PATH
1.8       takayama  170: */
                    171:
                    172: /*&C
                    173:
                    174:
1.6       takayama  175:
                    176:
                    177: */
                    178: /*&jp
                    179: ★ 動作環境
                    180:
                    181: */
                    182: /*&eg
1.7       takayama  183: ***** SYSTEM REQUIREMENTS
1.6       takayama  184:
                    185: */
                    186: /*&C
                    187:
1.11      takayama  188: OS:  FreeBSD 3.3 (Intel CPU),
                    189:      Linux systems (Intel CPU):
1.15      takayama  190:          Most Linux with libc5 and with libc6 (glibc 2.x).
1.7       takayama  191:
                    192:      X window system is required.
                    193:
                    194:      Most part of the OpenXM package may work on other versions of
1.11      takayama  195:      FreeBSD 3.x and Linux, but we have not yet tested.
1.6       takayama  196:
                    197: */
                    198: /*&jp
1.8       takayama  199: 次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを
1.6       takayama  200: 必要とします.
                    201: */
                    202: /*&eg
                    203: The following modules require the listed softwares other than the standard
                    204: OS package.
                    205: */
                    206: /*&C
                    207:
                    208: (1) OpenXM/bin/ox_math  :       Mathematica Version 3.x or 4.x
                    209:    (Mathematica server)         at /usr/local/Mathematica
                    210:     OpenXM/bin/math2ox          [ see http://www.wolfram.com ]
                    211:     Asir client functions  m_*
                    212: (2) OpenXM/lib/java-support :   JDK at /usr/local/jdk??
1.8       takayama  213:                                 [ see the section on JAVA]
1.6       takayama  214:     Asir client functions  om_*
                    215:     sm1 client functions   om_*
1.7       takayama  216: (3) PHC pack (OpenXM/bin/phc)  and  asir client functions
                    217:     phc_*  run only on linux (glib5).
1.8       takayama  218:     If you install the linux emulation^{note 1} on Free BSD, they run on
                    219:     FreeBSD, too.
                    220:     <note 1>
                    221:       Add linux_enable="YES" in /etc/rc.conf
                    222:       You need the following packages:
                    223:       pkg_info | grep linu
                    224:       linux_base-5.2      The base set of packages needed in Linux mode
                    225:       linux_devtools-5.2  Packages needed for doing development in Linux mode
1.6       takayama  226:
                    227: */
                    228:
                    229:
1.1       takayama  230: /*&jp
1.7       takayama  231: 日本語版の注意.
1.3       maekawa   232: 注意 1.
                    233: asir で日本語のヘルプを利用するには,
1.1       takayama  234: PAGER=jless
                    235: export PAGER
1.3       maekawa   236: などで, 日本語を扱える PAGER を指定する必要があるかもしれません.
1.1       takayama  237: */
1.7       takayama  238:
                    239: /*&eg
                    240:
1.8       takayama  241: The installation is completed.
1.7       takayama  242:
                    243: */
                    244: /*&jp
                    245:
                    246: 以上.
                    247:
                    248: */
                    249:
1.1       takayama  250: /*&jp
1.7       takayama  251: ★ 文書
                    252:
                    253:   OpenXM パッケージでもっとも充実しているクライアントは,
                    254:   asir です.
                    255:   asir のつかいかたは
                    256:         OpenXM/doc/asir2000/man-jp.dvi
                    257:        または OpenXM/doc/asir2000/html-jp の HTML ファイルを見て下さい.
                    258:   asir 用 OpenXM クライアントライブラリのつかい方は,
                    259:         OpenXM/doc/asir-contrib/cman-jp.dvi
                    260:   を見て下さい.  dvi の付くファイルは xdvi で見ることができます.
                    261:
                    262:   OpenXM の設計の概要については,
                    263:       OpenXM/doc/issac2000/issac2000.ps
                    264:   を見て下さい.
                    265:   ps の付くファイルは, ghostview で見ることができます.
                    266:
                    267: */
                    268: /*&eg
                    269: ***** DOCUMENTS
                    270:
                    271:   The best OpenXM client in the OpenXM package is now
                    272:   asir.
                    273:   Documents on asir are
                    274:     OpenXM/doc/asir2000/man-eg.dvi
                    275:     OpenXM/doc/asir2000/html-eg (HTML)
                    276:
                    277:   The file
                    278:     OpenXM/doc/asir-contrib/cman-eg.dvi
                    279:   is a document on OpenXM client libraries for asir.
1.1       takayama  280:
1.7       takayama  281:   The design outline is described in
                    282:       OpenXM/doc/issac2000/issac2000.ps
                    283:
                    284:   Dvi files can be previewed by xdvi and
                    285:   ps files  can be previewed by ghostview.
                    286: */
1.1       takayama  287:
                    288:
1.8       takayama  289: /*&eg
                    290:
                    291:
                    292: ***** A QUICK TOUR OF OPENXM BY ASIR
                    293:
                    294: */
1.7       takayama  295: /*&jp
1.1       takayama  296:
                    297:
1.8       takayama  298: ★ ASIR による使用例
1.1       takayama  299:
                    300:
1.3       maekawa   301: asir を動作させるには, key が必要です.
1.8       takayama  302: OpenXM/lib/asir/asir_key のコメントまたは起動時のメッセージをみて,
                    303: key を E-mail でとりよせて下さい.
1.1       takayama  304:
1.8       takayama  305: */
                    306: /*&C
                    307: ----------------   Call ox_sm1 from asir.
                    308: bash-2.03$ asir
                    309: This is Risa/Asir, Version 20000120.
                    310: Copyright (C) FUJITSU LABORATORIES LIMITED.
                    311: 1994-1999. All rights reserved.
                    312: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
                    313: [269] sm1_genericAnn([x^3-y^2,[s,x,y]]);
                    314:    /* The annihilating ideal of (x^3-y^2)^s */
                    315: [-2*y*dx-3*x^2*dy,2*x*dx+3*y*dy-6*s]
                    316:
                    317:
                    318: ---------------    Call gnuplot from asir.
                    319: bash-2.03$ asir
                    320: This is Risa/Asir, Version 20000120.
                    321: Copyright (C) FUJITSU LABORATORIES LIMITED.
                    322: 1994-1999. All rights reserved.
                    323: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
                    324: [269] gnuplot("plot sin(x);");
                    325: 0
                    326: [270]
1.13      takayama  327:
                    328: */
                    329:
                    330: /*&jp
                    331:
                    332: ★  sm1 クライアントの利用例
                    333:
                    334: */
                    335: /*&eg
                    336:
                    337: ******  Example of the use of sm1 client
1.1       takayama  338:
1.8       takayama  339: */
1.1       takayama  340:
1.8       takayama  341: /*&C
                    342: --------------------------------------  call ox_asir from sm1
1.1       takayama  343: sm1
                    344: (oxasir.sm1) run  ;
1.8       takayama  345: [(x^20-y^20) (x,y)] fctr pmat ;     factorize x^20-y^20 by call ox_asir
1.1       takayama  346:
                    347:
1.8       takayama  348: */
1.1       takayama  349:
1.8       takayama  350: /*&jp
1.5       takayama  351: [著作権表示]
                    352: OpenXM/Copyright を御覧ください.
1.6       takayama  353: */
1.8       takayama  354: /*&eg
                    355: [COPYRIGHT]
                    356: See OpenXM/Copyright.
                    357: */
                    358:
                    359: /*&eg
                    360:
1.6       takayama  361:
1.7       takayama  362:
1.8       takayama  363: *****  TO COMPILE FROM A SOURCE *****
1.7       takayama  364:
                    365: */
1.6       takayama  366: /*&jp
1.8       takayama  367:
                    368:
1.6       takayama  369: ★ OpenXM パッケージの Make 法
                    370:   FreeBSD 2.2.8, FreeBSD 3.3, Linux で動作するものと期待してます.
1.8       takayama  371:   Linux glib6 では, いまのところ, /usr/include/features.h
                    372:   で #define __FAVOR_BSD 1 してコンパイルする必要があります.
                    373:   (setjmp と sigsetjmp の問題, dirty trick)
                    374:
1.6       takayama  375:    OpenXM, OpenXM_contrib, OpenXM_contrib2 が必要です.
                    376:    cvs コミッタの場合次のようにしてソースをとりよせます.
                    377: */
                    378: /*&eg
                    379: * How to make OpenXM package?
                    380:  We have tested the OpenXM package on FreeBSD 2.2.8, FreeBSD 3.3, Linux.
1.8       takayama  381:  On Linux glib6, you need to define
                    382:    #define  __FAVOR_BSD 1
                    383:  in /usr/include/features.h
                    384:  (setjmp vs sigsetjmp)
                    385:
1.6       takayama  386:  Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?
                    387:  If you are a CVS committer, then you can get all sources as follows:
                    388: */
                    389: //&C  rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2
                    390: //&C
                    391: //&jp これらがそろっていたらあとは次のように入力するだけです.
                    392: //&eg Check that you have these directories, then just type in the following commands
                    393: /*&C
                    394:
                    395:    cd OpenXM/src
                    396:    make configure
                    397:    make
                    398:    make install
                    399:
                    400: */
                    401: /*&jp なお, OpenXM/src/ox_math のコンパイルおよび利用には Mathematica が,
                    402: OpenXM/src/OpenMath のコンパイルおよび利用には
                    403: には, jdk (java 環境) が必要です.
1.12      takayama  404:
                    405: Documents を生成するには,  tex, ptex (ascii 日本語 tex), dvips, texinfo,
                    406: texi2html, nkf,
                    407: が必要です. 詳しくは Makefiles を見て下さい.
                    408: Document は, binary distribution の OpenXM/doc, OpenXM/lib
                    409: より得るのが簡単です.
1.6       takayama  410: */
                    411: /*&eg In order to use and compile OpenXM/src/ox_math, you need Mathematica.
                    412: In order to use and compile OpenXM/src/OpenMath,
                    413: you need jdk (java environment).
1.12      takayama  414:
                    415: In order to generate the full documentation including Japanese documents,
                    416: you need tex, ptex (ASCII Inc. Japanese tex), dvips, texinfo, texi2html,
                    417: nkf. See each Makefile.
                    418: The generated documents are in OpenXM/doc and OpenXM/lib
                    419: in the binary distribution.
1.15      takayama  420: If you do not like to install Japanese environment such as ptex,
                    421: type in R for the tex error prompt ? or
                    422: prepare empty shell scripts ptex and nkf.
1.6       takayama  423: */
                    424: /*&C
1.9       takayama  425:
                    426: */
                    427: /*&jp
                    428:
                    429:   OpenXM_contrib2/asir2000 の配布を受けてない場合 (ソースライセンスを
                    430:   富士通より受ける必要があります),
                    431:   OpenXM/src/Makefile の各モジュール名 たとえば
                    432:    make all-kan96xx
                    433:   などと各モジュール名を指定してコンパイルして下さい.
                    434:
                    435: */
                    436: /*&eg
                    437:
                    438:   If you cannot get a source liscence of OpenXM_contrib2/asir2000
                    439:   from Fujitsu labs,
                    440:   compile each modules independently, e.g.,
                    441:     make all-kan96xx
1.1       takayama  442:
1.6       takayama  443: */
1.1       takayama  444:
1.6       takayama  445: /*&jp
1.1       takayama  446:
1.8       takayama  447: [OpenXM 下のファイルの構成メモ]
1.3       maekawa   448: lib/asir には, asir のライブラリ, ox_asir 本体
                    449:
1.8       takayama  450: cd OpenXM/src/kxx ; make install-for-debug した場合,
1.3       maekawa   451: lib/sm1 は src/SSkan/Doc への symbolic link
                    452: であり, sm1 のライブラリファイルが格納されています.
                    453: lib/sm1/bin には, binaryfiles
1.1       takayama  454:     sm1, ox_sm1, ox,  ox_log, ox_sm1_*
1.3       maekawa   455: へのシンボリックリンクが格納されます.
1.8       takayama  456: このシンボリックリンクは src/kxx で make install-for-debug を実行することにより
1.3       maekawa   457: 作成されます.
1.1       takayama  458:
1.3       maekawa   459: sm1 が ox_asir を利用するのに必要なファイル.
1.1       takayama  460:    lib/asir/ox_asir,
                    461:    lib/sm1/bin/ox, lib/sm1/bin/ox_log  (src/kxx/ox, src/kxx/ox_log)
                    462:    lib/sm1/ox.sm1, lib/sm1/oxasir.sm1
                    463:
1.3       maekawa   464: asir が ox_sm1_forAsir を利用するのに必要なファイル:
1.1       takayama  465:    lib/asir/ox_launch
1.3       maekawa   466:    lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク)
1.1       takayama  467:    lib/asir/xm
1.3       maekawa   468:    lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル.
1.1       takayama  469:      callsm1.sm1 callsm1b.sm1
1.3       maekawa   470:      (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c
                    471:       ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.)
1.1       takayama  472:
1.3       maekawa   473: asir が ox_sm1_gnuplot を利用するのに必要なファイル:
1.1       takayama  474:     lib/asir/ox_launch
1.3       maekawa   475:     lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して
1.4       maekawa   476:                                 gnuplot4ox を実行します.)
1.1       takayama  477:     lib/asir/xm
                    478:     lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1
1.3       maekawa   479:      (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c
                    480:       ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.)
1.4       maekawa   481:     bin/gnuplot4ox,  bin/gnuplot_x11  (gnuplot 本体, src/gnuplot*)
1.1       takayama  482:
                    483: ----------------------------------------
1.3       maekawa   484: [開発者用メモ]
1.1       takayama  485:
1.3       maekawa   486: << sm1, ox_sm1, ox, oxlog の debug >>
                    487: binary file は各 directory の make install により
                    488: OpenXM/bin にコピーされますが,
                    489: debug 用にいちいちコピーするのは面倒なので,
1.8       takayama  490: OpenXM/src/kan96xx で make install-for-debug
                    491: OpenXM/src/kxx で make install-for-debug
1.3       maekawa   492: を実行すると,
                    493: OpenXM/bin/sm1, ox, ox_sm1, oxlog より,
1.1       takayama  494: OpenXM/src/kan96xx/Kan/sm1
                    495: OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
1.3       maekawa   496: へのシンボリックリンクが作成されます.
1.1       takayama  497:
1.3       maekawa   498: [CVSコミッタ用メモ]
                    499: <<  OpenXM ディレクトリ配布版の作成方法 >>
1.1       takayama  500: rcvs export -rHEAD OpenXM
                    501: rcvs export -rHEAD OpenXM_contrib
                    502: rcvs export -rHEAD OpenXM_contrib2
1.3       maekawa   503: して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip.
1.7       takayama  504: */
                    505:
                    506: /*&C
                    507:
                    508: */
                    509: /*&jp
                    510:
                    511: ★ Solaris に関する注意.
                    512: Solaris ではまだ問題が山積してます.
                    513: Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt
                    514: を見てください.
1.8       takayama  515: Solaris でコンパイルするには, /usr/ccs/bin をサーチパスの最初へもっていって
                    516: おきます.
1.7       takayama  517:
                    518: */
1.8       takayama  519: /*&eg
                    520: ***** COMPILE ON SOLARIS
                    521:  There are a lot of troubles on Solaris for now.
                    522:  At least,
                    523:  /usr/ccs/bin must be at the top of the command search path to compile
                    524:  on Solaris.
                    525: */
                    526:
1.7       takayama  527:
                    528: /*&C
                    529:
1.1       takayama  530: */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>