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

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

1.37    ! takayama    1: %% $OpenXM: OpenXM/doc/install.oxweave,v 1.36 2000/09/21 08:06:39 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
1.34      takayama    6:               http://www.openxm.org
1.16      takayama    7: Consult firstly the ERRATA section for your release on this web cite
                      8: for troubles.
1.6       takayama    9:
                     10: OpenXM package : Getting started.
                     11:
1.34      takayama   12: This document is for OpenXM version 1.1.3.  (Draft)
                     13:
1.6       takayama   14: */
1.1       takayama   15: /*&jp
1.23      takayama   16: ★ OpenXM GENERIC パッケージの利用方法
1.6       takayama   17: この節では, OpenXM package binary distribution のインストール法を説明します.
1.36      takayama   18: ソースからインストールする場合は
                     19:        ★ OpenXM パッケージの Make 法
                     20: を御覧下さい.
1.6       takayama   21: インストールに必要なシステムの仕様については, 動作環境を御覧ください.
1.1       takayama   22: */
                     23: /*&eg
1.23      takayama   24: ***** HOW TO INSTALL OpenXM GENERIC PACKAGE?
1.6       takayama   25: In this section, we will explain how to install OpenXM package binary
                     26: distribution.
1.36      takayama   27: If you build from the source, see the section
                     28:       * How to make OpenXM package?
1.6       takayama   29: As to the required environment, see the section "System Requirement"
                     30: */
                     31: /*&jp
                     32:
                     33: (1)  Tar ボールより次のようにしてディレクトリ OpenXM を取り出します.
1.13      takayama   34:      OpenXM はどこにおいてもかまいません. ルートになってインストール
                     35:      する必要もありません.
                     36:      できれば, /usr/local/OpenXM  においてほしいと思います.
1.6       takayama   37:
1.1       takayama   38: */
1.6       takayama   39: /*&eg
1.1       takayama   40:
1.6       takayama   41: (1)  Extract the directory OpenXM from the tar ball.
                     42:      You can put the directory OpenXM at any place in the file system.
1.13      takayama   43:      You do not need to be a root to install it.
                     44:      We are happy if you put OpenXM at /usr/local/OpenXM
1.2       takayama   45:
                     46: */
1.6       takayama   47: /*&C
1.24      takayama   48:
                     49:          tar xzvf OpenXM-shared.tgz
1.6       takayama   50:          tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz
                     51:
1.2       takayama   52: */
1.6       takayama   53: /*&jp
                     54: 以下 (1) で生成されたディレクトリ OpenXM の絶対パスを /xxx/yyy/OpenXM
                     55: と書きます.
                     56:
1.1       takayama   57: */
1.6       takayama   58: /*&eg
                     59: In the sequel, we will denote the absolute path of the directory OpenXM
                     60: by /xxx/yyy/OpenXM.
1.1       takayama   61:
                     62: */
                     63: /*&jp
1.23      takayama   64: (2) OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc,
                     65:     OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, 等の
                     66:     ファイルを自動生成します.
                     67:     openxm, asir, oxmath などは OpenXM クライアントを起動するための
                     68:     シエルスクリプトです. これらを /usr/local/bin にインストールするには
                     69:     次のように入力します.
1.6       takayama   70:
1.5       takayama   71: */
                     72: /*&eg
1.19      takayama   73: (2) Generate  OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc and
1.23      takayama   74:     OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, ...
                     75:     The files openxm, asir, oxmath are shell scripts to invoke OpenXM clients.
                     76:     If you want to install these shell scripts to /usr/local/bin,
                     77:     type in as follows.
1.6       takayama   78:
1.5       takayama   79: */
1.6       takayama   80: /*&C
                     81:
1.8       takayama   82:      cd /xxx/yyy/OpenXM/rc
1.23      takayama   83:      make install
1.5       takayama   84:
                     85: */
                     86: /*&jp
1.23      takayama   87:
                     88:      /usr/local/bin でなく, home directory の bin にインストールしたい
                     89:      ときは, 次のように入力してください.
                     90:
                     91: */
                     92: /*&eg
                     93:
                     94:     If you want to install them under the bin of your home directory,
                     95:     type in as follows.
                     96:
                     97: */
                     98: /*&C
                     99:
                    100:    cd /xxx/yyy/OpenXM/rc
                    101:    make install PREFIX=$HOME/bin
                    102:
                    103: */
                    104: /*&C
                    105:
                    106:    [Note] If you are Solaris user, you might have to type in like
                    107:      /usr/ccs/bin/make install PREFIX=$HOME/bin
                    108:
                    109: */
                    110: /*&jp
                    111:
                    112: OpenXM/bin の下のファイルを直接実行したい場合は, 以下の設定が必要です.
                    113: OpenXM clients を実行するだけの場合は, (3), (3') は skip してください.
                    114:
1.6       takayama  115: (3) csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます.
                    116:
1.1       takayama  117: */
                    118: /*&eg
1.23      takayama  119:
                    120: If you want to execute binaries under OpenXM/bin, you need to perform
                    121: (3) and (3').
                    122: If you use only OpenXM clients, skip (3) and (3').
                    123:
1.6       takayama  124: (3) Append the following line to the end of  ~/.cshrc when you are
                    125:     using csh as your shell.
                    126:
1.1       takayama  127: */
                    128: /*&C
1.2       takayama  129:
1.6       takayama  130:     source /xxx/yyy/OpenXM/rc/dot.cshrc
1.2       takayama  131:
1.1       takayama  132: */
                    133: /*&jp
1.6       takayama  134: (3') bash を利用してる場合, 次の行を ~/.bashrc の最後に加えます.
                    135:
1.1       takayama  136: */
                    137: /*&eg
1.6       takayama  138: (3') Append the following line to the end of  ~/.bashrc when you are
                    139:     using bash as your shell.
                    140:
                    141: */
                    142: /*&C
                    143:
1.18      takayama  144:     source /xxx/yyy/OpenXM/rc/dot.bashrc
1.6       takayama  145:
1.1       takayama  146: */
1.14      takayama  147:
                    148: /*&jp
                    149:
                    150:  (3) または (3') を終了したら, いったん logout して login しなおすか
1.18      takayama  151:  または, source コマンドで, dot.bashrc または dot.csh を読み込んで下さい.
1.14      takayama  152:
                    153: */
                    154: /*&eg
                    155:
                    156:    After finishing the step (3) or (3'), logout and login again,
1.18      takayama  157:    or read dot.bashrc or dot.cshrc file by the source command.
1.14      takayama  158:
                    159: */
                    160:
