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

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

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

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