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

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

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

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