1.6       takayama  161:
1.32      takayama  162: /*&C
                    163:
                    164:           FAQ
                    165:
                    166: */
                    167: /*&jp
                    168: Q. OpenXM の asir OpenXM client を icon でスタートするには?
                    169: A. 次の行を, .Xdefaults または, xrdb で読み込むファイルに書いておきます.
                    170: */
                    171: /*&eg
                    172: Q. How to start asir OpenXM clients in the iconic mode?
                    173: A. Add the following line to .Xdefaults or a file you read by xrdb.
                    174: */
                    175: /*&C
                    176:
                    177:        ox_xterm*iconic: on
1.28      takayama  178:
                    179: */
                    180: /*&jp
                    181:
                    182: ★ OpenXM FreeBSD binary パッケージのインストール方法
                    183:      openxm-version.tgz
                    184:    を ftp サイトより copy して,
                    185:    root になって,
                    186:      pkg_add openxm-version.tgz
                    187:    OpenXM は /usr/local/OpenXM にインストールされます.
                    188:    あとは, 上の (4) へ.
                    189:    ここで version は OpenXM の version 番号で, たとえば,
                    190:    2000, 3/20(Mon) 版は  1.1.2
                    191:
1.30      takayama  192:    java および linux emulation が実行に必要です.
                    193:    java が, サーチパスのなかにある必要がありますので,
                    194:    たとえば,
                    195:      set path=(/usr/local/jdk1.1.8 $path)
                    196:      rehash
                    197:    してから, pkg_add して下さい.
                    198:    インストール終了後のメッセージにしたがい, 必要な設定を
                    199:    おこなって下さい.
                    200:
1.34      takayama  201:    jdk は /usr/ports/lang/jdk よりインストールできます.
                    202:    Linux emulation を有効にするには,
                    203:     /etc/rc.conf に
                    204:     linux_enable="YES"
                    205:    と書き,
                    206:    /usr/ports/emulators/linux_base を用いて, linux 用の共有ライブラリ等を
                    207:    インストールしておきます.
                    208:      (FreeBSD 3.x, 4.x)
                    209:
                    210:
1.30      takayama  211:    /usr/local にインストールしなかった場合は,
                    212:    (2) を実行して下さい.
                    213:
1.28      takayama  214: */
                    215: /*&eg
                    216:
                    217: ***** HOW TO INSTALL OpenXM FreeBSD binary package
                    218:    Copy
                    219:       openxm-version.tgz
                    220:    from our ftp cite.
                    221:    Become the super user and type
                    222:       pkg_add openxm-version.tgz
                    223:    OpenXM will be installed to /usr/local/OpenXM
                    224:    Go to (4) above.
                    225:    Here, version is the version number of OpenXM.
                    226:    For example, the version number of the OpenXM of May 20 (Mon), 2000
                    227:    is 1.1.2
                    228:
1.30      takayama  229:    java and linux emulation are required to run OpenXM packages.
                    230:    Java needs to be in the search path. So, for example, execute pkg_add
                    231:    after
                    232:      set path=(/usr/local/jdk1.1.8 $path)
                    233:      rehash
                    234:    Following the message of pkg_add after the installation,
1.34      takayama  235:    set path.
                    236:
                    237:    jdk can be installed by /usr/ports/lang/jdk.
                    238:    Add the line
                    239:     linux_enable="YES"
                    240:    to /etc/rc.conf and install shared libraries for linux
                    241:    by /usr/ports/emulators/linux_base.
                    242:    Then, you can emulate linux.
                    243:
1.30      takayama  244:    If you do not install under /usr/local,
                    245:    goto (2).
                    246:
1.28      takayama  247: */
                    248: /*&jp
                    249:
                    250: ★ OpenXM Redhat Package manager (Linux)
                    251:    binary パッケージのインストール方法
1.29      takayama  252:       openxm-shared-version-suffix.noarch.rpm
1.28      takayama  253:       openxm-binary-version-suffix.i386.rpm
                    254:    を ftp サイトより copy して,
                    255:    root になって,
1.29      takayama  256:      rpm -i  openxm-shared-version-suffix.noarch.rpm
1.28      takayama  257:      rpm -i  openxm-binary-version-suffix.i386.rpm
                    258:    OpenXM は /usr/local/OpenXM にインストールされます.
                    259:    あとは, 上の (4) へ.
                    260:    ここで version は OpenXM の version 番号で, たとえば,
                    261:    2000, 3/20(Mon) 版は  1.1.2
                    262:    suffix は, RPM 版の minor version number.
                    263:
                    264:    Debian を利用している場合, コマンド alien で, rpm 形式を deb 形式に
                    265:    変換できます.
                    266:
1.30      takayama  267:    /usr/local の下へインストールしなかった場合は, (2) を実行して下さい.
                    268:
1.28      takayama  269: */
                    270: /*&eg
                    271:
                    272: ***** HOW TO INSTALL OpenXM by the redhat Package manager (Linux)
                    273:    Copy
1.29      takayama  274:       openxm-shared-version-suffix.noarch.rpm
1.28      takayama  275:       openxm-binary-version-suffix.i386.rpm
                    276:    from our ftp cite.
                    277:    Become the super user and type
1.29      takayama  278:      rpm -i  openxm-shared-version-suffix.noarch.rpm
1.28      takayama  279:      rpm -i  openxm-binary-version-suffix.i386.rpm
                    280:    OpenXM will be installed to /usr/local/OpenXM
                    281:    Go to (4) above.
                    282:    Here, version is the version number of OpenXM.
                    283:    For example, the version number of the OpenXM of May 20 (Mon), 2000
                    284:    is 1.1.2
                    285:    suffix is the minor version number of the package.
                    286:
                    287:    If you are using debian, please use the command alien to translate
                    288:    rpm to deb.
1.30      takayama  289:
                    290:    If you do not install under /usr/local, goto (2).
                    291:
1.13      takayama  292:
                    293: */
