[BACK]Return to risa.texi CVS log [TXT][DIR] Up to [local] / OpenXM / src / asir-doc / parts

Diff for /OpenXM/src/asir-doc/parts/risa.texi between version 1.9 and 1.13

version 1.9, 2000/08/23 04:29:12 version 1.13, 2005/03/24 23:40:50
Line 1 
Line 1 
 @comment $OpenXM: OpenXM/src/asir-doc/parts/risa.texi,v 1.8 2000/01/26 01:37:32 noro Exp $  @comment $OpenXM: OpenXM/src/asir-doc/parts/risa.texi,v 1.12 2003/10/19 04:57:00 ohara Exp $
 @node Risa/Asir,,, Top  @node Risa/Asir,,, Top
 @chapter Risa/Asir  @chapter Risa/Asir
   
Line 78  language interface of @b{Risa}.
Line 78  language interface of @b{Risa}.
 @*  @*
 \BJP  \BJP
 @b{Risa} $B$G$O(B, $B%a%b%j4IM}It$H$7$F(B, @code{[Boehm,Weiser]} $B$K$h$k%U%j!<(B  @b{Risa} $B$G$O(B, $B%a%b%j4IM}It$H$7$F(B, @code{[Boehm,Weiser]} $B$K$h$k%U%j!<(B
 $B%=%U%H%&%'%"(B (@code{gc-5.0alpha2}) $B$rMQ$$$F$$$k(B. $B$3$l$O%,!<%Y%8%3%l%/%7%g%s(B  $B%=%U%H%&%'%"(B (@code{gc-6.1alpha5}) $B$rMQ$$$F$$$k(B. $B$3$l$O%,!<%Y%8%3%l%/%7%g%s(B
 ($B0J2<(B GC $B$H8F$V(B) $B$r<+F0E*$K9T$&%a%b%j3d$jEv$F5!9=$r;}$A(B, @b{Risa} $B$N3F(B  ($B0J2<(B GC $B$H8F$V(B) $B$r<+F0E*$K9T$&%a%b%j3d$jEv$F5!9=$r;}$A(B, @b{Risa} $B$N3F(B
 $BItJ,$O$9$Y$F$3$l$K$h$jI,MW$J%a%b%j$rF@$F$$$k(B.  $BItJ,$O$9$Y$F$3$l$K$h$jI,MW$J%a%b%j$rF@$F$$$k(B.
 \E  \E
 \BEG  \BEG
 @b{Risa} employs, as its memory management component (the memory  @b{Risa} employs, as its memory management component (the memory
 manager), a free software distributed by Boehm (@code{gc-5.0alpha2}).  manager), a free software distributed by Boehm (@code{gc-6.1alpha5}).
 It is proposed by @code{[Boehm,Weiser]}, and developed by Boehm and  It is proposed by @code{[Boehm,Weiser]}, and developed by Boehm and
 his colleagues.  his colleagues.
 The memory manager has a memory allocator which automatically  The memory manager has a memory allocator which automatically
Line 219  to the following address.
Line 219  to the following address.
 \E  \E
   
 @example  @example
 risa-admin@@sec.flab.fujitsu.co.jp  noro@@math.kobe-u.ac.jp
 @end example  @end example
   
 @noindent  @noindent
Line 314  Copyright (C) FUJITSU LABORATORIES LIMITED.
Line 314  Copyright (C) FUJITSU LABORATORIES LIMITED.
 @subsection UNIX source code version  @subsection UNIX source code version
   
 \BEG  \BEG
 First of all you have to install PARI library. The following is  First of all you have to determine the install directory.
 a sample of installation of PARI on FreeBSD.  In the install directory, the following subdirectories are put:
 \E  \E
   
 \BJP  \BJP
 $B$^$:(B PARI $B%i%$%V%i%j$r(B install $B$9$kI,MW$,$"$k(B. $B0J2<$O(B FreeBSD $B>e$G$N(B  $B$^$:(B, $B%$%s%9%H!<%k@h$N%G%#%l%/%H%j$r7h$a$kI,MW$,$"$k(B.
 PARI $B$N(B installation $B$NNc$G$"$k(B.  $B$3$3$K$O(B, $B0J2<$N%5%V%G%#%l%/%H%j$,CV$+$l$k(B.
 \E  \E
   
   @itemize @bullet
   @item bin
   
   \EG executables of PARI and Asir
   \JP PARI $B$*$h$S(B Asir $B$N<B9T2DG=%U%!%$%k(B
   
   @item lib
   
   \EG library files of PARI and Asir
   \JP PARI $B$*$h$S(B Asir $B$N%i%$%V%i%j(B
   @item include
   
   \EG header files of PARI
   \JP PARI $B$N%X%C%@%U%!%$%k(B
   @end itemize
   
   \BEG
   These subdirectories are created automatically if they does not exist.
   If you can be a root, it is recommended to set the install directory
   to @samp{/usr/local}.  In the following the directory is denoted by TARGETDIR.
   \E
   \BJP
   $B$3$l$i$N%5%V%G%#%l%/%H%j$OL5$1$l$P<+F0E*$K:n$i$l$k(B.
   root $B8"8B$,$"$k>l9g$K$O(B, @samp{/usr/local} $B$K%$%s%9%H!<%k$9$k$3$H$r(B
   $B$*4+$a$9$k(B. $B0J2<(B, $B$3$N%G%#%l%/%H%j$r(B TARGETDIR $B$H=q$/(B.
   \E
   
   \BEG
   Then, install PARI library. After getting @samp{pari.tgz},
   unpack and install it as follows:
   \E
   \BJP
   $B$^$:(B PARI $B%i%$%V%i%j$r%$%s%9%H!<%k$9$kI,MW$,$"$k(B.
   @samp{pari.tgz} $B$rF~<j8e(B, $BE,Ev$J%G%#%l%/%H%j$GE83+(B, $B%$%s%9%H!<%k$9$k(B.
   \E
   
 @example  @example
 % su  % gzip -dc pari.tgz | tar xvf -
 # gzip -dc pari-2.0.17.beta.tgz | tar xf -  % cd pari
 # cd pari-2.0.17.beta  % ./Configure --prefix=TARGETDIR
 # ./Configure  % make all
   % su
 # make install  # make install
 # make install-lib-sta  # make install-lib-sta
 @end example  @end example
   
 \BJP  \BJP
 @samp{asir2000-src.tgz} $B$rF~<j8e(B, $BE,Ev$J%G%#%l%/%H%j(B  make $BCf$K%(%i!<$G;_$^$C$?$i(B, $B0J2<$r<B9T$9$k(B.
 $B$K$*$$$F(B, @code{gzip} $B$GE83+$7(B, $B0J2<$N<j=g$G(B install $B$9$k(B.  
 \E  \E
   
 \BEG  \BEG
 After getting @samp{asir2000-src.tgz}, unpack it by @code{gzip}  While executing 'make install', the procedure may stop due to
   some error. Then try the following:
   \E
   
   @example
   % cd Oxxx
   % make lib-sta
   % su
   # make install-lib-sta
   # make install-include
   # exit
   %
   @end example
   
   \BEG
   In the above example, xxx denotes the name of the target operating system.
   Although GP is not built, the library necessary for building asir2000
   will be generated.
   
   After getting @samp{asir2000.tgz}, unpack it
 and install necessary files as follows.  and install necessary files as follows.
 \E  \E
   
   \BJP
   $B>e$NNc$G(B, xxx $B$O8=:_%?!<%2%C%H$H$J$C$F$$$k(B OS $B$NL>A0$r<($9(B.
   GP $B$O%$%s%9%H!<%k$5$l$J$$$,(B, asir2000 $B$N:n@.$KI,MW$J%U%!%$%k$O%$%s%9%H!<%k(B
   $B$5$l$k(B.
   
   @samp{asir2000.tgz} $B$rF~<j8e(B, $BE,Ev$J%G%#%l%/%H%j$G(B
   $B$GE83+$7(B, $B0J2<$N<j=g$G%$%s%9%H!<%k$9$k(B.
   \E
   
 @example  @example
 % gzip -dc asir.tgz | tar xf -  % gzip -dc asir.tgz | tar xf -
 % cd asir2000  % cd asir2000
 % ./configure -oxhome /usr/local -pari -plot  % ./configure --prefix=TARGETDIR --with-pari --enable-plot
 % xmkmf -a  
 % make  % make
 % su  % su
 # make install  # make install
 # make install-lib  # make install-lib
 # make install-doc  # make install-doc
   # exit
 @end example  @end example
   
 \BJP  
 $B>e$NNc$G(B, @samp{/usr/local} $B$O%U%!%$%k$,(B install $B$5$l$k%G%#%l%/%H%j$r(B  
 $BI=$9(B. $BB($A(B, $B%P%$%J%j%U%!%$%k(B @samp{asir} $B$O(B @samp{/usr/local/bin}  
 $B$K(B install $B$5$l(B, $B%i%$%V%i%j$*$h$SJ8=q%U%!%$%k$O(B @samp{/usr/local/lib}  
 $B$K(B install $B$5$l$k(B. @code{-oxhome} $B$N0z?t$H$7$F;XDj$5$l$k%G%#%l%/%H%j(B  
 $B$O(B, PARI $B$N(B install $B@h$b$=$3$G$"$k$3$H$r0UL#$9$k(B. $B$b$7(B @b{Asir} $B$,(B  
 install $B$5$l$k%G%#%l%/%H%j$rJQ99$9$k>l9g(B, @samp{include/Risa.tmpl}  
 $B$N(B, $BJQ?t(B @code{PARIINC} $B$*$h$S(B @code{PARILIB} $B$NCM$rE,59JQ99$9$k(B  
 $BI,MW$,$"$k(B.  
 \E  
 \BEG  
 In the above example, @samp{/usr/local} indicates the destination of the  
 installation. That is, the binary file @samp{asir} is installed in  
 @samp{/usr/local/bin} and the library and documentation files are  
 installed in @samp{/usr/local/lib}. The directory name specified as an  
 argument of @code{-oxhome} also indicates that PARI files are installed  
 in that directory.  If you change the destination directory, you have to  
 modify the values of @code{PARIINC} and @code{PARILIB} in  
 @samp{include/Risa.tmpl} appropriately.  
 \E  
   
 @node Windows version,,, Installation  @node Windows version,,, Installation
 @subsection Windows version  @subsection Windows version
   
 @noindent  @noindent
 \BJP  \BJP
 $BI,MW$J%U%!%$%k$O(B @samp{asirwin.tgz} $B$G$"$k(B. $BB>$K(B, @samp{gzip.exe},  $BI,MW$J%U%!%$%k$O(B @samp{asirwin-ja.tgz} $B$G$"$k(B. $BB>$K(B, @samp{gzip.exe},
 @samp{tar.exe} $B$,I,MW$@$,(B, asirwin.tgz $B$HF1$8%G%#%l%/%H%j$KMQ0U$7$F(B  @samp{tar.exe} $B$,I,MW$@$,(B, @samp{asirwin-ja.tgz} $B$HF1$8%G%#%l%/%H%j$KMQ0U$7$F(B
 $B$"$k(B. $B$3$l$i(B 3 $B$D$N%U%!%$%k$rF10l%G%#%l%/%H%j$K$*$-(B, DOS $B%W%m%s%W%H(B  $B$"$k(B. $B$3$l$i(B 3 $B$D$N%U%!%$%k$rF10l%G%#%l%/%H%j$K$*$-(B, $B%3%^%s%I%W%m%s%W%H(B
   (DOS $B%W%m%s%W%H(B)
 $B$+$i(B  $B$+$i(B
 \E  \E
 \BEG  \BEG
 The necessary file is @samp{asirwin.tgz}. To unpack it @samp{gzip.exe}  The necessary file is @samp{asirwin-en.tgz}. To unpack it @samp{gzip.exe}
 and @samp{tar.exe} are necessary. They are in the same  and @samp{tar.exe} are necessary. They are in the same
 directory as @samp{asirwin.tgz} on the ftp server.  directory as @samp{asirwin-en.tgz} on the ftp server.
 Putting them in the same directory, execute the following:  Putting them in the same directory, execute the following:
 \E  \E
   
Line 398  Putting them in the same directory, execute the follow
Line 444  Putting them in the same directory, execute the follow
 @noindent  @noindent
 \BJP  \BJP
 $B$r<B9T$9$l$P(B, @samp{Asir} $B$H$$$&%G%#%l%/%H%j(B (Asir $B%k!<%H%G%#%l%/%H%j(B)  $B$r<B9T$9$l$P(B, @samp{Asir} $B$H$$$&%G%#%l%/%H%j(B (Asir $B%k!<%H%G%#%l%/%H%j(B)
 $B$,$G$-$k(B. 990831 $BHG$G$O(B, GUI $B$HK\BN$,J,N%$5$l(B, $B$^$?%G%P%C%0%&%#%s%I%&$b(B  $B$,$G$-$k(B.
 $BJL%W%m%;%9$H$7$F(B GUI $B$,8F$S=P$5$l$k$?$a(B, Asir $B%k!<%H%G%#%l%/%H%j$,@5$7$/(B  @comment 990831 $BHG$G$O(B, GUI $B$HK\BN$,J,N%$5$l(B, $B$^$?%G%P%C%0%&%#%s%I%&$b(B
 $BEPO?$5$l$F$$$k$3$H$,I,MW$G$"$k(B.  Asir $B%k!<%H%G%#%l%/%H%j$N%5%V%G%#%l%/%H(B  @comment $BJL%W%m%;%9$H$7$F(B GUI $B$,8F$S=P$5$l$k$?$a(B, Asir $B%k!<%H%G%#%l%/%H%j$,@5$7$/(B
 $B%j(B @samp{bin} $B$K(B @samp{asirgui.exe} (GUI), @samp{engine.exe} ($BK\BN(B) $B$,(B  @comment $BEPO?$5$l$F$$$k$3$H$,I,MW$G$"$k(B.
 $BCV$+$l$F$$$k(B. @samp{asirgui.exe} $B$N=i2s$NN)$A>e$2$O(B, $B%(%/%9%W%m!<%i$+$i9T(B  Asir $B%k!<%H%G%#%l%/%H%j$N%5%V%G%#%l%/%H(B
 $B$&(B. $B$3$l$K$h$j(B  @samp{bin} $B$K(B @samp{asirgui.exe} (GUI), @samp{engine.exe} ($BK\BN(B) $B$,(B
   $BCV$+$l$F$$$k(B.
   @samp{asirgui.exe} $B$r%@%V%k%/%j%C%/$9$l$P(B Asir $B$,N)$A>e$,$k(B.
   @comment @samp{asirgui.exe} $B$N=i2s$NN)$A>e$2$O(B, $B%(%/%9%W%m!<%i$+$i9T(B
   @comment $B$&(B. $B$3$l$K$h$j(B
 \E  \E
   
 \BEG  \BEG
 Then a directory @samp{Asir} (@b{Asir root directory}) is created,  Then a directory @samp{Asir} (@b{Asir root directory}) is created,
 which has subdirectories named @samp{bin} and @samp{lib}. To set up it,  which has subdirectories named @samp{bin} and @samp{lib}.
 invoke @samp{bin\asirgui.exe} from Explorer and  Asir can be invoked by double-clicking @samp{asirgui.exe}.
 click @code{OK}.  Then the name of @b{Asir root directory} is set to the  @comment To set up it,
 following registries.  @comment invoke @samp{bin\asirgui.exe} from Explorer and
   @comment click @code{OK}.  Then the name of @b{Asir root directory} is set to the
   @comment following registries.
 \E  \E
   
 @example  @comment @example
 \JP HKEY_LOCAL_MACHINE\SOFTWARE\FUJITSU\Asir\99.03.31\Directory  @comment \JP HKEY_LOCAL_MACHINE\SOFTWARE\FUJITSU\Asir\99.03.31\Directory
 \EG HKEY_LOCAL_MACHINE\SOFTWARE\FUJITSU\Asir\99.03.31\Directory  @comment \EG HKEY_LOCAL_MACHINE\SOFTWARE\FUJITSU\Asir\99.03.31\Directory
 @end example  @comment @end example
   
 @noindent  @comment @noindent
 \JP $B$H$$$&%l%8%9%H%j$K(B Asir $B%k!<%H%G%#%l%/%H%j$,@5$7$/EPO?$5$l$k(B.  @comment \JP $B$H$$$&%l%8%9%H%j$K(B Asir $B%k!<%H%G%#%l%/%H%j$,@5$7$/EPO?$5$l$k(B.
   
 \BJP  \BJP
 @node $B%3%^%s%I%i%$%s%*%W%7%g%s(B,,, Risa/Asir  @node $B%3%^%s%I%i%$%s%*%W%7%g%s(B,,, Risa/Asir
Line 480  When this option is specified, @b{Asir} does not read 
Line 532  When this option is specified, @b{Asir} does not read 
 initial file @samp{$HOME/.asirrc}.  initial file @samp{$HOME/.asirrc}.
 \E  \E
   
   @item -quiet
   \JP $B5/F0;~$NCx:n8"I=<($r9T$o$J$$(B.
   \BEG Be quiet at boot time.
   \E
   
 @item -f @var{file}  @item -f @var{file}
 \BJP  \BJP
 $BI8=`F~NO$NBe$o$j$K(B, @var{file} $B$+$iF~NO$rFI$_9~$s$G<B9T$9$k(B.  $BI8=`F~NO$NBe$o$j$K(B, @var{file} $B$+$iF~NO$rFI$_9~$s$G<B9T$9$k(B.
Line 540  Note that the setting takes effect after rebooting the
Line 597  Note that the setting takes effect after rebooting the
 \E  \E
 @itemize @bullet  @itemize @bullet
 @item  @item
 @code{ASIR_KEY}  
 @*  
 \BJP  
 UNIX $BHG$G$O(B, @b{Asir} $B$,5/F0$5$l$?%^%7%s$KBP$9$k(B @code{key} $B$,$J$1(B  
 $B$l$P$=$N%^%7%s>e$G(B @b{Asir} $B$OF0:n$7$J$$(B. @code{key} $B$O(B 16 $B?J(B 8  
 $B7e(B 3 $B%o!<%I$+$i$J$j(B,  
 \E  
 \BEG  
 @b{Asir} shall not work unless a @code{key} for the machine  
 on which @b{Asir} is invoked is given.  
 The @code{key} consists of a string which denotes 3 word hexadecimal  
 number, each of which has 8 hexadecimal digits.  
 In order to run @b{Asir} for several machines,  
 several @code{key}'s can be written together on a same file as follows.  
 \E  
 @example  
 % cat asir_key  
 cf6f236c 61a35091 dddc4529 geisha  
 82281685 d1929945 a8bd24ca yorktown  
 34b75d30 63f8df93 3e881113 nyanchu  
 @end example  
   
 \BJP  
 $B$H$$$&7A$GJ#?tBf$N%^%7%s$KBP$9$k(B @code{key} $B$r0l$D$N%U%!%$%k$K$^$H$a$F(B  
 $B=q$/$3$H$,$G$-$k(B. @code{key} $B$N8e$m$OL5;k$5$l$k$N$G(B, $B%3%a%s%H$r=q$/(B  
 $B$3$H$,$G$-$k(B. @code{key} $B$r4^$`%U%!%$%k$O(B, $B0J2<$N=g$G%5!<%A$5$l$k(B.  
 \E  
 \BEG  
 The text after each @code{key} is neglected to the end-of-line.  
 This is convenient to comment on the respective @code{key}.  
 Files containing @code{key}'s are searched by the following order.  
 \E  
   
 @enumerate  
 @item  
 \JP $B4D6-JQ?t(B @code{ASIR_KEY} $B$K;XDj$5$l$?%U%!%$%k(B  
 \EG File set to environment @code{ASIR_KEY}  
   
 @item  
 \JP $B%+%l%s%H%G%#%l%/%H%j$N(B @samp{asir_key}  
 \EG File @samp{asir_key} on the current directory.  
   
 @item  
 \BJP  
 $B4D6-JQ?t(B @code{ASIR_LIBDIR} $B$G;XDj$5$l$?%G%#%l%/%H%j(B ($B;XDj$,$J$1$l$P(B  
 @samp{/usr/local/lib/asir}) $B$N(B @samp{asir_key}  
 \E  
 \BEG  
 Files on the directory specified by environment @code{ASIR_LIBDIR}.  
 (File @samp{asir_key} on @samp{/usr/local/lib/asir/},  
 if environment @code{ASIR_LIBDIR} is not set.)  
 \E  
   
 @end enumerate  
   
 @item  
 @code{ASIR_LIBDIR}  @code{ASIR_LIBDIR}
 @*  @*
 \BJP  \BJP
Line 612  On Windows, @samp{lib} in @b{Asir root directory} is u
Line 613  On Windows, @samp{lib} in @b{Asir root directory} is u
 This environment will be useful in a case where @b{Asir} binaries  This environment will be useful in a case where @b{Asir} binaries
 are installed on a private directory of the user.  are installed on a private directory of the user.
 \E  \E
   @item
   @code{ASIR_CONTRIB_DIR}
   @*
   \BJP
   @b{Asir} $B$N(B asir-contrib $B%G%#%l%/%H%j(B, $B$9$J$o$A(B OpenXM/asir-contrib
   $B%W%m%8%'%/%H$G=q$+$l$?%Q%C%1!<%8$d%G!<%?$J$I$,$*$+$l$k%G%#%l%/%H%j(B.
   $B;XDj$,$J$$>l9g(B UNIX $BHG$G$O(B
   @samp{/usr/local/lib/asir-contrib},
   Windows $BHG$G$O(B Asir $B%a%$%s%G%#%l%/%H%j$N2<$N(B @samp{lib-asir-contrib}
   $B%G%#%l%/%H%j$,MQ$$$i$l$k(B.
   \E
   \BEG
   The asir-contrib library directory of @b{Asir}, i.e., the directory where
   packages and data developed by the OpenXM/asir-contrib project files are put.
   If not specified, on UNIX, @samp{/usr/local/lib/asir-contrib}
   is used by default.
   On Windows, @samp{lib-asir-contrib} in @b{Asir root directory}
   is used by default.
   This environment will be useful in a case where @b{Asir} binaries
   are installed on a private directory of the user.
   \E
   
 @item  @item
 @code{ASIRLOADPATH}  @code{ASIRLOADPATH}
Line 767  value of the function.
Line 789  value of the function.
 @noindent  @noindent
 \BJP  \BJP
 $B7W;;$r<B9TCf$K3d$j9~$_$r$+$1$?$$>l9g(B, $B3d$j9~$_%-%c%i%/%?(B($BDL>o$O(B  $B7W;;$r<B9TCf$K3d$j9~$_$r$+$1$?$$>l9g(B, $B3d$j9~$_%-%c%i%/%?(B($BDL>o$O(B
 @kbd{C-c}, DOS $BHG$G$O(B @kbd{C-x}, Mac $BHG$G$O(B  @kbd{C-c}, Windows, DOS $BHG$G$O(B @kbd{C-x} $B$rF~NO$9$k(B.
 @code{command+}@samp{.} ) $B$rF~NO$9$k(B.  
 \E  \E
 \BEG  \BEG
 To interrupt the @b{Asir} execution, input an interrupt character  To interrupt the @b{Asir} execution, input an interrupt character
 from the keyboard.  A @kbd{C-c} is usually used for it.  from the keyboard.  A @kbd{C-c} is usually used for it.
 (Notice: @kbd{C-x} for DOS version; @code{command+}@samp{.} for Macintosh  (Notice: @kbd{C-x} on Windows and DOS.)
 version.)  
 \E  \E
   
 @example  @example
Legend:
Removed from v.1.9  
changed lines
  Added in v.1.13
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>