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

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

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

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