[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.6 and 1.15

version 1.6, 2000/01/20 03:00:34 version 1.15, 2014/12/14 00:53:08
Line 1 
Line 1 
 @comment $OpenXM: OpenXM/src/asir-doc/parts/risa.texi,v 1.5 2000/01/20 01:44:33 noro Exp $  @comment $OpenXM: OpenXM/src/asir-doc/parts/risa.texi,v 1.14 2005/03/30 10:53:28 takayama Exp $
 @node Risa/Asir,,, Top  @node Risa/Asir,,, Top
 @chapter Risa/Asir  @chapter Risa/Asir
   
Line 6 
Line 6 
 \BJP  \BJP
 * Risa $B$*$h$S(B Asir::  * Risa $B$*$h$S(B Asir::
 * Asir $B$NFCD'(B::  * Asir $B$NFCD'(B::
 * $B%$%s%9%H%l!<%7%g%s(B::  * Installation::
 * $B%3%^%s%I%i%$%s%*%W%7%g%s(B::  * $B%3%^%s%I%i%$%s%*%W%7%g%s(B::
 * $B4D6-JQ?t(B::  * $B4D6-JQ?t(B::
 * $B5/F0$+$i=*N;$^$G(B::  * $B5/F0$+$i=*N;$^$G(B::
Line 51  The structure of @b{Risa} is as follows.
Line 51  The structure of @b{Risa} is as follows.
 @item  @item
 \JP @code{$B4pK\1i;;It(B}  \JP @code{$B4pK\1i;;It(B}
 \EG @b{The basic algebraic engine}  \EG @b{The basic algebraic engine}
   @*
 \BJP  \BJP
 $B$3$l$O(B, @b{Risa} $B$NFbIt7A<0$KJQ49$5$l$?%*%V%8%'%/%H(B ($B?t(B, $BB?9`<0$J$I(B)  $B$3$l$O(B, @b{Risa} $B$NFbIt7A<0$KJQ49$5$l$?%*%V%8%'%/%H(B ($B?t(B, $BB?9`<0$J$I(B)
 $B$N4V$N1i;;$r<B9T$9$kItJ,$G$"$j(B, UNIX $B$N(B @samp{libc.a} $B$J$I$HF1MM$N(B, $B%i%$%V%i(B  $B$N4V$N1i;;$r<B9T$9$kItJ,$G$"$j(B, UNIX $B$N(B @samp{libc.a} $B$J$I$HF1MM$N(B, $B%i%$%V%i(B
Line 75  language interface of @b{Risa}.
Line 75  language interface of @b{Risa}.
 @item  @item
 \JP @code{$B%a%b%j4IM}It(B}  \JP @code{$B%a%b%j4IM}It(B}
 \EG @b{Memory Manager}  \EG @b{Memory Manager}
   @*
 \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 96  manager.
Line 96  manager.
   
 @item  @item
 @b{Asir}  @b{Asir}
   @*
 \BJP  \BJP
 @b{Asir} $B$O(B, @b{Risa} $B$N7W;;%(%s%8%s$N8@8l%$%s%?%U%'!<%9$G(B  @b{Asir} $B$O(B, @b{Risa} $B$N7W;;%(%s%8%s$N8@8l%$%s%?%U%'!<%9$G(B
 $B$"$k(B. @b{Risa} $B$G$O(B, $BHf3SE*MF0W$K%f!<%6MQ$N8@8l%$%s%?%U%'!<%9$r:n$k(B  $B$"$k(B. @b{Risa} $B$G$O(B, $BHf3SE*MF0W$K%f!<%6MQ$N8@8l%$%s%?%U%'!<%9$r:n$k(B
Line 209  Distributed computation over UNIX
Line 209  Distributed computation over UNIX
 \E  \E
 @end itemize  @end itemize
   
 \BJP  
 @node $B%$%s%9%H%l!<%7%g%s(B,,, Risa/Asir  
 @section $B%$%s%9%H%l!<%7%g%s(B  
 \E  
 \BEG  
 @node Installation,,, Risa/Asir  @node Installation,,, Risa/Asir
 @section Installation  @section Installation
 \E  
   
 \JP $B0J2<$N<jB3$-$GITL@$JE@(B, $BITET9g$JE@$,$"$C$?>l9g$NLd$$9g$o$;$O(B  \JP $B0J2<$N<jB3$-$GITL@$JE@(B, $BITET9g$JE@$,$"$C$?>l9g$NLd$$9g$o$;$O(B
 \BEG  \BEG
 Any questions and any comments on this manual are well come by e-mails  Any questions and any comments on this manual are welcome by e-mails
 to the following address.  to the following address.
 \E  \E
   
 @example  @example
 noryo@@flab.fujitsu.co.jp  noro@@math.kobe-u.ac.jp
 @end example  @end example
   
 @noindent  @noindent
 \JP $B08$K(B e-mail $B$G$*4j$$$7$^$9(B.  \JP $B08$K(B e-mail $B$G$*4j$$$7$^$9(B.
   
 @menu  @menu
 \BJP  * UNIX binary version::
 * UNIX $BHG(B::  * UNIX source code version::
 * Windows $BHG(B::  
 \E  
 \BEG  
 * UNIX version::  
 * Windows version::  * Windows version::
 \E  
 @end menu  @end menu
   
 \BJP  @node UNIX binary version,,, Installation
 @node UNIX $BHG(B,,, $B%$%s%9%H%l!<%7%g%s(B  @subsection UNIX binary version
 @subsection UNIX $BHG(B  
 \E  
 \BEG  
 @node UNIX version,,, Installation  
 @subsection UNIX version  
 \E  
   
 @noindent  @noindent
 \BJP  \BJP
 $BI,MW$J%U%!%$%k$O(B @samp{asir.tgz} $B$G$"$k(B.  $B%?!<%2%C%H(B CPU/OS $B$KBP1~$9$k(B @samp{asir.tgz} $B$,I,MW$G$"$k(B.
 $B$3$l$i$OA4$F(B @code{gzip} $B$G05=L$7$F$"$k$N$G(B, $BF~<j8e(B @code{gzip} $B$G(B  $B$3$l$i$OA4$F(B @code{gzip} $B$G05=L$7$F$"$k$N$G(B, $BF~<j8e(B @code{gzip} $B$G(B
 $BE83+$9$k(B. $B$^$:(B, $B%$%s%9%H!<%k$9$k%G%#%l%/%H%j$r7h$a$k(B. $B%G%U%)%k%H$G$O(B  $BE83+$9$k(B. $B$^$:(B, $B%$%s%9%H!<%k$9$k%G%#%l%/%H%j$r7h$a$k(B. $B%G%U%)%k%H$G$O(B
 @samp{/usr/local/lib} $B$K(B @samp{asir} $B$H$$$&%G%#%l%/%H%j$H$7$F(B  @samp{/usr/local/lib} $B$K(B @samp{asir} $B$H$$$&%G%#%l%/%H%j$H$7$F(B
Line 261 flab.fujitsu.co.jp
Line 244 flab.fujitsu.co.jp
 $B%G%#%l%/%H%j$H8F$V(B.  $B%G%#%l%/%H%j$H8F$V(B.
 \E  \E
 \BEG  \BEG
 A file @samp{asir.tgz} suitable for the taget machine/architecture  A file @samp{asir.tgz} suitable for the target machine/architecture
 is required. After getting it,  is required. After getting it,
 you have to unpack it by @code{gzip}. First of all, determine  you have to unpack it by @code{gzip}. First of all, determine
 a derectory where binaries and library files are installed.  a derectory where binaries and library files are installed.
Line 314  the user's search path.
Line 297  the user's search path.
 @end example  @end example
   
 @noindent  @noindent
 \JP $B$3$N>uBV$G(B @samp{asir} $B$r5/F0$7$F$_$k(B.  \JP $B$3$l$G(B @samp{asir} $B$,5/F0$G$-$k(B.
 \BEG  \BEG
 Start @samp{asir}, and @b{Asir} will immediately terminate leaving you  Then you can start @samp{asir}.
 a message as follows.  
 \E  \E
   
 @example  @example
 % /usr/local/bin/asir  % /usr/local/bin/asir
 asir_key not found.  This is Risa/Asir, Version 20000821.
   Copyright (C) FUJITSU LABORATORIES LIMITED.
   1994-2000. All rights reserved.
   [0]
   @end example
   
 You need a key for each machine on which you want to run Asir.  @node UNIX source code version,,, Installation
 In order to get the key, send an e-mail consisting of the following  @subsection UNIX source code version
 single line to risa@@sec.flab.fujitsu.co.jp.  
   
 ASIR XXXXXXXX  \BEG
   First of all you have to determine the install directory.
   In the install directory, the following subdirectories are put:
   \E
   
 After a while, an e-mail will be returned containing only one line like  
   
 YYYYYYYY YYYYYYYY YYYYYYYY  
   
 Create '/export/home/noro/ca/Kobe/OpenXM/lib/asir/asir_key'  
 if necessary and append the returned string to the file.  
 @end example  
   
 @noindent  
 \BJP  \BJP
 $B$9$k$H(B, $B$3$N$h$&$J%a%C%;!<%8$,=P$F(B @samp{asir} $B$O=*N;$9$k(B. UNIX $BHG(B  $B$^$:(B, $B%$%s%9%H!<%k@h$N%G%#%l%/%H%j$r7h$a$kI,MW$,$"$k(B.
 $B$G$O(B, $B%^%7%s$4$H$K(B @code{key} $B$H8F$P$l$kJ8;zNs$,I,MW$G$"$k(B.  $B$3$3$K$O(B, $B0J2<$N%5%V%G%#%l%/%H%j$,CV$+$l$k(B.
 @code{key} $B$rF~<j$9$k$?$a$K$O(B,  \E
   
 @example  @itemize @bullet
 risa@@sec.flab.fujitsu.co.jp  @item bin
 @end example  
   
 $B08$K(B,  \EG executables of PARI and Asir
   \JP PARI $B$*$h$S(B Asir $B$N<B9T2DG=%U%!%$%k(B
   
 @example  @item lib
 ASIR XXXXXXXX  
 @end example  
   
 $B$H$$$&(B 1 $B9T$N$_$+$i$J$k(B e-mail $B$rAw$l$P$h$$(B. @code{XXXXXXXX} $B$OI=<($5$l$?(B  \EG library files of PARI and Asir
 @code{ID} $B$G$"$k(B. $B@^$jJV$7(B  \JP PARI $B$*$h$S(B Asir $B$N%i%$%V%i%j(B
   @item include
   
 @example  \EG header files of PARI
 YYYYYYYY YYYYYYYY YYYYYYYY  \JP PARI $B$N%X%C%@%U%!%$%k(B
 @end example  @end itemize
   
 @noindent  \BEG
 $B$H$$$&7A$N(B 1 $B9T$N$_$+$i$J$k(B e-mail $B$,FO$/$N$G(B, $B$3$N(B 1 $B9T$r4^$`(B @samp{asir_key}  These subdirectories are created automatically if they does not exist.
 $B$J$k%U%!%$%k$r%+%l%s%H%G%#%l%/%H%j$K:n$C$F(B @samp{asir} $B$r5/F0$7$F$_$k(B.  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  \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  \BEG
 For UNIX version of @b{Asir}, you need a @code{key}, a string,  Then, install PARI library. After getting @samp{pari.tgz},
 for each machine you want to run @b{Asir}.  unpack and install it as follows:
 In order to get the @code{key}, you just need to send an e-mail  \E
 consisting of a single line like  \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
 ASIR XXXXXXXX  % gzip -dc pari.tgz | tar xvf -
   % cd pari
   % ./Configure --prefix=TARGETDIR
   % make all
   % su
   # make install
   # make install-lib-sta
 @end example  @end example
   
 to address  \BJP
   make $BCf$K%(%i!<$G;_$^$C$?$i(B, $B0J2<$r<B9T$9$k(B.
   \E
   
 @example  \BEG
 risa@@sec.flab.fujitsu.co.jp  While executing 'make install', the procedure may stop due to
 @end example  some error. Then try the following:
   \E
   
 @noindent  
 Here, @code{XXXXXXXX} is the machine ID notified in the first message  
 from @b{Asir}.  
   
 After a while, an e-mail will be returned containing only one line like  
   
 @example  @example
 YYYYYYYY YYYYYYYY YYYYYYYY  % cd Oxxx
   % make lib-sta
   % su
   # make install-lib-sta
   # make install-include
   # exit
   %
 @end example  @end example
   
 @noindent  \BEG
 Then, you shall create a new file in the current directory  In the above example, xxx denotes the name of the target operating system.
 named @samp{asir_key} containing the returned string in one line.  Although GP is not built, the library necessary for building asir2000
   will be generated.
   
 All after this, call again @samp{asir}.  After getting @samp{asir2000.tgz}, unpack it
   and install necessary files as follows.
 \E  \E
   
 @example  
 % /usr/local/bin/asir  
 This is Risa/Asir, Version 991227.  
 Copyright (C) FUJITSU LABORATORIES LIMITED.  
 1994-1999. All rights reserved.  
 [0]  
 @end example  
   
 @noindent  
 \BJP  \BJP
 $B$3$N$h$&$J%W%m%s%W%H$,=P$l$P(B, $BF~<j$7$?(B @code{key} $B$O$=$N%^%7%s$KBP$7$FM-8z(B  $B>e$NNc$G(B, xxx $B$O8=:_%?!<%2%C%H$H$J$C$F$$$k(B OS $B$NL>A0$r<($9(B.
 $B$G$"$k(B. @code{key} $B$r=q$$$F$*$/%U%!%$%k$K4X$7$F$O(B, $B4D6-JQ?t(B @code{ASIR_KEY}  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$N@bL@$N9`$G>\$7$/=R$Y$k$,(B, $B%i%$%V%i%j%G%#%l%/%H%j$K$3$3$G:n@.$7$?(B  $B$5$l$k(B.
 $B%U%!%$%k(B @samp{asir_key} $B$rCV$1$P(B, $B$=$N%^%7%s>e$GA4$F$N%f!<%6$,(B @samp{asir}  
 $B$r;HMQ$G$-$k$h$&$K$J$k(B. @samp{asir_key} $B$K$OJ#?t$N%^%7%s$KBP$9$k(B @code{key}  
 $B$r=q$1$k$N$G(B, $B%i%$%V%i%j%G%#%l%/%H%j$r6&M-$7$F$$$k>l9g$G$b(B @samp{asir_key}  
 $B$K9T$rDI2C$7$F$$$1$P$h$$(B.  
 \E  
 \BEG  
 If you get such a prompt (@samp{[0]}) from @b{Asir},  
 the key you have is valid to the machine you are currently running  
 @code{asir}.  
   
 When the file @samp{asir_key} is located on the library directory,  @samp{asir2000.tgz} $B$rF~<j8e(B, $BE,Ev$J%G%#%l%/%H%j$G(B
 all the users of the machine can execute @samp{asir}.  $B$GE83+$7(B, $B0J2<$N<j=g$G%$%s%9%H!<%k$9$k(B.
 The file @samp{asir_key} can contain several lines for  
 several @code{key}'s.  
 This enables users to run several machines sharing the same library  
 directory by simply adding lines for machines to be used.  
 We shall describe about the file for @code{key}'s in detail in  
 @ref{Environment variable}.  
 \E  \E
   
 @example  @example
 # cp asir_key /usr/local/lib/asir  % gzip -dc asir.tgz | tar xf -
   % cd asir2000
   % ./configure --prefix=TARGETDIR --with-pari --enable-plot
   % make
   % su
   # make install
   # make install-lib
   # make install-doc
   # exit
 @end example  @end example
   
 \BJP  
 @node Windows $BHG(B,,, $B%$%s%9%H%l!<%7%g%s(B  
 @subsection Windows $BHG(B  
 \E  
 \BEG  
 @node Windows version,,, Installation  @node Windows version,,, Installation
 @subsection Windows version  @subsection Windows version
 \E  
   
 @noindent  @noindent
 \BJP  \BJP
 $BI,MW$J%U%!%$%k$O(B @samp{asirwin.tgz} $B$G$"$k(B. $BB>$K(B, @samp{gzip.exe},  @samp{asirwin32.msi} (32bit $BHG%$%s%9%H!<%i!<(B) $B$^$?$O(B
 @samp{tar.exe} $B$,I,MW$@$,(B, asirwin.tgz $B$HF1$8%G%#%l%/%H%j$KMQ0U$7$F(B  @samp{asirwin64.msi} (64bit $BHG%$%s%9%H!<%i!<(B)$B$rMQ$$$F%$%s%9%H!<%k$9$k(B.  $B$3$N%$%s%9%H!<%i!<$O(B $B4D6-JQ?t(B @samp{ASIR_ROOTDIR} $B$K%$%s%9%H!<%k$7$?%U%)%k%@$r@_Dj$9$k(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  (zip $BHG$O(B @samp{ASIR_ROOTDIR} $B$r<jF0$G@_Dj$9$kI,MW$,$"$j(B, $B$^$?%;%-%e%j%F%#%V%m%C%/$r2r=|$7$F$+$iE83+$7$J$$$H$$$1$J$$(B. zip$BHG$O3+H/<TMQ(B.)
 $B$+$i(B  $B%G%9%/%H%C%W$N(B asirgui $B$r%@%V%k%/%j%C%/$9$l$P(B asir $B$,%9%?!<%H$9$k(B. $B%F%-%9%H%(%G%#%?$H$NO"7H5!G=$r;H$&$K$O(B,
   @samp{%ASIR_ROOTDIR%\share\editor} $B$N;X<($K=>$$@_Dj$r9T$&(B.
   $B$J$*%$%s%9%H!<%k%U%)%k%@!<L>$d%f!<%6!<$N%[!<%`%U%)%k%@L>$,$$$o$f$k%@%aJ8;z$r4^$`>l9g$O@5>o$KF0:n$7$J$$5!G=$,$"$k(B.
   (|$B%@%aJ8;z(B $B%A%'%C%+!<(B| $B$G8!:w$7$F<+J,$N%f!<%6!<L>$,3:Ev$9$k$+3NG'(B)
 \E  \E
 \BEG  \BEG
 The necessary file is @samp{asirwin.tgz}. To unpack it @samp{gzip.exe}  The installers are
 and @samp{tar.exe} are necessary. They are in the same  @samp{asirwin32.msi} (32bit version) and
 directory as @samp{asirwin.tgz} on the ftp server.  @samp{asirwin64.msi} (64bit version).
 Putting them in the same directory, execute the following:  These installers set the installed folder to the environmental variable
   @samp{ASIR_ROOTDIR}.
   (If you install Risa/Asir by the zip version,
   you need to set the environmental variable  @samp{ASIR_ROOTDIR}
   by hand.
   You also need to unlock the security block before unzipping.
   The zip version is for developpers.)
   Double click the ``asirgui'' on the desktop,
   then the asir starts.
   To use a unified environment with text editors,
   follow the instruction in
   @samp{%ASIR_ROOTDIR%\share\editor}.
   If the folder name to which you install asir or your home folder name
   contain non-ascii characters,
   some functions of asir may not work properly.
   For example, in the Japense locale, names which may cause troubles
   can be checked by ``damemoji checker''.
 \E  \E
   
 @example  
 \JP C:\...> tar xzf asirwin.tgz  
 \EG C:\...> tar xzf asirwin.tgz  
 @end example  
   
 @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$,$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  
 $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  
 $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  
 $B%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$N=i2s$NN)$A>e$2$O(B, $B%(%/%9%W%m!<%i$+$i9T(B  
 $B$&(B. $B$3$l$K$h$j(B  
 \E  
   
 \BEG  
 Then a directory @samp{Asir} (@b{Asir root directory}) is created,  
 which has subdirectories named @samp{bin} and @samp{lib}. To set up it,  
 invoke @samp{bin\asirgui.exe} from Explorer and  
 click @code{OK}.  Then the name of @b{Asir root directory} is set to the  
 following registries.  
 \E  
   
 @example  
 \JP HKEY_LOCAL_MACHINE\SOFTWARE\FUJITSU\Asir\99.03.31\Directory  
 \EG HKEY_LOCAL_MACHINE\SOFTWARE\FUJITSU\Asir\99.03.31\Directory  
 @end example  
   
 @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.  
   
 \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
 @section $B%3%^%s%I%i%$%s%*%W%7%g%s(B  @section $B%3%^%s%I%i%$%s%*%W%7%g%s(B
 \E  \E
Line 549  When this option is specified, @b{Asir} does not read 
Line 512  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 594  displayed by the command @code{limit} on UNIX.
Line 562  displayed by the command @code{limit} on UNIX.
   
 @noindent  @noindent
 \BJP  \BJP
 @b{Asir} $B$N<B9T$K4X$9$k$$$/$D$+$N4D6-JQ?t$,B8:_$9$k(B. UNIX $B>e$G$O4D6-JQ?t(B  @b{Asir} $B$N<B9T$K4X$9$k$$$/$D$+$N4D6-JQ?t$,B8:_$9$k(B. UNIX $B>e$G$O4D6-JQ?t(B $B$O(B shell $B$N%3%^%s%I%i%$%s$+$iD>@\@_Dj$9$k$+(B, shell $B$N(B rc $B%U%!%$%k$G@_Dj(B $B$9$k(B. Windows $B$G$O(B,  [$B4D6-JQ?t$NJT=8(B] $B$G@_Dj$9$k(B.
 $B$O(B shell $B$N%3%^%s%I%i%$%s$+$iD>@\@_Dj$9$k$+(B, shell $B$N(B rc $B%U%!%$%k$G@_Dj(B  
 $B$9$k(B. Windows NT $B$G$O(B, [$B@_Dj(B]->[$B%7%9%F%`(B]->[$B4D6-(B] $B$G@_Dj$9$k(B. Windows 95/98  
 $B$G$O(B, @samp{c:\autoexec.bat} $B$K=q$$$F(B reboot $B$9$k(B.  
 \E  \E
 \BEG  \BEG
 There exist several environment variables concerning with an execution  There exist several environment variables concerning with an execution
 of @b{Asir}. On UNIX, an environment variable is set from shells, or  of @b{Asir}. On UNIX, an environment variable is set from shells, or
 in rc files of shells. On Windows NT, it can be set from [Control Panel]  in rc files of shells. On Windows, it can be set from
 ->[Environment]. On Windows 95/98, it can be set in @samp{c:\autoexec.bat}.  [Editing environmetal variables].
 Note that the setting takes effect after rebooting the machine on Windows  
 95/98.  
 \E  \E
 @itemize @bullet  @itemize @bullet
 @item  @item
 @code{ASIR_KEY}  @code{ASIR_LIBDIR}
   @*
 \BJP  \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$3$N4D6-JQ?t$OGQ;_M=Dj(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  \E
 \BEG  \BEG
 @b{Asir} shall not work unless a @code{key} for the machine  This environmental variable is obsolete.
 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  \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  @item
 \JP $B4D6-JQ?t(B @code{ASIR_KEY} $B$K;XDj$5$l$?%U%!%$%k(B  @code{ASIR_CONTRIB_DIR}
 \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  \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  $B$3$N4D6-JQ?t$OGQ;_M=Dj(B.
 @samp{/usr/local/lib/asir}) $B$N(B @samp{asir_key}  
 \E  \E
 \BEG  \BEG
 Files on the directory specified by environment @code{ASIR_LIBDIR}.  This environmental variable is obsolete.
 (File @samp{asir_key} on @samp{/usr/local/lib/asir/},  
 if environment @code{ASIR_LIBDIR} is not set.)  
 \E  \E
   
 @end enumerate  
   
 @item  @item
 @code{ASIR_LIBDIR}  
   
 \BJP  
 @b{Asir} $B$N%i%$%V%i%j%G%#%l%/%H%j(B, $B$9$J$o$A%f!<%68@8l$G=q$+$l$?%U%!%$%k(B  
 $B$J$I$,$*$+$l$k%G%#%l%/%H%j(B. $B;XDj$,$J$$>l9g(B UNIX $BHG$G$O(B  
 @samp{/usr/local/lib/asir}, Windows $BHG$G$O(B Asir $B%a%$%s%G%#%l%/%H%j$N2<$N(B  
 @samp{lib} $B%G%#%l%/%H%j$,MQ$$$i$l$k(B.  
 \E  
 \BEG  
 The library directory of @b{Asir}, i.e., the directory where  
 , for example, files containing programs written in @b{Asir}.  
 If not specified, on UNIX, @samp{/usr/local/lib/asir} is used by default.  
 On Windows, @samp{lib} 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  
 @code{ASIRLOADPATH}  @code{ASIRLOADPATH}
   @*
 \BJP  \BJP
 $B%m!<%I$5$l$k%U%!%$%k$,$"$k%G%#%l%/%H%j$r(B UNIX $B$N>l9g(B ':',  $B%m!<%I$5$l$k%U%!%$%k$,$"$k%G%#%l%/%H%j$r(B UNIX $B$N>l9g(B ':',
 Windows$B$N>l9g(B ';' $B$G6h@Z$C$FJB$Y$k(B. $B%G%#%l(B  Windows$B$N>l9g(B ';' $B$G6h@Z$C$FJB$Y$k(B. $B%G%#%l(B
Line 701  After searching out all directories in @code{ASIRLOADP
Line 609  After searching out all directories in @code{ASIRLOADP
 or in case of no specification at all,  or in case of no specification at all,
 the library directory will be searched.  the library directory will be searched.
 \E  \E
   \BJP
   unix $BHG$N%i%$%V%i%j%G%#%l%/%H%j$O(B
   \E
   \BEG
   The library directories of the unix version are
   \E
   @samp{$OpenXM_HOME/lib/asir-contrib},
   @samp{$OpenXM_HOME/lib/asir},
   /usr/local/lib/asir-contrib,
   /usr/local/lib/asir.
   \BJP
   Windows $BHG$N%i%$%V%i%j%G%#%l%/%H%j$O(B,
   @samp{OpenXM_HOME} $B$,@_Dj$5$l$F$$$J$$$H$-$O(B,
   \E
   \BEG
   When @samp{OpenXM_HOME} is not set,
   the library directories of the Windows version are
   \E
   %ASIR_ROOTDIR%\lib\asir-contrib,
   %ASIR_ROOTDIR%\lib\asir.
   \BJP
   @samp{OpenXM_HOME} $B@_Dj$5$l$F$$$l$P(B, unix $BHG$HF1MM(B.
   \E
   \BEG
   When @samp{OpenXM_HOME} is set, the library directories are same with
   the unix version.
   \E
   \BJP
   $B$^$?(BWindows $BHG$N>l9g(B, $B8D?MNN0h(B
   @samp{%APPDATA%\OpenXM\lib\asir-contrib}
   $B$b%i%$%V%i%j%G%#%l%/%H%j$H$J$k(B.
   $B$J$*(B unix $BHG$G$O>e5-$N$h$&$J8D?MNN0h$rC5:w$9$k;EAH$_$O$J$/(B,
   OpenXM $BHG$N(B asir $B$G$O(B
   \samp{OpenXM/rc/} $B$K$*$$$F(B @samp{ASIRLOADPATH} $B$G(B
   @samp{$OpenXM_tmp/OpenXM/lib/asir-contrib} $B$r%5!<%A%Q%9$K2C$($F$$$k(B.  asir_contrib_update $B$r;2>H(B.
   which, ctrl("loadpath"), asir2000/parse/load.c $B$b;2>H(B.
   \E
   \BEG
   In the Windows version, the private folder
   @samp{%APPDATA%\OpenXM\lib\asir-contrib}
   is also set to the library folders.
   In the unix version, there is no default private library folder.
   In the OpenXM/unix version,
   @samp{$OpenXM_tmp/OpenXM/lib/asir-contrib} is added to the @samp{ASIRLOADPATH}
   by a script in \samp{OpenXM/rc/}.
   See also asir_contrib_update.
   See which, ctrl("loadpath"), asir2000/parse/load.c.
   \E
   
 @item  @item
 @code{HOME}  @code{HOME}
   @*
 \BJP  \BJP
 @var{-norc} $B%*%W%7%g%s$D$-$G5/F0$7$J$$>l9g(B, @samp{$HOME/.asirrc}$B$,$"$l$P(B,  @var{-norc} $B%*%W%7%g%s$D$-$G5/F0$7$J$$>l9g(B, @samp{$HOME/.asirrc}$B$,$"$l$P(B,
 $BM=$a$3$N%U%!%$%k$r<B9T$9$k(B. @code{HOME} $B$,@_Dj$5$l$F$$$J$$>l9g(B, UNIX $BHG(B  $BM=$a$3$N%U%!%$%k$r<B9T$9$k(B. @code{HOME} $B$,@_Dj$5$l$F$$$J$$>l9g(B, UNIX $BHG(B
Line 836  value of the function.
Line 793  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
Line 948  like normal errors.
Line 903  like normal errors.
 @table @code  @table @code
 @item SEGV  @item SEGV
 @itemx BUS ERROR  @itemx BUS ERROR
   @*
 \BJP  \BJP
 $BAH$_9~$_H!?t$K$h$C$F$O(B, $B0z?t$N7?$r87L)$K%A%'%C%/$;$:$K1i;;%k!<%A%s$K0z(B  $BAH$_9~$_H!?t$K$h$C$F$O(B, $B0z?t$N7?$r87L)$K%A%'%C%/$;$:$K1i;;%k!<%A%s$K0z(B
 $B$-EO$7$F$7$^$&$b$N$bB8:_$7$F$$$k(B. $B$3$N$h$&$J>u67$K$*$$$F(B,  $B$-EO$7$F$7$^$&$b$N$bB8:_$7$F$$$k(B. $B$3$N$h$&$J>u67$K$*$$$F(B,
Line 964  is detected.
Line 919  is detected.
 \E  \E
   
 @item BROKEN PIPE  @item BROKEN PIPE
   @*
 \BJP  \BJP
 $B%W%m%;%94VDL?.$K$*$$$F(B, $BAj<j@h$N%W%m%;%9$H$N4V$N%9%H%j!<%`(B  $B%W%m%;%94VDL?.$K$*$$$F(B, $BAj<j@h$N%W%m%;%9$H$N4V$N%9%H%j!<%`(B
 $B$,4{$KB8:_$7$F$$$J$$>l9g(B ($BNc$($P4{$KAj<j@h$N%W%m%;%9$,=*N;$7$F$$$k>l9g$J$I(B)  $B$,4{$KB8:_$7$F$$$J$$>l9g(B ($BNc$($P4{$KAj<j@h$N%W%m%;%9$,=*N;$7$F$$$k>l9g$J$I(B)
Legend:
Removed from v.1.6  
changed lines
  Added in v.1.15
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>