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

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

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

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