1.6       takayama  294:
                    295: /*&C
1.8       takayama  296:
1.27      takayama  297: ***** OpenXM client programs under OpenXM/bin or /usr/local/bin:
                    298:    asir
                    299:    oxmath
                    300:    openxm sm1
                    301:
                    302: ***** OpenXM server programs:
                    303:    OpenXM/bin/ox_asir
                    304:    OpenXM/bin/ox_sm1
                    305:    OpenXM/bin/ox_math
                    306:    OpenXM/lib/sm1/bin/ox_sm1_gnuplot
                    307:    OpenXM/lib/sm1/bin/ox_sm1_phc
                    308:    OpenXM/lib/sm1/bin/ox_sm1_tigers
                    309:    OpenXM/lib/java-support/OMproxy.class
                    310:
1.8       takayama  311: ***** QUALITY:
1.25      takayama  312:  Experimental:
1.6       takayama  313:    OpenXM/bin/k0,  OpenXM/bin/d0
1.25      takayama  314:    Asir client functions:   m_* (Mathematica)  ,  om_*  (OpenMath)
1.29      takayama  315:    OpenXM/lib/java-support/ *
1.25      takayama  316:  70%
1.6       takayama  317:    OpenXM/bin/ox_math,  OpenXM/bin/math2ox
1.11      takayama  318:    OpenXM/bin/sm1, ox_sm1 on Linux libc6.
1.37    ! takayama  319:
        !           320: **** OpenXM server and client programs (under development)
        !           321:      included only in the source distribution
        !           322:    OpenXM/src/Macaulay2  ( M2 server and client )
        !           323:    OpenXM/src/ruby       ( Ruby client)
        !           324:
        !           325: **** Utilities
        !           326:    OpenXM/doc/oxlib    ( how to link oxservers as libraries )
        !           327:
1.6       takayama  328: */
                    329: /*&C
                    330:
                    331:
1.8       takayama  332: */
                    333: /*&jp
                    334: ★ Java に関する注意:
                    335: 注意 1.
                    336: OpenMath 用の OMproxy には現在のところ, jdk が必要です.
                    337: たとえば bash を利用している場合, .bashrc で
                    338: PATH=/usr/local/jdk1.1.8/bin:$PATH
                    339: export PATH
1.10      takayama  340: などとして, jdk の java, javac をサーチパスの先のほうへもっていくようにして
1.8       takayama  341: ください.
1.10      takayama  342: csh を利用している場合, .cshrc で
                    343: set path=(/usr/local/jdk1.1.8/bin $path)
                    344: として, jdk の java, javac をサーチパスにいれます.
1.17      takayama  345:
1.34      takayama  346: jdk の入手先:  FreeBSD  --- /usr/ports/java/jdk を見てください.
1.35      takayama  347:                Linux    --- http://java.sun.com/products/jdk/1.2/ja
                    348:                             http://java.sun.com/j2se/1.3/ja
1.33      takayama  349:
1.17      takayama  350: 注意:
                    351: なお, Kaffe 1.0.b4 の java は, class BigInteger に method
                    352: toByteArray が含まれてないため, OpenMath モジュールでは使用できません.
1.8       takayama  353: */
                    354: /*&eg
                    355: ***** JAVA
                    356: In order to use OMproxy, asir client om_*,
                    357: you need to install JDK.
                    358: The bin dir of the JDK must be in yur search path.
                    359: For example, you need to add the following line
1.10      takayama  360: to your .chsrc when your shell is csh
1.8       takayama  361: set path=(/usr/local/jdk1.1.8/bin $path)
1.10      takayama  362: Bash users put the following line to .bashrc
                    363: PATH=/usr/local/jdk1.1.8/bin:$PATH
                    364: export PATH
1.17      takayama  365:
1.33      takayama  366:
1.34      takayama  367: Where can I get jdk? :  FreeBSD --- see /usr/ports/java/jdk
1.35      takayama  368:                         Linux   --- http://java.sun.com/products/jdk/1.2/ja
                    369:                                     http://java.sun.com/j2se/1.3/ja
                    370:
1.33      takayama  371:
1.17      takayama  372: Remark:
                    373: The Java interpreter of Kaffe 1.0.b4 does not contain the method
                    374: toByteArray in the class BigInteger.
                    375: So, it cannot be used for the OpenMath module.
1.8       takayama  376: */
                    377:
                    378: /*&C
                    379:
                    380:
1.6       takayama  381:
                    382:
                    383: */
                    384: /*&jp
                    385: ★ 動作環境
                    386:
                    387: */
                    388: /*&eg
1.7       takayama  389: ***** SYSTEM REQUIREMENTS
1.6       takayama  390:
                    391: */
                    392: /*&C
                    393:
1.34      takayama  394: OS:  FreeBSD 3.3, 3.4, 4.x (Intel CPU),
1.11      takayama  395:      Linux systems (Intel CPU):
1.15      takayama  396:          Most Linux with libc5 and with libc6 (glibc 2.x).
1.7       takayama  397:
                    398:      X window system is required.
                    399:
                    400:      Most part of the OpenXM package may work on other versions of
1.11      takayama  401:      FreeBSD 3.x and Linux, but we have not yet tested.
1.6       takayama  402:
                    403: */
                    404: /*&jp
1.8       takayama  405: 次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを
1.6       takayama  406: 必要とします.
                    407: */
                    408: /*&eg
                    409: The following modules require the listed softwares other than the standard
                    410: OS package.
                    411: */
                    412: /*&C
                    413:
1.27      takayama  414: (1) OpenXM/bin/oxmath  :       Mathematica Version 3.x or 4.x
1.6       takayama  415:    (Mathematica server)         at /usr/local/Mathematica
                    416:     OpenXM/bin/math2ox          [ see http://www.wolfram.com ]
                    417:     Asir client functions  m_*
                    418: (2) OpenXM/lib/java-support :   JDK at /usr/local/jdk??
1.8       takayama  419:                                 [ see the section on JAVA]
1.6       takayama  420:     Asir client functions  om_*
                    421:     sm1 client functions   om_*
1.7       takayama  422: (3) PHC pack (OpenXM/bin/phc)  and  asir client functions
                    423:     phc_*  run only on linux (glib5).
1.8       takayama  424:     If you install the linux emulation^{note 1} on Free BSD, they run on
                    425:     FreeBSD, too.
                    426:     <note 1>
                    427:       Add linux_enable="YES" in /etc/rc.conf
                    428:       You need the following packages:
                    429:       pkg_info | grep linu
                    430:       linux_base-5.2      The base set of packages needed in Linux mode
                    431:       linux_devtools-5.2  Packages needed for doing development in Linux mode
1.6       takayama  432:
                    433: */
                    434:
                    435:
