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

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

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

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