[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.14

version 1.6, 2000/01/20 03:00:34 version 1.14, 2005/03/30 10:53:28
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.13 2005/03/24 23:40:50 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},  $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 467  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 549  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 609  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
 @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{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  $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{/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.  @samp{lib} $B%G%#%l%/%H%j$,MQ$$$i$l$k(B.
   $B$3$N4D6-JQ?t$O(B @code{ASIRLOADPATH} $B$KE}9g$5$lGQ;_$5$l$kM=Dj(B.
 \E  \E
 \BEG  \BEG
 The library directory of @b{Asir}, i.e., the directory where  The library directory of @b{Asir}, i.e., the directory where
Line 680  If not specified, on UNIX, @samp{/usr/local/lib/asir} 
Line 613  If not specified, on UNIX, @samp{/usr/local/lib/asir} 
 On Windows, @samp{lib} in @b{Asir root directory} 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  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.
   This environmental variable will become obsolete.
 \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.
   $B$3$N4D6-JQ?t$O(B @code{ASIRLOADPATH} $B$KE}9g$5$lGQ;_$5$l$kM=Dj(B.
   This environmental variable will become obsolete.
   \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}
   @*
 \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 703  the library directory will be searched.
Line 660  the library directory will be searched.
 \E  \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.14
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>