1.1       takayama  436: /*&jp
1.7       takayama  437: 日本語版の注意.
1.3       maekawa   438: 注意 1.
                    439: asir で日本語のヘルプを利用するには,
1.1       takayama  440: PAGER=jless
                    441: export PAGER
1.3       maekawa   442: などで, 日本語を扱える PAGER を指定する必要があるかもしれません.
1.1       takayama  443: */
1.7       takayama  444:
                    445: /*&eg
                    446:
1.8       takayama  447: The installation is completed.
1.7       takayama  448:
                    449: */
                    450: /*&jp
                    451:
                    452: 以上.
                    453:
                    454: */
                    455:
1.1       takayama  456: /*&jp
1.7       takayama  457: ★ 文書
                    458:
                    459:   OpenXM パッケージでもっとも充実しているクライアントは,
                    460:   asir です.
                    461:   asir のつかいかたは
                    462:         OpenXM/doc/asir2000/man-jp.dvi
                    463:        または OpenXM/doc/asir2000/html-jp の HTML ファイルを見て下さい.
                    464:   asir 用 OpenXM クライアントライブラリのつかい方は,
                    465:         OpenXM/doc/asir-contrib/cman-jp.dvi
                    466:   を見て下さい.  dvi の付くファイルは xdvi で見ることができます.
                    467:
                    468:   OpenXM の設計の概要については,
                    469:       OpenXM/doc/issac2000/issac2000.ps
                    470:   を見て下さい.
                    471:   ps の付くファイルは, ghostview で見ることができます.
                    472:
1.25      takayama  473:   Mathematica client については, OpenXM/doc/ox_math を御覧ください.
                    474:   sm1 client については, OpenXM/doc/kan96xx を御覧ください.
                    475:   asir は, 多項式処理用のライブラリとしてリンクできます.
                    476:   これについては, OpenXM/doc/oxlib を御覧ください.
                    477:
                    478:   OpenXM 対応の, サーバ を作成するには, OpenXM/src/ox_toolkit
                    479:   が参考になるかもしれません. Java のクラスについては
                    480:   OpenXM/src/OpenMath が参考になるかもしれません.
                    481:
1.7       takayama  482: */
                    483: /*&eg
                    484: ***** DOCUMENTS
                    485:
                    486:   The best OpenXM client in the OpenXM package is now
                    487:   asir.
                    488:   Documents on asir are
                    489:     OpenXM/doc/asir2000/man-eg.dvi
                    490:     OpenXM/doc/asir2000/html-eg (HTML)
                    491:
                    492:   The file
                    493:     OpenXM/doc/asir-contrib/cman-eg.dvi
                    494:   is a document on OpenXM client libraries for asir.
1.1       takayama  495:
1.7       takayama  496:   The design outline is described in
                    497:       OpenXM/doc/issac2000/issac2000.ps
                    498:
                    499:   Dvi files can be previewed by xdvi and
                    500:   ps files  can be previewed by ghostview.
1.25      takayama  501:
                    502:   As to Mathematica client, see OpenXM/doc/ox_math.
                    503:   As to sm1 client, see OpenXM/doc/kan96xx.
                    504:   The asir can be used as a C library for polynomial manupulation.
                    505:   See OpenXM/doc/oxlib.
                    506:
                    507:   If you are interested in writing a server for OpenXM, please refer to
                    508:   OpenXM/src/ox_toolkit and OpenXM/src/OpenMath.
                    509:
1.7       takayama  510: */
1.1       takayama  511:
                    512:
1.8       takayama  513: /*&eg
                    514:
                    515:
                    516: ***** A QUICK TOUR OF OPENXM BY ASIR
                    517:
                    518: */
1.7       takayama  519: /*&jp
1.1       takayama  520:
                    521:
1.8       takayama  522: ★ ASIR による使用例
1.1       takayama  523:
                    524:
1.3       maekawa   525: asir を動作させるには, key が必要です.
1.8       takayama  526: OpenXM/lib/asir/asir_key のコメントまたは起動時のメッセージをみて,
                    527: key を E-mail でとりよせて下さい.
1.1       takayama  528:
1.8       takayama  529: */
                    530: /*&C
                    531: ----------------   Call ox_sm1 from asir.
                    532: bash-2.03$ asir
                    533: This is Risa/Asir, Version 20000120.
                    534: Copyright (C) FUJITSU LABORATORIES LIMITED.
                    535: 1994-1999. All rights reserved.
                    536: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
                    537: [269] sm1_genericAnn([x^3-y^2,[s,x,y]]);
                    538:    /* The annihilating ideal of (x^3-y^2)^s */
                    539: [-2*y*dx-3*x^2*dy,2*x*dx+3*y*dy-6*s]
                    540:
                    541:
                    542: ---------------    Call gnuplot from asir.
                    543: bash-2.03$ asir
                    544: This is Risa/Asir, Version 20000120.
                    545: Copyright (C) FUJITSU LABORATORIES LIMITED.
                    546: 1994-1999. All rights reserved.
                    547: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
                    548: [269] gnuplot("plot sin(x);");
                    549: 0
                    550: [270]
1.13      takayama  551:
                    552: */
                    553:
                    554: /*&jp
                    555:
                    556: ★  sm1 クライアントの利用例
                    557:
                    558: */
                    559: /*&eg
                    560:
                    561: ******  Example of the use of sm1 client
1.1       takayama  562:
1.8       takayama  563: */
1.1       takayama  564:
1.8       takayama  565: /*&C
                    566: --------------------------------------  call ox_asir from sm1
1.1       takayama  567: sm1
                    568: (oxasir.sm1) run  ;
1.8       takayama  569: [(x^20-y^20) (x,y)] fctr pmat ;     factorize x^20-y^20 by call ox_asir
1.1       takayama  570:
                    571:
1.8       takayama  572: */
1.1       takayama  573:
1.8       takayama  574: /*&jp
1.5       takayama  575: [著作権表示]
                    576: OpenXM/Copyright を御覧ください.
1.6       takayama  577: */
1.8       takayama  578: /*&eg
                    579: [COPYRIGHT]
                    580: See OpenXM/Copyright.
                    581: */
                    582:
                    583: /*&eg
                    584:
1.6       takayama  585:
1.7       takayama  586:
1.8       takayama  587: *****  TO COMPILE FROM A SOURCE *****
1.7       takayama  588:
                    589: */
1.6       takayama  590: /*&jp
1.8       takayama  591:
                    592:
1.6       takayama  593: ★ OpenXM パッケージの Make 法
1.36      takayama  594:   FreeBSD 3.x, FreeBSD 4.x, Linux で動作するものと期待してます.
                    595:   (Linux glib6 では, いまのところ, /usr/include/features.h
                    596:    で #define __FAVOR_BSD 1 してコンパイルする必要がありしたが,
1.20      takayama  597:   一部のソースを
                    598:   -D_BSD_SOURCE option をつけて gcc でコンパイルするように変えてます
1.36      takayama  599:   (setjmp と sigsetjmp の問題, dirty trick) 現在では問題ありません. )
1.8       takayama  600:
1.6       takayama  601:    OpenXM, OpenXM_contrib, OpenXM_contrib2 が必要です.
1.36      takayama  602:    ftp.math.kobe-u.ac.jp/OpenXM/1.1.3 より
                    603:         openxm-1.1.3.tar.gz
                    604:    を get して展開して下さい.
                    605:         tar xzvf openxm-1.1.3.tar.gz
                    606:
                    607:    openxm-1.1.3/OpenXM    openxm-1.1.3/OpenXM_contrib
                    608:    openxm-1.1.3/OpenXM_contrib2
                    609:    が生成されます.
                    610:
1.6       takayama  611:    cvs コミッタの場合次のようにしてソースをとりよせます.
                    612: */
                    613: /*&eg
                    614: * How to make OpenXM package?
1.36      takayama  615:  We have tested the OpenXM package on FreeBSD 3.x, FreeBSD 4.x, Linux.
                    616:  (On Linux glib6, we needed to define
1.8       takayama  617:    #define  __FAVOR_BSD 1
1.20      takayama  618:  in /usr/include/features.h,
                    619:  but now we are compiling some sources with -D_BSD_SOURCE
1.36      takayama  620:  (setjmp vs sigsetjmp).  So, you do not need to make this change.)
1.8       takayama  621:
1.6       takayama  622:  Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?
1.36      takayama  623:  get
                    624:         openxm-1.1.3.tar.gz
                    625:  from ftp.math.kobe-u.ac.jp/OpenXM/1.1.3
                    626:  Expand it by
                    627:         tar xzvf openxm-1.1.3.tar.gz
                    628:
                    629:  Then, you will get
                    630:    openxm-1.1.3/OpenXM    openxm-1.1.3/OpenXM_contrib
                    631:    openxm-1.1.3/OpenXM_contrib2
                    632:
                    633:
1.6       takayama  634:  If you are a CVS committer, then you can get all sources as follows:
                    635: */
                    636: //&C  rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2
                    637: //&C
                    638: //&jp これらがそろっていたらあとは次のように入力するだけです.
                    639: //&eg Check that you have these directories, then just type in the following commands
                    640: /*&C
                    641:
                    642:    cd OpenXM/src
                    643:    make configure
                    644:    make
                    645:    make install
                    646:
                    647: */
                    648: /*&jp なお, OpenXM/src/ox_math のコンパイルおよび利用には Mathematica が,
                    649: OpenXM/src/OpenMath のコンパイルおよび利用には
                    650: には, jdk (java 環境) が必要です.
1.12      takayama  651:
                    652: Documents を生成するには,  tex, ptex (ascii 日本語 tex), dvips, texinfo,
1.36      takayama  653: texi2html, nkf, jlatex2html
1.12      takayama  654: が必要です. 詳しくは Makefiles を見て下さい.
                    655: Document は, binary distribution の OpenXM/doc, OpenXM/lib
                    656: より得るのが簡単です.
1.6       takayama  657: */
                    658: /*&eg In order to use and compile OpenXM/src/ox_math, you need Mathematica.
                    659: In order to use and compile OpenXM/src/OpenMath,
                    660: you need jdk (java environment).
1.12      takayama  661:
                    662: In order to generate the full documentation including Japanese documents,
                    663: you need tex, ptex (ASCII Inc. Japanese tex), dvips, texinfo, texi2html,
1.36      takayama  664: nkf, jlatex2html.  See each Makefile.
1.12      takayama  665: The generated documents are in OpenXM/doc and OpenXM/lib
                    666: in the binary distribution.
1.15      takayama  667: If you do not like to install Japanese environment such as ptex,
                    668: type in R for the tex error prompt ? or
                    669: prepare empty shell scripts ptex and nkf.
1.36      takayama  670: */
                    671: /*&C
                    672:
                    673: */
                    674:
                    675: /*&eg
                    676: To run the system, you need to read OpenXM/rc/dot.cshrc or
                    677: OpenXM/rc/dot.bashrc by the source
                    678: command for setting proper environmental variable values.
                    679:
                    680: By the commands
                    681:          cd OpenXM/rc
                    682:          make
                    683: you can generate dot.cshrc and dot.bashrc.
                    684: Read these file by the source command in your .cshrc
                    685: or .bashrc (or .bash_profile).
                    686: */
                    687: /*&jp
                    688: システムを動かすには, OpenXM/rc/dot.cshrc または
                    689: OpenXM/rc/dot.bashrc を source コマンドで
                    690: よみこみ環境変数の値を適切に設定する必要があります.
                    691:
                    692: コマンド
                    693:          cd OpenXM/rc
                    694:          make
                    695: で dot.cshrc および dot.bashrc が生成されます.
                    696: これらのファイルを source コマンドで,
                    697: .cshrc または .bashrc (または .bash_profile) より読むようにして下さい.
1.6       takayama  698: */
                    699: /*&C
1.1       takayama  700:
1.6       takayama  701: */
1.1       takayama  702:
1.6       takayama  703: /*&jp
1.1       takayama  704:
1.8       takayama  705: [OpenXM 下のファイルの構成メモ]
1.3       maekawa   706: lib/asir には, asir のライブラリ, ox_asir 本体
                    707:
1.8       takayama  708: cd OpenXM/src/kxx ; make install-for-debug した場合,
1.3       maekawa   709: lib/sm1 は src/SSkan/Doc への symbolic link
                    710: であり, sm1 のライブラリファイルが格納されています.
                    711: lib/sm1/bin には, binaryfiles
1.1       takayama  712:     sm1, ox_sm1, ox,  ox_log, ox_sm1_*
1.3       maekawa   713: へのシンボリックリンクが格納されます.
1.8       takayama  714: このシンボリックリンクは src/kxx で make install-for-debug を実行することにより
1.3       maekawa   715: 作成されます.
1.1       takayama  716:
1.3       maekawa   717: sm1 が ox_asir を利用するのに必要なファイル.
1.1       takayama  718:    lib/asir/ox_asir,
                    719:    lib/sm1/bin/ox, lib/sm1/bin/ox_log  (src/kxx/ox, src/kxx/ox_log)
                    720:    lib/sm1/ox.sm1, lib/sm1/oxasir.sm1
                    721:
1.3       maekawa   722: asir が ox_sm1_forAsir を利用するのに必要なファイル:
1.1       takayama  723:    lib/asir/ox_launch
1.3       maekawa   724:    lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク)
1.1       takayama  725:    lib/asir/xm
1.3       maekawa   726:    lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル.
1.1       takayama  727:      callsm1.sm1 callsm1b.sm1
1.3       maekawa   728:      (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c
                    729:       ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.)
1.1       takayama  730:
1.3       maekawa   731: asir が ox_sm1_gnuplot を利用するのに必要なファイル:
1.1       takayama  732:     lib/asir/ox_launch
1.3       maekawa   733:     lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して
1.4       maekawa   734:                                 gnuplot4ox を実行します.)
1.1       takayama  735:     lib/asir/xm
                    736:     lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1
1.3       maekawa   737:      (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c
                    738:       ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.)
1.4       maekawa   739:     bin/gnuplot4ox,  bin/gnuplot_x11  (gnuplot 本体, src/gnuplot*)
1.1       takayama  740:
                    741: ----------------------------------------
1.3       maekawa   742: [開発者用メモ]
1.1       takayama  743:
1.3       maekawa   744: << sm1, ox_sm1, ox, oxlog の debug >>
                    745: binary file は各 directory の make install により
                    746: OpenXM/bin にコピーされますが,
                    747: debug 用にいちいちコピーするのは面倒なので,
1.8       takayama  748: OpenXM/src/kan96xx で make install-for-debug
                    749: OpenXM/src/kxx で make install-for-debug
1.3       maekawa   750: を実行すると,
                    751: OpenXM/bin/sm1, ox, ox_sm1, oxlog より,
1.1       takayama  752: OpenXM/src/kan96xx/Kan/sm1
                    753: OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
1.3       maekawa   754: へのシンボリックリンクが作成されます.
1.1       takayama  755:
1.3       maekawa   756: [CVSコミッタ用メモ]
                    757: <<  OpenXM ディレクトリ配布版の作成方法 >>
1.1       takayama  758: rcvs export -rHEAD OpenXM
                    759: rcvs export -rHEAD OpenXM_contrib
                    760: rcvs export -rHEAD OpenXM_contrib2
1.21      takayama  761: cd OpenXM/src ; make generate-source-distribution
1.3       maekawa   762: して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip.
1.7       takayama  763: */
                    764:
                    765: /*&C
                    766:
                    767: */
                    768: /*&jp
                    769:
                    770: ★ Solaris に関する注意.
                    771: Solaris ではまだ問題が山積してます.
                    772: Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt
                    773: を見てください.
1.8       takayama  774: Solaris でコンパイルするには, /usr/ccs/bin をサーチパスの最初へもっていって
                    775: おきます.
1.7       takayama  776:
                    777: */
1.8       takayama  778: /*&eg
                    779: ***** COMPILE ON SOLARIS
                    780:  There are a lot of troubles on Solaris for now.
                    781:  At least,
                    782:  /usr/ccs/bin must be at the top of the command search path to compile
                    783:  on Solaris.
                    784: */
1.31      takayama  785: /*&jp
                    786:
                    787: ★ Redhat Linux 6.1 上でのコンパイル
                    788: m4-1.4 と autoconf-2.13 が必要.
                    789: (あらかじめはいっている,  autoconf は 2.12 でありこれは
                    790:  gnuplot の make で不具合を生じます.)
1.8       takayama  791:
1.31      takayama  792: */
                    793: /*&eg
                    794: ***** COMPILE ON Redhat Linux 6.1
                    795: m4-1.4 and autoconf-2.13 are required.
                    796: (Preinstalled autoconf is version 2.12. It causes a trouble when
                    797:  you build gnuplot.)
                    798: */
1.7       takayama  799:
                    800: /*&C
                    801:
1.1       takayama  802: */

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