japanese translation updated for functions module. 96/14496/2
Rui Hirokawa [Sun, 4 May 2014 06:45:58 +0000 (15:45 +0900)]
Change-Id: Ice204b457b2915909008f0fb0fdc0937bcd33391

45 files changed:
scilab/modules/functions/help/ja_JP/argn.xml
scilab/modules/functions/help/ja_JP/built_in/clearfun.xml
scilab/modules/functions/help/ja_JP/built_in/external.xml
scilab/modules/functions/help/ja_JP/built_in/funptr.xml
scilab/modules/functions/help/ja_JP/built_in/intppty.xml
scilab/modules/functions/help/ja_JP/built_in/newfun.xml
scilab/modules/functions/help/ja_JP/built_in/readgateway.xml
scilab/modules/functions/help/ja_JP/built_in/what.xml
scilab/modules/functions/help/ja_JP/bytecode.xml
scilab/modules/functions/help/ja_JP/bytecodewalk.xml
scilab/modules/functions/help/ja_JP/code2str.xml [new file with mode: 0644]
scilab/modules/functions/help/ja_JP/comp.xml
scilab/modules/functions/help/ja_JP/deff.xml
scilab/modules/functions/help/ja_JP/edit.xml
scilab/modules/functions/help/ja_JP/exec.xml
scilab/modules/functions/help/ja_JP/execstr.xml
scilab/modules/functions/help/ja_JP/fun2string.xml
scilab/modules/functions/help/ja_JP/funcprot.xml
scilab/modules/functions/help/ja_JP/function.xml
scilab/modules/functions/help/ja_JP/functions.xml
scilab/modules/functions/help/ja_JP/getd.xml
scilab/modules/functions/help/ja_JP/head_comments.xml
scilab/modules/functions/help/ja_JP/libraries/genlib.xml
scilab/modules/functions/help/ja_JP/libraries/get_function_path.xml
scilab/modules/functions/help/ja_JP/libraries/lib.xml
scilab/modules/functions/help/ja_JP/libraries/librarieslist.xml
scilab/modules/functions/help/ja_JP/libraries/libraryinfo.xml
scilab/modules/functions/help/ja_JP/libraries/whereis.xml
scilab/modules/functions/help/ja_JP/listfunctions.xml
scilab/modules/functions/help/ja_JP/macr2lst.xml
scilab/modules/functions/help/ja_JP/macr2tree.xml
scilab/modules/functions/help/ja_JP/macro.xml
scilab/modules/functions/help/ja_JP/macrovar.xml
scilab/modules/functions/help/ja_JP/mode.xml
scilab/modules/functions/help/ja_JP/overloading.xml
scilab/modules/functions/help/ja_JP/profiling/add_profiling.xml
scilab/modules/functions/help/ja_JP/profiling/plotprofile.xml
scilab/modules/functions/help/ja_JP/profiling/profile.xml
scilab/modules/functions/help/ja_JP/profiling/remove_profiling.xml
scilab/modules/functions/help/ja_JP/profiling/reset_profiling.xml
scilab/modules/functions/help/ja_JP/profiling/showprofile.xml
scilab/modules/functions/help/ja_JP/recompilefunction.xml
scilab/modules/functions/help/ja_JP/sciargs.xml
scilab/modules/functions/help/ja_JP/str2code.xml [new file with mode: 0644]
scilab/modules/functions/help/ja_JP/tree2code.xml

index 2193001..988e343 100644 (file)
@@ -1,27 +1,65 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="argn">
+    
     <refnamediv>
+        
         <refname>argn</refname>
+        
         <refpurpose>関数コールの入力/出力引数の数を返す</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>[lhs [,rhs] ]=argn()
+            
             lhs=argn(1)
+            
             rhs=argn(2)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             この関数は関数定義の内部で使用されます.
-            この関数は関数がコールされた際に関数に指定された実際の入力引数(<literal>rhs</literal>)と
-            出力引数(<literal>lhs</literal>) の数を出力します.
+            
+            この関数は関数がコールされた際に関数に指定された実際の入力引数(<varname>lhs</varname>)と
+            
+            出力引数(<varname>lhs</varname>) の数を出力します.
+            
             通常,関数の定義においてオプションの引数を処理する際に使用されます.
+            
         </para>
+        
+        <para>
+            
+            <note>
+                
+                <varname>lhs</varname> は常に1以上であることに注意してください.
+                
+                言い換えると,関数が出力引数なしにコールされた場合であっても,
+                
+                <varname>lhs</varname> は 1 となります.
+                
+            </note>
+            
+        </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 function concat=myOwnFunction(name,optional)
   [lhs,rhs]=argn(0) 
@@ -34,16 +72,30 @@ function concat=myOwnFunction(name,optional)
   concat=name+" "+optional
 endfunction
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="function">function</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="varargin">varargin</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index fc285ff..4146592 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="clearfun">
+    
     <refnamediv>
+        
         <refname>clearfun</refname>
+        
         <refpurpose>プリミティブ(組み込み関数)を削除</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>ret=clearfun('name')</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>'name'</term>
+                
+                <listitem>
+                    
+                    <para>プリミティブの名前</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>ret</term>
+                
+                <listitem>
+                    
+                    <para>論理値</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>clearfun('name')</literal> は,
+            
             プリミティブ(組み込み関数)の集合から
+            
             プリミティブ<literal>'name'</literal>を削除します.
-            clearfun は %t または %fを返します.
+            
+            <literal>clearfun</literal>は,
+            
+            <literal>%t</literal> または <literal>%f</literal>を返します.
+            
             この関数によりプリミティブをリネームすることが可能になります :
+            
             Scilab プリミティブをユーザが定義した関数で置換することが
+            
             できます.
+            
             この関数は,エキスパート用です...
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="newfun">newfun</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="funptr">funptr</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 612ba0c..e70abda 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="external">
+    
     <refnamediv>
+        
         <refname>external</refname>
+        
         <refpurpose>Scilabオブジェクト, 外部関数またはルーチン</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            特定のコマンド要の外部関数またはルーチン.
+            
+            特定のコマンドで使用する外部関数またはルーチン.
+            
         </para>
+        
         <para>
+            
             "external" は,
+            
             (<literal>ode</literal>, <literal>optim</literal>, <literal>schur</literal>...
+            
             のような)
+            
             いくつかの高レベルプリミティブの引数として使用される
+            
             関数またはルーチンです.
+            
         </para>
+        
         <para>
+            
             external (関数またはルーチン)の呼び出し手順は,
+            
             external の引数を設定する高レベルプリミティブにより
+            
             規定されています.
+            
         </para>
+        
         <para>
+            
             例えば, 外部関数 <literal>costfunc</literal> は,
+            
             <literal>optim</literal> プリミティブの引数です.
+            
             その呼出し手順は次のようになります: <literal>[f,g,ind]=costfunc(x,ind)</literal>
+            
             そして <literal>optim</literal> (高レベル最適化プリミティブ)は
+            
             以下のようにコールされます
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 optim(costfunc,...)
  ]]></programlisting>
+        
         <para>
+            
             ここで, <literal>costfunc</literal> (評価関数はプリミティブ
+            
             <literal>optim</literal>により最小化されます)は,
+            
             <literal>f=f(x)</literal> および<literal>x</literal>における
+            
             <literal>f</literal>の傾き<literal>g</literal>を評価します
+            
             (<literal>ind</literal> は整数です. その使用法は
+            
             <literal>optim</literal>ヘルプに詳述されています).
+            
         </para>
+        
         <para>
+            
             その他の値が外部関数により必要とされる場合,
+            
             これらの変数をその環境において定義することができます.
+            
             また, 外部関数をリスト内に置くことができます.
+            
             例えば,外部関数
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 [f,g,ind]=costfunc(x,ind,a,b,c) 
  ]]></programlisting>
+        
         <para>
+            
             は, external が
+            
             <literal>list(costfunc,a,b,c)</literal>の場合,
+            
             <literal>optim</literal>に適用できます.
+            
             そして, <literal>optim</literal>へのコールは
+            
             以下のようになります:
+            
         </para>
+        
         <programlisting role=""><![CDATA[ 
 optim(list(costfunc,a1,b1,c1),....
  ]]></programlisting>
+        
         <para>
+            
             externalはFortranまたはCルーチンとすることもできます: 
+            
             これは計算を高速化するために有用です.
+            
         </para>
+        
         <para>
+            
             ルーチンの名前は文字列として高レベルプリミティブに
+            
             指定することができます.
+            
             このルーチンの呼び出し手順も規定されています.
+            
         </para>
+        
         <para>
+            
             外部FortranまたはCルーチンも動的にリンクできます
+            
             (<literal>link</literal>参照).
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="ode">ode</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="optim">optim</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="impl">impl</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="dassl">dassl</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="intg">intg</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="schur">schur</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="gschur">gschur</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 177cc1f..f560f76 100644 (file)
@@ -1,46 +1,89 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="funptr">
+    
     <refnamediv>
+        
         <refname>funptr</refname>
+        
         <refpurpose>プリミティブのコーディング ( 上級者向け )  </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>[numptr] = funptr(name)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>name</term>
+                
                 <listitem>
+                    
                     <para>文字列,プリミティブの名前</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>numptr</term>
+                
                 <listitem>
+                    
                     <para>プリミティブの内部ルーチン番号</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             プリミティブ<literal>'name'</literal>の
+            
             内部的なルーチン番号<literal>numptr</literal>を取得するためのユーティリティ関数(上級者専用).
+            
             <literal>numptr</literal> は,インターフェイス番号 <literal>fun</literal>および
+            
             そのインターフェイス内のプリミティブのルーチン番号 <literal>fin</literal>により
+            
             <literal>numptr = 1000*fun + fin</literal> (fin &lt; 1000) のように計算されます.
+            
             <literal>numptr</literal> により, インターフェイス番号 <literal>fun = floor(numptr/1000)</literal>
+            
             を得ることができます.
+            
             この番号は,参照渡しの引数を有する動的インターフェイスにリンクする際に有用です
+            
             (以下の例を参照).
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 // Suppose you want to load some codes via the dynamic 
 // loading facilities offers by addinter. By default 
 //
 // you will see all the interfaces working by reference
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="clearfun">clearfun</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="newfun">newfun</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="intppty">intppty</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="addinter">addinter</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 1ad8b9a..dd3e03a 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="intppty">
+    
     <refnamediv>
+        
         <refname>intppty</refname>
+        
         <refpurpose>プロパティを指定するインターフェイス引数を指定</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>funs=intppty()
+            
             intppty(fun)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>fun</term>
+                
                 <listitem>
-                    <para>整数, インターフェイス番号 (funptr参照)</para>
+                    
+                    <para>
+                        整数, インターフェイス番号 (<link linkend="funptr">funptr</link>参照)
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>funs</term>
+                
                 <listitem>
-                    <para>整数ベクトル, インターフェイス番号のベクトル (funptr参照)</para>
+                    
+                    <para>整数ベクトル, インターフェイス番号のベクトル
+                        
+                        (<link linkend="funptr">funptr</link>参照)
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             インターフェイスプログラムでは,関数の引数を渡す手順を
+            
             2種類の異なる手法で記述することができます.
+            
         </para>
+        
         <para>
+            
             最初のデフォルトの方法の場合,
+            
             引数は値で渡されます.
+            
             これは以下の構文となります:
+            
         </para>
-        <programlisting role=""><![CDATA[ 
+        
+        <programlisting role="no-scilab-exec"><![CDATA[ 
 foo(A,1+2)
  ]]></programlisting>
+        
         <para>
+            
             <literal>A</literal>で指定した引数は値で渡され
+            
             (<literal>foo</literal>がコールされる前に
+            
             <literal>A</literal>のコピーが作成されます),
+            
             <literal>1+2</literal>で指定した引数も値で渡されます.
+            
         </para>
+        
         <para>
+            
             2番目の方法では,"名前付きの引数"がある場合,
+            
             引数をリファレンスで渡すことができます
+            
             (変数の値のコピーは行われません).
+            
+            
+            
             <literal>fun&gt;0</literal>を指定して<literal>intppty(fun)</literal>とすると,
+            
             番号 <literal>fun</literal>のインターフェイスにより
+            
             リファレンスに渡しの引数を処理できることがScilabに伝えられます.
+            
             以下の構文の場合:
+            
         </para>
-        <programlisting role=""><![CDATA[ 
+        
+        <programlisting role="no-scilab-exec"><![CDATA[ 
 foo(A,1+2)
  ]]></programlisting>
+        
         <para>
+            
             <literal>A</literal> が指す引数はリファレンス渡しされ,
+            
             <literal>1+2</literal> が指す引数は値で渡されます.
+            
         </para>
+        
         <para>
-            番号<literal>fun</literal>のインターフェイスを宣言することにより,
-            予測不能な結果を生み出す場合でない限り,
-            リファレンス渡しの引数を処理できることに注意してください.
+            
+            <warning>
+                
+                番号<literal>fun</literal>のインターフェイスを宣言することにより,
+                
+                予測不能な結果を生み出す場合でない限り,
+                
+                リファレンス渡しの引数を処理できることに注意してください.
+                
+            </warning>
+            
         </para>
+        
         <para>
+            
             <literal>fun&lt;0</literal>の場合の<literal>intppty(fun)</literal>は
+            
             インターフェイス<literal>-fun</literal>に関して
+            
             その使用を停止します.
+            
         </para>
+        
         <para>
+            
             <literal>intppty()</literal> は,
+            
             参照渡しされる引数を処理するインターフェイスのベクトルを返します.
+            
         </para>
+        
         <para>
+            
             この関数は動的にロードされるインターフェイスの場合に有用です
-            (addinter参照).
+            
+            (<link linkend="addinter">addinter</link>参照).
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="funptr">funptr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="addinter">addinter</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index eff544b..7b1ea2e 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="newfun">
+    
     <refnamediv>
+        
         <refname>newfun</refname>
+        
         <refpurpose>関数のテーブルに名前を追加する</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>newfun("function-name",nameptr)</synopsis>
+        
+        <synopsis>newfun(function_name, function_ptr)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>function_name</term>
+                
+                <listitem>
+                    
+                    <para>文字列, 有効な関数名を指定する</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>function_ptr</term>
+                
+                <listitem>
+                    
+                    <para>整数値を有する正の数 (以下参照)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>説明</title>
+        
+        <para>ユーティリティ関数 (上級者専用). </para>
+        
         <para>
-            ユーティリティ関数 (上級者専用). 名前 <literal>"function-name"</literal>を
+            
+            名前 <literal>function-name</literal>を
+            
             インタプリタに既知の関数テーブルに追加します.
-            <literal>"nameptr"</literal> は整数<literal>1000*fun+fin</literal>です.
+            
+        </para>
+        
+        <para>
+            
+            <literal>function_ptr</literal>は整数<literal>1000*fun+fin</literal>です.
+            
             ただし,<literal>fun</literal> および <literal>fin</literal>は,
-            プリミティブ <literal>"function-name"</literal>の内部的なコーディング
-            です.
-            この関数はプリミティブが
-            <literal>"matusr.f"</literal>へのインターフェイスを指す場合 (<literal>fun=14</literal>)
-            に有用です.
-            <literal>funptr</literal> および <literal>clearfun</literal>と共に使用すると,
-            同じ名前の関数によりプリミティブを再定義できます.
+            
+            プリミティブ<literal>function_name</literal>の内部的なコーディングです.
+            
+        </para>
+        
+        <para>
+            
+            この関数は,プリミティブを
+            
+            <literal>"gw_user.c"</literal> でコールされるゲートウェイ 
+            
+            (<literal>fun=14</literal>)に関連付ける際に有用です. 
+            
+            ただし,
+            
+            <link linkend="ilib_build">ilib_build</link>関数が
+            
+            C, C++ または Fortranコードに基づき新しい関数で
+            
+            Scilabを拡張するためのより簡単な方法であることに注意してください.
+            
+        </para>
+        
+        <para>
+            
+            この関数は,既存のプリミティブ関数にエイリアスを追加したり,
+            
+            リネームする場合にも使用可能です.
+            
         </para>
+        
+        <para>
+            
+            <literal>funptr</literal> および <literal>clearfun</literal>
+            
+            と共に使用すると,既存のプリミティブ関数にエイリアスを
+            
+            追加したり, リネームすることができます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+     absptr=funptr("abs");// get the function_ptr associated with the abs function
+     newfun("abs_bis",absptr) // create an alias of the abs function
+     abs_bis(-1+%i)
+     clearfun("abs") // remove abs as a known function
+     
+      //redefine abs
+      function y=abs(x)
+       y=abs_bis(real(x));
+      endfunction
+      
+     abs(-1+%i)
+  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="clearfun">clearfun</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="funptr">funptr</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="ilib_build">ilib_build</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index cc840ab..08e8c8b 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="readgateway" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>readgateway</refname>
+        
         <refpurpose>モジュールのプリミティブの一覧を取得</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>readgateway(module_name)
+            
             primitives = readgateway(module_name);
+            
             [primitives,primitivesID] = readgateway(module_name);
+            
             [primitives,primitivesID,gatewayID] = readgateway(module_name);
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>module_name</term>
+                
+                <listitem>
+                    
+                    <para>文字列</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>primitives, primitivesID, gatewayID</term>
+                
+                <listitem>
+                    
+                    <para>文字列の行列</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
         <title>説明</title>
-        <para>モジュールのプリミティブの一覧を取得します.</para>
-        <para>primitives : モジュールのプリミティブの一覧.</para>
-        <para>primitivesID : プリミティブのIDの一覧.</para>
-        <para>gatewayID : モジュールに関連するゲートウエイのIDの一覧</para>
+        
+        <para>
+            
+            <literal>readgateway(module_name)</literal>は,
+            
+            <literal>module_name</literal>の
+            
+            プリミティブの一覧を取得します.
+            
+        </para>
+        
+        <para>
+            
+            <literal>primitives</literal>: <literal>module_name</literal>のプリミティブの一覧.
+            
+        </para>
+        
+        <para>
+            
+            <literal>primitivesID</literal>: プリミティブのIDの一覧.
+            
+        </para>
+        
+        <para>
+            
+            <literal>gatewayID</literal>: <literal>module_name</literal>に関連するゲートウエイのIDの一覧
+            
+        </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 [primitives,primitivesID,gatewayID] = readgateway('core');
 primitives(1) // 'debug' primitive
 primitivesID(1) // 1 is ID of 'debug' in 'core' gateway
 gatewayID(1) // 13 is ID of 'core' gateway in scilab
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="getmodules">getmodules</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index a1c13bd..8193820 100644 (file)
@@ -1,29 +1,36 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="what">
+    
     <refnamediv>
+        
         <refname>what</refname>
+        
         <refpurpose>Scilabプリミティブの一覧を得る
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>what()
+            
             [primitives,commands]=what();
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>低レベルプリミティブおよびコマンドの一覧を得ます.</para>
+        
     </refsection>
-    <refsection role="see also">
-        <title>Voir aussi</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="whereami">whereami</link>
-            </member>
-            <member>
-                <link linkend="pause">pause</link>
-            </member>
-        </simplelist>
-    </refsection>
+    
 </refentry>
+
index 60a122a..44b0ba2 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA Serge Steer
  * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *-->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="bytecode">
+    
     <refnamediv>
+        
         <refname>bytecode</refname>
+        
         <refpurpose>
+            
             Scilab関数を指定すると"バイトコード"をScilab配列に返す,
+            
             またはその逆の処理を行う.
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>
+            
             x = bytecode(f)
+            
             f = bytecode(x)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>f</term>
+                
                 <listitem>
+                    
                     <para>
-                        scilab 関数.
+                        
+                        Scilab 関数.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>x</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         int32 行ベクトル
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            <code>x = bytecode(f)</code> は,
+            
+            <code>f= bytecode(x)</code>は,
+            
             Scilab関数 <varname>f</varname> の "バイトコード"を
+            
             整数配列<varname>x</varname>に返します.
+            
         </para>
+        
         <para>
+            
             <code>f= bytecode(x)</code> は,
+            
             Scilabの整数配列 <varname>x</varname> で指定した
+            
             "バイトコード"が示す関数 <varname>f</varname> を
+            
             返します.
-            <varname>x</varname> の有効性は確認されないことに
-            注意してください.
+            
+            <warning>
+                
+                警告: <varname>x</varname> の有効性は確認されません.
+                
+            </warning>
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>注意</title>
+        
         <para>
+            
             Scilab関数のバイトコードは,将来劇的に進化すると予想されるため,
+            
             この関数はプロファイル命令の処理に限って使用するべきです.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 function a=foo(),a=sin(3),endfunction
 bytecode(foo)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="add_profiling">add_profiling</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="bytecodewalk">bytecodewalk</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macr2lst">macr2lst</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macr2tree">macr2tree</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index a486e3d..1ff879d 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Ajouter ici d'éventuels commentaires sur le fichier XML
 -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="bytecodewalk">
+    
     <refnamediv>
+        
         <refname>bytecodewalk</refname>
+        
         <refpurpose>
+            
             関数バイトコードを検索し,変換する. 
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>c1 = bytecodewalk(code,query,job)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>code</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         int32 ベクトル: 入力バイトコード配列
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>query</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         整数, 検索対象のオペコード
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>job</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         指示するオペコードで実行する処理
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>c1</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         int32 ベクトル: 出力バイトコード配列
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             関数バイトコードコードを検索し,
+            
             変換します.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="bytecode">bytecode</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
diff --git a/scilab/modules/functions/help/ja_JP/code2str.xml b/scilab/modules/functions/help/ja_JP/code2str.xml
new file mode 100644 (file)
index 0000000..826ea38
--- /dev/null
@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) INRIA -
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="code2str" xml:lang="en">
+    
+    <refnamediv>
+        
+        <refname>code2str</refname>
+        
+        <refpurpose>
+            
+            Scilab整数コードに関連した文字列を返す.
+            
+            <emphasis role="bold">この関数は廃止されました.</emphasis>
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>str = code2str(c)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>str</term>
+                
+                <listitem>
+                    
+                    <para>文字列.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>c</term>
+                
+                <listitem>
+                    
+                    <para>整数コードの文字ベクトル.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            <code>str = code2str(c)</code> は
+            
+            Scilab整数コードに関連する文字列を返します.
+            
+            <varname>str</varname>は,
+            
+            <literal>c(i)</literal>が<literal>part(str,i)</literal>の
+            
+            Scilab整数コードとなるような文字列です.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+code2str([-28 12 18 21 10 11])
+str2code('Scilab')'
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="str2code">str2code</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="ascii">ascii</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="part">part</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revremark>この関数はScilab 6.0.0で削除されます</revremark>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+</refentry>
+
index f7d5b6b..173d3f3 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="comp" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>comp</refname>
+        
         <refpurpose>scilab 関数のコンパイル</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>comp(function [,opt])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>function</term>
+                
                 <listitem>
+                    
                     <para>コンパイルされていないscilab関数 (タイプ 11)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>opt</term>
+                
                 <listitem>
+                    
                     <para>フラグ. 値は 0 (デフォルト), 1 または 2.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>comp(function)</literal> は関数
+            
             <literal>function</literal>をコンパイルします. 
+            
             コンパイル済みの関数と解釈された関数は等価ですが,
+            
             通常はコンパイル済みの関数の方がはるかに高速です.
+            
             標準ライブラリとして提供される関数はコンパイルされています.
+            
         </para>
+        
         <para>
             コマンド<literal>exec</literal>と<literal>deff</literal>の短縮構文と
+            
             同様に,オンライン定義もコンパイルされた関数を生成します.
-            このため, comp は非常に多くの場面で使用されます.
+            
+            このため, <literal>comp</literal>は非常に特殊な
+            
+            ケースで使用するべきです.
+            
             コンパイルされていない関数を作成するには,
+            
             <link linkend="exec">exec</link> または
+            
             <link linkend="deff">deff</link> に
+            
             オプション  <literal>"n"</literal> を指定する必要があります.
+            
         </para>
-        <para>値 opt==2 は,"プロファイル用に"コンパイルされた
+        
+        <para>
+            
+            値 <literal>opt==2</literal>は,"プロファイル用に"コンパイルされた
+            
             関数を作成します.
+            
             <link linkend="add_profiling">add_profiling</link>関数により,
+            
             コンパイル後でもプロファイル命令を追加することが可能になっています.
+            
         </para>
-        <para>古い opt==1 オプションは
-            コード解析用で無視されます.
+        
+        <para>
+            
+            廃止された <literal>opt==1</literal>オプションは
+            
+            コード解析用であり, 現在では無視されます.
+            
+            すなわち,<literal>opt==0</literal>とみなされます.
+            
         </para>
+        
         <para>注意: コンパイルは"インプレース"で行われます, すなわち,
+            
             元の関数は修正され,新しいオブジェクトは生成されません.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="type">type</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="deff">deff</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="function">function</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="add_profiling">add_profiling</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="profile">profile</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 51ac532..ed81063 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="deff">
+    
     <refnamediv>
+        
         <refname>deff</refname>
+        
         <refpurpose>関数のオンライン定義</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>deff('[s1, s2,...] = newfunction(e1, e2,...)',text [,opt])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>e1, e2, ...</term>
+                
                 <listitem>
+                    
                     <para>入力変数.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>s1, s2, ...</term>
+                
                 <listitem>
+                    
                     <para>出力変数.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>text</term>
+                
                 <listitem>
+                    
                     <para>文字列行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>opt</term>
+                
                 <listitem>
+                    
                     <para>オプションの文字列:</para>
+                    
                     <variablelist>
+                        
                         <varlistentry>
+                            
                             <term>'c'</term>
+                            
                             <listitem>
+                                
                                 <para>実行効率改善のために関数は "コンパイル" されます (デフォルト);</para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>'p'</term>
+                            
                             <listitem>
+                                
                                 <para>関数は"コンパイル"され,
+                                    
                                     プロファイルに備えます (<link linkend="profile">profile</link>参照);
+                                    
                                 </para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                         <varlistentry>
+                            
                             <term>'n'</term>
+                            
                             <listitem>
+                                
                                 <para>関数は"コンパイル"されません.</para>
+                                
                             </listitem>
+                            
                         </varlistentry>
+                        
                     </variablelist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <function>deff</function> はテキスト文字列で記述された一連の命令から
+            
             関数を定義する際に使用されます.
+            
             得られる関数オブジェクトはテキストファイルで定義され,
+            
             <function>exec</function> または <function>exec</function> で
+            
             定義された他の関数と同じ特性を有しています.
+            
         </para>
+        
         <para>
+            
             命令の中の引用符(文字列の区切りまたは行列の転置を意味する)は,
+            
             ただしく解釈されるように二重化する必要があります(<link linkend="quote">quote</link>のヘルプを参照).
+            
             この仕様のため,作成作業はやや不便となります.
+            
             このような場合のオプションとしては,通常と同様に関数を
+            
             ファイルで定義し,
+            
             (<literal>'n'</literal> オプションを付けて)
+            
             <function>exec</function>によりScilabにロードし,
+            
             <function>deff</function> 命令と同じ出力を得るために
+            
             <function>sci2exp</function>を使用するという方法があります.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 deff('[x]=myplus(y,z)','x=y+z')
 deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="comp">comp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="function">function</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="profile">profile</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="quote">quote</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 17f8a7a..f92b102 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="edit" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>edit</refname>
-        <refpurpose>関数の編集</refpurpose>
+        
+        <refpurpose>関数を編集</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>edit(functionname)</synopsis>
+        
+        <synopsis>edit(functionname[,linenumber])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>functionname</term>
+                
                 <listitem>
+                    
                     <para>文字列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
+            <varlistentry>
+                
+                <term>linenumber</term>
+                
+                <listitem>
+                    
+                    <para>整数</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
-        <para>functionname が定義済みの
+        
+        <para>
+            
+            <literal>functionname</literal> が定義済みの
+            
             Scilab関数の名前の場合,
+            
             <literal>edit(functionname)</literal> は
-            関連するファイル <literal>functionname.sci</literal> をオープンしようと
-            します.
+            
+            関連するファイル <literal>functionname.sci</literal> を
+            
+            オープンします.
+            
+        </para>
+        
+        <para>
+            
+            <literal>functionname</literal>が未定義のScilab関数の名前の場合,
+            
+            <literal>edit</literal> はカレントのディレクトリに
+            
+            <literal>functionname.sci</literal>ファイルを作成します.
+            
         </para>
-        <para>functionname が未定義のScilab関数の名前の場合,
-            <literal>edit</literal> は TMPDIR ディレクトリ内に
-            functionname.sciファイルを作成します.
+        
+        <para>
+            
+            <literal>functionname</literal> が有効なマクロまたは
+            
+            関数名でない場合,
+            
+            <literal>edit(functionname)</literal> は
+            
+            <literal>functionname</literal>に等しいファイル名を有する
+            
+            ファイルをオープンします.
+            
         </para>
+        
+        <para>
+            
+            <literal>linenumber</literal> が指定された場合, 
+            
+            ファイルはファイル名自体と同じ名前のマクロの
+            
+            定義を基準としてこの行でオープンします.
+            
+            マクロ定義が見つからない場合,
+            
+            ファイルが指定した<literal>linenumber</literal>行目で
+            
+            オープンされます.
+            
+        </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
-edit('edit')  //この関数へのテキストを指定したエディタをオープン
-edit('myfunction')  //新しい関数に関してエディタをオープン
+        
+        <programlisting role="example"><![CDATA[
+//この関数へのテキストを指定したエディタをオープン
+edit('edit')
+
+//新しい関数に関してエディタをオープン
+edit('myfunction')
+
+//TMPDIRディレクトリのファイルbar.sciをオープン
+edit(fullfile(TMPDIR+'bar.sci'))
+
+// test_run()の定義を基準として
+// ファイルtest_run.sciの123行目をオープン
+edit('test_run', 123)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="manedit">manedit</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="names">names</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="editor">editor</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 87d59c1..fcd0636 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="exec">
+    
     <refnamediv>
+        
         <refname>exec</refname>
+        
         <refpurpose>スクリプトファイルを実行する</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>exec(path [,mode])
+            
             exec(fun [,mode])
+            
             ierr = exec(path, 'errcatch' [,mode])
+            
             ierr = exec(fun, 'errcatch' [,mode])
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>path</term>
+                
                 <listitem>
+                    
                     <para>文字列, スクリプトファイルへのパス</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>mode</term>
+                
                 <listitem>
+                    
                     <para>整数スカラー,実行モード (以下参照)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>fun</term>
+                
                 <listitem>
+                    
                     <para>scilab 関数</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>ierr</term>
+                
                 <listitem>
+                    
                     <para>整数, 0 またはエラー番号</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <code>exec(path [,mode])</code> は,
+            
             <varname>path</varname>で指定したファイルの中のオプションの
-            実行モード<varname>mode</varname> でscilab命令を逐次実行します.
+            
+            実行モード<varname>mode</varname> でScilab命令を逐次実行します.
+            
         </para>
+        
         <para>
+            
             以下の <varname>mode</varname> を指定できます :
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>0</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         デフォルト値.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>-1</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         何も出力しない.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>1</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         各コマンド行を出力(エコーバック)する.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>2</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         プロンプト <literal>--&gt;</literal> を出力する.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>3</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         エコー + プロンプト.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>4</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         各プロンプト出力の前に停止します. キャレッジリターンを入力すると実行が再開します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>7</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         停止 + プロンプト + エコー : デモを行う際に有用なモード.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <para>
+            
             <code>exec(fun [,mode])</code> は関数
+            
             <varname>fun</varname> をスクリプトとして実行します:
+            
             入出力の引数も特定の変数環境もありません.
-            スクリプトコードはプリコンパイル(<link linkend="comp">comp</link>参照)されるため,
-            この形式は最も効率的です.
+            
+            スクリプトコードはプリコンパイル(<link linkend="comp">comp</link>参照)
+            
+            できるため,この形式は最も効率的です.
+            
             スクリプト評価のこの方法により,スクリプトをライブラリの
-            関数として保持することが可能になります.
+            
+            関数として保存することが可能になります.
+            
         </para>
-        <para>実行時にエラーが発生し,
+        
+        <para>
+            
+            実行時にエラーが発生し,
+            
             <literal>'errcatch'</literal>フラグが指定されている場合,
+            
             <function>exec</function>はエラーメッセージを出力せずに
+            
             命令を実行を破棄し,エラー番号を<varname>ierr</varname>に
+            
             代入して復帰します.
+            
             <literal>'errcatch'</literal> フラグが存在しない場合,標準のエラー処理が
+            
             機能します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
-        <title>注意k</title>
+        
+        <title>注意</title>
+        
         <para>
+            
             <function>exec</function> ファイルは,
-            インライン関数定義構文(関数の項参照)により関数を定義する際に使用されます.
+            
+            インライン関数定義構文(関数の項参照)により関数を定義する際に使用されます
+            
+            (<link linkend="function">function</link>参照).
+            
+        </para>
+        
+        <para>
+            
+            <function>exec</function> はANSI/アスキー および UTF-8 エンコード
+            
+            されたファイルをサポートします.
+            
         </para>
+        
+        <para>ファイル中の各行の長さは 4096 文字に制限されています.</para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 // スクリプトファイルを作成
 mputl('a=1;b=2',TMPDIR+'/myscript')
@@ -156,28 +308,54 @@ exec(foo)
 whos -name "a "
 whos -name "y "
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="execstr">execstr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="evstr">evstr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="comp">comp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="mode">mode</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="chdir">chdir</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="pwd">pwd</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index e8376e6..88b68db 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="execstr">
+    
     <refnamediv>
+        
         <refname>execstr</refname>
+        
         <refpurpose>文字列中のScilabコードを実行</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>execstr(instr)
+            
             ierr = execstr(instr, 'errcatch' [,msg])
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>instr</term>
+                
                 <listitem>
+                    
                     <para>文字列のベクトル, 実行するScilab命令.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>ierr</term>
+                
                 <listitem>
+                    
                     <para>整数, 0 ばたはエラー番号.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>msg</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         値<literal>'m'</literal> または<literal>'n'</literal>
+                        
                         を有する文字列.
+                        
                         デフォルト値は<literal>'n'</literal>.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             引数<varname>instr</varname>で指定したScilab命令を実行します.
+            
         </para>
+        
         <note>
-            <varname>instr</varname>の中では継続記号 (..) を使用する必要は
-            ないことに注意してください.
+            
+            <varname>instr</varname>の中では継続記号 (..) を使用する
+            
+            べきではないことに注意してください.
+            
         </note>
+        
         <para>
+            
             <literal>'errcatch'</literal>フラグが指定されない場合,
+            
             エラー処理は通常と同様に行われます.
+            
         </para>
+        
         <para>
+            
             <literal>'errcatch'</literal>フラグが指定された場合,
+            
             <varname>instr</varname>で定義された命令を実行す際に
+            
             発生したエラーはエラーメッセージを発生せず,
+            
             <varname>instr</varname> 命令の実行を
+            
             (エラーが発生した場所で)破棄し,
+            
             エラー番号に等しい<varname>ierr</varname>を返して
+            
             復帰します.
+            
             この場合,エラーメッセージの出力は
+            
             <varname>msg</varname>オプションにより次のように
+            
             制御されます:
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>"m"</term>
+                
                 <listitem>
+                    
                     <para>エラーメッセージは表示され,記録されます.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>"n"</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         エラーメッセージは表示されませんが,
+                        
                         記録されます ( <link linkend="lasterror">lasterror</link>参照).
+                        
                         これがデフォルトです.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <para>
+            
             <code>ierr = execstr(instr, 'errcatch')</code> は構文エラーも
+            
             処理することができます.
+            
             この特徴は,ユーザへの問い合わせにより得られた命令を
+            
             評価する際に有用です.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 execstr('a=1') // sets a=1.
 execstr('1+1') // does nothing (while evstr('1+1') returns 2)
@@ -130,22 +222,42 @@ else
    disp("execstr is happy");
 end
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="evstr">evstr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lasterror">lasterror</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="error">error</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="try">try</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index c6c157b..82ab879 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="fun2string">
+    
     <refnamediv>
+        
         <refname>fun2string</refname>
+        
         <refpurpose>Scilab関数のアスキー定義を生成する</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>txt = fun2string(fun, name)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>fun</term>
+                
                 <listitem>
-                    <para>関数型変数</para>
+                    
+                    <para>
+                        <literal>function</literal>型変数
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>name</term>
+                
                 <listitem>
+                    
                     <para>文字列, 生成した関数名</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>txt</term>
+                
                 <listitem>
+                    
                     <para>文字列の列ベクトル, Scilab関数を指定するテキスト</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
-            ロード済みのScilab関数の擬似コードを指定すると,<function>fun2string</function> により,
+            
+            ロード済みのScilab関数の擬似コードを指定すると,
+            
+            <function>fun2string</function> により,
+            
             そのコードを再度生成することができます.
+            
             生成したコードはインデントされ, 整形されます.
+            
         </para>
+        
         <para>
+            
             仕組みは<function>mfile2sci</function>に似ていますが, より簡単です.
+            
             構文の変換に使用することも可能です.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 txt = fun2string(asinh,'foo');
 write(%io(2),txt,'(a)')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="edit">edit</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macrovar">macrovar</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index e5041fe..1250e71 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="funcprot">
+    
     <refnamediv>
+        
         <refname>funcprot</refname>
+        
         <refpurpose>Scilab関数保護モードを切替える</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
+        
         <synopsis>funcprot(prot)
+            
             previousprot = funcprot(prot)
+            
             prot = funcprot()
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>prot</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         整数で,指定可能な値は 0,1,2となります
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
+            <varlistentry>
+                
+                <term>previousprot</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        整数で,指定可能な値は 0,1,2,
+                        
+                        前の値を返します
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             Scilab 関数が変数の場合,
+            
             <function>funcprot</function> によりこのような変数が再定義された場合の
+            
             Scilabの動作をユーザが指定することができます.
+            
         </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
-                     <code>prot==0</code> の場合, 何も特別なことは行われません
+                    
+                    <code>prot==0</code> の場合, 何も特別なことは行われません
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
+                    
                     <code>prot==1</code>  の場合, 関数が再定義された時に
+                    
                     警告メッセージを出力します (デフォルトのモード).
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>
-                     <code>prot==2</code> の場合,関数が再定義された時に
+                    
+                    <code>prot==2</code> の場合,関数が再定義された時に
+                    
                     Scilabはエラーを発生します.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 previousprot = funcprot(1)
 deff('x = foo(a)','x = a;')
@@ -64,14 +137,32 @@ deff('x = foo(a)', 'x = a + 1;')
 foo = 33
 funcprot(previousprot)
 ]]></programlisting>
+        
     </refsection>
+    
     <refsection>
+        
         <title>History</title>
+        
         <revhistory>
+            
             <revision>
+                
                 <revnumber>5.4.0</revnumber>
-                <revremark>Previous value is returned as output argument when setting a new value.</revremark>
+                
+                <revremark>
+                    
+                    前の値は,新規値を設定する際に
+                    
+                    出力引数として返されます.
+                    
+                </revremark>
+                
             </revision>
+            
         </revhistory>
+        
     </refsection>
+    
 </refentry>
+
index 3a0db70..277b19a 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="function">
+    
     <refnamediv>
+        
         <refname>function</refname>
+        
         <refpurpose>関数定義をオープンする</refpurpose>
+        
     </refnamediv>
+    
     <refnamediv xml:id="endfunction">
+        
         <refname>endfunction</refname>
+        
         <refpurpose>関数定義を閉じる</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <programlisting role='no-scilab-exec'><![CDATA[
 function <lhs_arguments>=<function_name><rhs_arguments>
   <statements>
 endfunction
- ]]></programlisting>
+    ]]></programlisting>
+        
         <para>
+            
             ただし,
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>&lt;function_name&gt;</term>
+                
                 <listitem>
+                    
                     <para>は関数の名前を意味します.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>&lt;rhs_arguments&gt;</term>
+                
                 <listitem>
+                    
                     <para>は入力引数のリストを意味します.</para>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>
-                                これは,<literal>(x1,...,xm)</literal>のように括弧で括った
+                                
+                                <literal>(x1,...,xm)</literal>のように括弧で括った
+                                
                                 カンマ区切りの変数名の一覧となります.
-                                最後の変数名はキーワード<literal>varargin</literal>とすることも可能です
+                                
+                                最後の変数名はキーワード<literal>varargin</literal>と
+                                
+                                することも可能です
+                                
                                 (<link linkend="varargin">varargin</link> 参照)
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
-                                関数に入力引数がない場合, <literal>()</literal> または何も付けません.
+                                
+                                関数に入力引数がない場合, <literal>()</literal> または
+                                
+                                何も付けません.
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>&lt;lhs_arguments&gt;</term>
+                
                 <listitem>
+                    
                     <para>は出力引数のリストを意味します.</para>
+                    
                     <itemizedlist>
+                        
                         <listitem>
+                            
                             <para>
-                                これは,<literal>[y1,...,yn]</literal>のように角括弧で括ったカンマ区切りの
-                                変数名の一覧となります.
-                                最後の変数名はキーワード <literal>varargout</literal> (<link linkend="varargout">varargout</link> 参照)とすること
+                                
+                                これは,<literal>[y1,...,yn]</literal>のように角括弧で括った
+                                
+                                カンマ区切りの変数名の一覧となります.
+                                
+                                最後の変数名はキーワード <literal>varargout</literal> 
+                                
+                                (<link linkend="varargout">varargout</link> 参照)とすること
+                                
                                 が可能です.
+                                
                             </para>
+                            
                         </listitem>
+                        
                         <listitem>
+                            
                             <para>
+                                
                                 関数が出力引数を持たない場合,<literal>[]</literal> を指定します.
+                                
                                 この場合,構文を以下のようにすることも可能です:
+                                
                                 <literal>function &lt;function_name&gt;&lt;rhs_arguments&gt;</literal>
+                                
                             </para>
+                            
                         </listitem>
+                        
                     </itemizedlist>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>&lt;statements&gt;</term>
+                
                 <listitem>
-                    <para>Scilab命令(ステートメント)の集合を意味します.
+                    
+                    <para>
+                        
+                        Scilab命令(ステートメント)の集合を意味します.
+                        
                         この構文は,インラインまたはスクリプトファイル(exec 参照)の中で
+                        
                         関数を定義する (<link linkend="functions">functions</link> 参照)ために使用できます.
+                        
                         古いバージョンのScilabとの互換性のため,
+                        
                         function 定義のみを含むスクリプトファイルで定義された関数は,
+                        
                         <literal>exec</literal>関数によりScilabに"ロードする"ことができます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <para>
+            
             <literal>function &lt;lhs_arguments&gt;=&lt;function_name&gt;&lt;rhs_arguments&gt;</literal>
+            
             のシーケンスは複数の行に分割することができません.
+            
             このシーケンスはカンマまたはセミコロンを終端に付けることにより,
+            
             同じ行に命令を続けることができます.
+            
         </para>
+        
         <note>
-            Note that <literal>&lt;function_name&gt;</literal> must respect some syntax rules (see <link linkend="names">names</link>).
+            
+            <literal>&lt;function_name&gt;</literal> は
+            
+            いくつかの構文規則に従う必要があることに注意してください
+            
+            (<link linkend="names">names</link>参照).
+            
         </note>
+        
         <para>
+            
             function の定義はネストすることが可能です.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
-//inline definition
+//インライン定義 (function参照)
 function [x,y]=myfct(a,b)
 x=a+b
 y=a-b
 endfunction
+
 [x,y]=myfct(3,2)
-//行内での関数定義
+
+//1行で関数定義
 function y=sq(x),y=x^2,endfunction
+
 sq(3)
+
 //関数定義のネスト
 function y=foo(x)
 a=sin(x)
 function y=sq(x), y=x^2,endfunction
 y=sq(a)+1
 endfunction
+
 foo(%pi/3)
+
 // スクリプトファイル内での定義 (exec参照)
 exec SCI/modules/elementary_functions/macros/asinh.sci;
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="functions">functions</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="names">names</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 4cf91a0..eb82862 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="functions">
+    
     <refnamediv>
+        
         <refname>functions</refname>
+        
         <refpurpose>Scilab プロシージャおよび  Scilab オブジェクト</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
-        <para>functions は Scilab プロシージャ ("macro", "function" および "procedure"
-            have the save meaning)です.
+        
+        <para>functions は Scilab プロシージャです
+            
+            "macro", "function" および 
+            
+            "procedure"は同じ意味を有します).
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>関数定義</title>
+        
         <para>
+            
             通常,これらはエディタによりファイルで定義され,
+            
             <link linkend="exec">exec</link>関数またはライブラリ
-            (<link linkend="lib">lib</link> または <link linkend="genlib">genlib</link>参照)
+            
+            (<link linkend="lib">lib</link> または 
+            
+            <link linkend="genlib">genlib</link>参照)
+            
             によりScilabにロードされます.
+            
             しかし,オンライン定義
-            (<link linkend="deff">deff</link> または <link linkend="function">function</link>参照)
+            
+            (<link linkend="deff">deff</link> または 
+            
+            <link linkend="function">function</link>参照)
+            
             することも可能です.
+            
             関数は以下の2つの要素により定義されます::
+            
         </para>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>以下のような "構文定義" 部:</para>
+                
                 <programlisting role='no-scilab-exec'><![CDATA[
 function [y1,...,yn]=foo(x1,...,xm)
 function [y1,...,yn,varargout]=foo(x1,...,xm,varargin)
  ]]></programlisting>
+                
             </listitem>
+            
             <listitem>
+                
                 <para>一連のScilab命令.</para>
+                
             </listitem>
+            
         </itemizedlist>
+        
         <para>"構文定義" 行はこの関数の"完全な"呼び出し手順を指定します.
+            
             <literal>yi</literal> は,入力変数<literal>xi</literal>と
+            
             その関数が実行された際にScilabに存在する変数の関数として
+            
             計算される出力変数です.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>呼び出し手順</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     通常,関数の呼び出し手順は
+                    
                     <literal>[y1,...,yn]=foo(x1,...,xm)</literal>となります.
+                    
                     入力または出力引数の一覧を定義より短くすることができます.
+                    
                     このような場合,
+                    
                     左辺の先頭のいくつかの変数のみが使用され設定されます.
+                    
                 </para>
-                <para>呼び出し時の引数の実際の数は,
+                
+                <para>
+                    
+                    呼び出し時の引数の実際の数は,
+                    
                     <link linkend="argn">argn</link> により取得することができます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
-                <para>It is possible to define function with indeterminate
-                    number of input or output maximum number of arguments. This
-                    can be done using the <link linkend="varargin">varargin</link>
-                    and <link linkend="varargout">varargout</link>
-                    keywords. See the given links for details.
+                
+                <para>
+                    
+                    入力または出力最大引数の数が不定の
+                    
+                    関数を定義することができます.
+                    
+                    これは, <link linkend="varargin">varargin</link>および
+                    
+                    <link linkend="varargout">varargout</link>キーワードを
+                    
+                    使用して行います.
+                    
+                    詳細は指定したリンクを参照ください.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
-                <para>It is also possible to use "named argument" to specify input
-                    arguments: suppose function <function>fun1</function> defined as
-                    <code>function y1 = fun1(x1, x2, x3)</code> then it can be
-                    called with a syntax like <code>y = fun1(x1=33, x3=[1 2 3])</code>
-                    within <function>fun1</function> x2 will be
-                    undefined,
+                
+                <para>
+                    
+                    入力引数を指定する際に"名前付きの引数"を使用することも
+                    
+                    可能です:
+                    
+                    関数<function>fun1</function>が
+                    
+                    <code>function y1 = fun1(x1, x2, x3)</code>と
+                    
+                    定義されていると仮定すると,<function>fun1</function>を
+                    
+                    <code>y = fun1(x1=33, x3=[1 2 3])</code>のような
+                    
+                    構文でコールすることもできます.
+                    
+                    x2 は未定義となります.
+                    
                 </para>
-                <para> it can also be called with a syntax like
-                    <code>y = fun1(x1=33, y='foo')</code>. In such a case the
-                    <varname>y</varname> variable will be available in the context
-                    of the function <function>fun1</function>.
+                
+                <para> 
+                    
+                    <code>y = fun1(x1=33, y='foo')</code>のような構文で
+                    
+                    コールすることも可能です.
+                    
+                    このような場合,<varname>y</varname> 変数を
+                    
+                    関数<function>fun1</function>のコンテキストで
+                    
+                    利用可能となります.
+                    
                     <note>
-                        Note that the maximum number of argument must be
-                        less or equal to the number of formal input
-                        argument used in the function syntax part.
+                        
+                        引数の最大数は関数構文部で使用される
+                        
+                        形式的な入力引数の数以下とする必要があることに注意してください.
+                        
                     </note>
+                    
                 </para>
-                <para> It is possible to check for defined variables with the
-                    <link linkend="exists">exists</link> function.
+                
+                <para> 
+                    
+                    定義された変数を
+                    
+                    <link linkend="exists">exists</link> 関数で
+                    
+                    確認することができます.
+                    
                 </para>
+                
             </listitem>
+            
             <listitem>
-                <para>When a function has no left hand side argument and is called only
-                    with character string arguments, the calling syntax may be
-                    simplified:
+                
+                <para>
+                    
+                    関数が左辺の引数を有さず,
+                    
+                    文字列引数でのみコールされた場合,
+                    
+                    呼び出し手順を以下のように簡単化できます:
+                    
                 </para>
+                
                 <programlisting role='no-scilab-exec'><![CDATA[
 fun('a','toto','a string')
  ]]></programlisting>
-                <para>is equivalent to: </para>
+                
+                <para>は以下と等価です: </para>
+                
                 <programlisting role='no-scilab-exec'><![CDATA[
 fun a toto 'a string'
  ]]></programlisting>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection>
-        <title>Miscellaneous</title>
+        
+        <title>その他</title>
+        
         <para>
-            Functions are Scilab objects (with type numbers 13 or 11). They
-            and can be manipulated (built, saved, loaded, passed as
-            arguments,...) as other variable types.
+            
+            関数はScilabオブジェクト(型番号は13または11)です. 
+            
+            関数は他の変数型と同様に操作
+            
+            (構築, 保存, 読込み, 引数として指定)できます.
+            
         </para>
-        <para>Collections of functions can be collected in libraries.  Functions
-            which begin with <literal>%</literal> sign
-            (e.g. <literal>%foo</literal>) are often used to overload (see <link linkend="overloading">overloading</link>) operations or functions for new data type.
+        
+        <para>
+            
+            関数の集合は,ライブラリに集約できます.
+            
+            <literal>%</literal> 記号で始まる関数
+            
+            (例: <literal>%foo</literal>)
+            
+            は,しばしば新しいデータ型について演算子や関数をオーバーロード
+            
+            (<link linkend="overloading">オーバーローディング</link>参照)
+            
+            する際に使用されます.
+            
+        </para>
+        
+        <para>
+            
+            関数名はいくつかの構文規約
+            
+            (<link linkend="names">names</link>参照)に従う必要があることに
+            
+            注意してください.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 //インライン定義 (function参照)
 function [x,y]=myfct(a,b)
@@ -138,40 +292,78 @@ deff('[x,y]=myfct(a,b)',['x=a+b';
 // アスキーファイルで定義 (exec参照)
 exec SCI/modules/elementary_functions/macros/asinh.sci;
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="function">function</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="deff">deff</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="comp">comp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="getd">getd</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="genlib">genlib</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exists">exists</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="varargin">varargin</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="varargout">varargout</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index ed1120b..cde9223 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="getd">
+    
     <refnamediv>
+        
         <refname>getd</refname>
+        
         <refpurpose>ディレクトリで定義された全ての関数を取得する</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>getd(path)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>path</term>
+                
                 <listitem>
-                    <para>Scilab文字列. ディレクトリのパス名</para>
+                    
+                    <para>文字列. ディレクトリのパス名</para>
+                    
+                    <para>
+                        
+                        入力引数を指定さずに<function>getd</function>が
+                        
+                        コールされた場合, または <varname>path</varname>が空文字列の
+                        
+                        場合, "."
+                        
+                    </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <varname>path</varname>ディレクトリで定義された
+            
             (Scilab関数を含む)
+            
             全ての <literal>.sci</literal>ファイルをロードします.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 getd('SCI/modules/cacsd/macros')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="pwd">pwd</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="chdir">chdir</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index ae23af8..ebb812b 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA - Serge STEER <serge.steer@inria.fr>
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="head_comments">
+    
     <refnamediv>
+        
         <refname>head_comments</refname>
+        
         <refpurpose>Scilab関数のヘッダのコメントを表示</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
-        <synopsis>head_comments(name)
+        
+        <synopsis>
+            
+            head_comments(name)
+            
             head_comments(name,%paths)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>name</term>
+                
                 <listitem>
+                    
                     <para>文字列, 関数名</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>%paths</term>
+                
                 <listitem>
+                    
                     <para>文字列ベクトル, sci-ファイルを探す場所のパス
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <code>head_comments(name)</code> は,
+            
             (Matlabヘルプのように)
+            
             関数ヘッダのコメントを表示します.
+            
             コメントは関連する sci-ファイルから読み込まれます.
+            
             <varname>name</varname>がライブラリ中の関数の場合,
+            
             sci-ファイルはライブラリパスで指定したパスとなります
+            
             (<link linkend="lib">lib</link>参照).
+            
             <varname>name</varname>がライブラリ中ではない関数の場合,
+            
             変数<varname>%paths</varname>で指定したディレクトリの中で
+            
             <varname>name</varname><literal>.sci</literal>という名前のファイルが
+            
             探されます.
+            
         </para>
+        
         <warning>
-            Scilabのほとんどの定義済みの関数はもはやヘッダコメントを
+            
+            警告: Scilabのほとんどの定義済みの関数はもはやヘッダコメントを
+            
             有していません.
+            
         </warning>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 head_comments sinc
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="help">help</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index fc58033..2b6aa59 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="genlib">
+    
     <refnamediv>
+        
         <refname>genlib</refname>
+        
         <refpurpose>指定したディレクトリの関数からライブラリを構築する </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>genlib(lib_name [[,dir_name, [ Force [,verb [,Names]]]])
+            
             genlib(lib_name [,path=dir_name] [,verbose=verb] [,force=Force] [,names=Names])
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>lib_name:  </term>
+                
                 <listitem>
+                    
                     <para>Scilab文字列.  (再)作成するライブラリの変数名.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>dir_name:  </term>
+                
                 <listitem>
+                    
                     <para>Scilab文字列. 
+                        
                         <literal>.sci</literal>-ファイルを探すディレクトリの名前. 
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Force</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         論理値 (デフォルト値は <literal>%f</literal>). 
+                        
                         sci-ファイルの再コンパイルを強制的に行う場合,
+                        
                         <literal>%t</literal>に設定してください.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>verb</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         論理値 (デフォルト値は <literal>%f</literal>). 
+                        
                         情報を取得するには <literal>%t</literal> に設定してください.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>Names</term>
+                
                 <listitem>
+                    
                     <para>文字列のベクトルで, ライブラリに含まれる
+                        
                         関数の名前です.
+                        
                         デフォルトで全ての sci-ファイルが取得されます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>dir_name</literal>にある各<literal>.sci</literal>ファイル
+            
             (または<literal>Names</literal>引数で指定されたファイルのみ)について,
+            
             <literal>genlib</literal>は<literal>exec</literal>を
+            
             実行し,対応する<literal>.bin</literal>ファイルに関数を保存します.
+            
             <literal>.sci</literal>ファイルにはScilab関数以外のものを含んでは
+            
             いけません.
+            
             ある<literal>.bin</literal>ファイルが対応する<literal>.sci</literal>ファイルよりも
+            
             新しい場合, <literal>genlib</literal>はこのファイルを変換/保存しません.
+            
         </para>
+        
         <para>
+            
             このデフォルトの動作は<literal>force</literal>が指定され,
+            
             <literal>%t</literal> に設定された場合に変更できます.
+            
             この場合, 各<literal>.sci</literal>ファイル毎に常に再コンパイルが
+            
             行われます.
+            
         </para>
+        
         <para>
+            
             全ての<literal>.sci</literal> ファイルが処理された場合,
+            
             <literal>genlib</literal>は<literal>lib_name</literal>という
+            
             名前のライブラリ変数を作成し,
+            
             <literal>dir_name</literal>の中のファイル<literal>lib</literal>に
+            
             この変数を保存します.
+            
             Scilab変数
+            
             <literal>lib_name</literal>が保護されていない場合
+            
             (<link linkend="predef">predef</link>参照), 
+            
             この変数は更新されます.
+            
         </para>
+        
         <para>
+            
             <literal>verbose</literal> に <literal>%t</literal>が
+            
             指定された場合, 構築処理中に情報が表示されます.
+            
         </para>
+        
         <para>
+            
             <literal>dir_name</literal> 引数が指定されない場合に,
+            
             Scilab変数<literal>lib_name</literal>が存在し,
+            
             それがライブラリの場合,
+            
             dir_name は,
+            
             <literal>lib_name</literal>ライブラリパスに等しく
+            
             設定されます (更新モード).
+            
         </para>
+        
     </refsection>
+    
     <refsection>
-        <title>制限</title>
+        
+        <title>制約</title>
+        
         <para>
+            
             Scilab は, ファイル<literal>foo.sci</literal>が,
+            
             少なくとも<literal>foo</literal>という名前の関数を
+            
             定義すると仮定します.
+            
             補助関数が含まれる場合,これらは
+            
             関数<literal>foo</literal>が参照された後でのみ
+            
             Scilabから既知となります.
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="getd">getd</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="save">save</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 9183f02..0e05b18 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="get_function_path">
+    
     <refnamediv>
+        
         <refname>get_function_path</refname>
+        
         <refpurpose>ライブラリ関数のソースファイルのパスを取得</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>path=get_function_path(fun_name)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>fun_name</term>
+                
                 <listitem>
+                    
                     <para>文字列, 関数名</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>path</term>
+                
                 <listitem>
+                    
                     <para>文字列, 関数ソースファイル(.sci)の絶対パス名または [].</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             関数名を指定すると, 
+            
             その関数が Scilab ライブラリ(lib参照)で定義されている場合,
+            
             get_function_path は関数ソースファイルの
+            
             絶対パス名を返します.
+            
             名前がライブラリ関数に一致しない場合 [] が返されます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 get_function_path('median')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="string">string</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 7c09f5a..363fa02 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="lib">
+    
     <refnamediv>
+        
         <refname>lib</refname>
+        
         <refpurpose>ライブラリ定義</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼出し手順</title>
-        <synopsis>xlib = lib('lib-dir')</synopsis>
+        
+        <synopsis>namelib = lib('lib-dir')</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>lib-dir</term>
+                
                 <listitem>
+                    
                     <para>文字列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
+            <varlistentry>
+                
+                <term>namelib</term>
+                
+                <listitem>
+                    
+                    <para>'lib'により返されるライブラリ変数.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>lib-dir</literal>は,
+            
             コンパイル済みのScilab関数(<literal>.bin</literal>)ファイルを
+            
             含むディレクトリを定義する文字列です.
+            
         </para>
+        
         <para>
+            
             これらのファイルに加えて,<literal>lib-dir</literal> には,
+            
             <literal>lib-dir</literal>で定義された関数の名前を保持する
+            
             <literal>names</literal>という名前のファイルがある必要があります.
+            
             処理が成功すると, <literal>lib-dir</literal> の中の全ての関数が
+            
             Scilabから利用可能になります.
+            
             これらの関数は最初にコールされた時にオンデマンドでロードされます.
+            
         </para>
+        
         <para>
+            
             バイナリファイルは Scilab上でコマンド<literal>save</literal>
+            
             により作成できます.
-        </para>
-        <para>
-            Scilabの標準ライブラリは,
-            <literal>SCIDIR/modules/*/macros/*</literal>サブディレクトリの
-            <literal>lib</literal>により定義されています.
-        </para>
-        <para>
+            
             ライブラリ変数は,通常,
-            オンラインまたはユーザ指定のスタートアップファイル(startupファイル)
+            
+            オンラインまたはユーザ指定のスタートアップファイル(startup参照)
+            
             のどちらかにより,後でロードするために保存されます.
+            
+        </para>
+        
+        <para>
+            
+            このライブラリのマクロ関数にアクセスするには,
+            
+            'lib'により返された値を変数'namelib'に挿入する必要があります.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>制限</title>
+        
         <para>
+            
             Scilab は, 各ファイル xxxx.bin が<literal>xxxx</literal>という名前の
-            変数を定義するものと暗黙裡に仮定します.
+            
+            変数を定義するものと暗黙の内にに仮定します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
-//複数の変数を定義します
-function z = myplus(x, y), z = x + y,endfunction
-function z = yourplus(x, y), x = x - y,endfunction
-A=1:10;
-// *.bin ファイルを libdirに作成
-libdir=TMPDIR
+//いくつかの関数を定義
+function z = myplus(x, y)
+  z = x + y
+endfunction
+
+function z = yourplus(x, y)
+  x = x - y
+endfunction
+
+//*.bin ファイルを libdirに作成
+libdir = TMPDIR;
 save(libdir + '/myplus.bin', myplus);
 save(libdir + '/yourplus.bin', yourplus);
-save(libdir + '/A.bin', A);
+
 //nameファイルを作成
-mputl(['myplus';'yourplus';'A'],TMPDIR+'/names');
-// myplus およびyourplusを含むライブラリを構築
-xlib = lib(libdir+'/')
+mputl(['myplus';'yourplus'],TMPDIR+'/names');
+
+//myplus およびyourplusを含むライブラリを構築
+mylibfoo = lib(libdir+'/');
+
 //変数を消去
-clear myplus yourplus A
+clear myplus yourplus
+
 //自動的にロードし,実行
 myplus(1,2)
-A
+
+//変数を消去
+clear myplus yourplus
+
+mylibfoo
+[n,p] = libraryinfo('mylibfoo')
+
+isdef('myplus')
+clear mylibfoo
+isdef('myplus')
+
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="library">library</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="genlib">genlib</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="save">save</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="deff">deff</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="whereis">whereis</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="libraryinfo">libraryinfo</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index c214758..1682778 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="librarieslist">
+    
     <refnamediv>
+        
         <refname>librarieslist</refname>
+        
         <refpurpose>scilabライブラリを取得</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>s=librarieslist()</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>s</term>
+                
                 <listitem>
+                    
                     <para>文字列行列</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>s</literal>にある
+            
             Scilabスタックの全てのライブラリを返します.
+            
             return in <literal>s</literal> all libraries on scilab stack.
+            
         </para>
+        
         <para>
+            
             ライブラリは最後にロードされたものから最初にロードされたものに
+            
             向かってスキャンされます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 librarieslist()
-// to sort list
+// リストをソート
 l =  gsort(librarieslist(),'r','i')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="libraryinfo">libraryinfo</link>
+                
+            </member>
+            
+            <member>
+                
                 <link linkend="gsort">gsort</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 17e8c9d..6724682 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="libraryinfo">
+    
     <refnamediv>
+        
         <refname>libraryinfo</refname>
+        
         <refpurpose>マクロとscilabライブラリのパスを取得</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>macros = libraryinfo(libraryname)
+            
             [macros,path] = libraryinfo(libraryname)
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>macros</term>
+                
                 <listitem>
+                    
                     <para>文字列行列 (ライブラリの全ての主関数)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>path</term>
+                
                 <listitem>
+                    
                     <para>文字列 (ライブラリのパス)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>libraryname</term>
+                
                 <listitem>
+                    
                     <para>文字列 (ライブラリ名)</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             指定したScilabライブラリの関数名とパスを取得します.
+            
             返される関数名は対応する .sci または .bin のファイルの名前
+            
             に一致します.
+            
             その他の名前は補助関数です.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 [m,p]=libraryinfo('corelib')
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="librarieslist">librarieslist</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index cdbbfdc..2c9ffc5 100644 (file)
@@ -1,28 +1,67 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="whereis">
+    
     <refnamediv>
+        
         <refname>whereis</refname>
+        
         <refpurpose>関数が属するライブラリの名前</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[librname]=whereis(function-name)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             関数<literal>function-name</literal>が属するライブラリの名前を
+            
             文字列として返します.
+            
             ライブラリのパス名は<literal>"librname"</literal>と入力することにより
+            
             返されます.
+            
         </para>
+        
     </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+whereis("ls") // fileiolibを返します
+whereis("plot") // graphicslibを返します
+ ]]></programlisting>
+        
+    </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 56be924..1913268 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="listfunctions">
+    
     <refnamediv>
+        
         <refname>listfunctions</refname>
+        
         <refpurpose>
+            
             ワークスペースの全ての関数のプロパティ
+            
         </refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>[flist,compiled,profilable,called] = listfunctions([scope])</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>パス名</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>scope</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         文字列, <literal>"local"</literal> (デフォルト) または <literal>"global"</literal>
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>flist</term>
+                
                 <listitem>
+                    
                     <para>文字列の配列,
+                        
                         指定した名前空間にある全関数変数の名前
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>compiled</term>
+                
                 <listitem>
+                    
                     <para>論理値配列,
+                        
                         対応する<varname>flist</varname>の要素が型=13の場合に真
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>profilable</term>
+                
                 <listitem>
+                    
                     <para>論理値配列,
+                        
                         対応する<varname>flist</varname>の要素が型=13の場合に真となり,
+                        
                         プロファイル情報が関数の擬似コードの中に追加されます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>called</term>
+                
                 <listitem>
+                    
                     <para>uint32 配列,
+                        
                         <varname>flist</varname> の対応する要素がコールされた回数
+                        
                         (プロファイル可能な関数の場合のみ非ゼロ)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <itemizedlist>
+            
             <listitem>
+                
                 <para>
+                    
                     この関数は,(<link linkend="who">who</link>で指定した)
+                    
                     ワークスペースの全ての変数を確認し,
-                    型11または13の変数を収集します;
-                    後で, <code>lst = macr2lst(fun)</code> が
-                    コールされた際,
-                    最初のコード行の末尾に特殊なプロファイルエントリ
-                    <code>lst(5)(1)=="25"</code> がチェックされます.
+                    
+                    11型または13型の変数を収集します;
+                    
+                    後者の場合, 
+                    
+                    最初のコード行の末尾の特殊なプロファイル用エントリ,
+                    
+                    すなわち,
+                    
+                    <code>lst(5)(1)=="25"</code> をチェックするために,
+                    
+                    <code>lst = macr2lst(fun)</code> がコールされます.
+                    
                 </para>
+                
             </listitem>
+            
         </itemizedlist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 recompilefunction("asinh","p")
 [flist,compiled,profilable,called] = listfunctions();
 flist(profilable)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="function">function</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="deff">deff</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="comp">comp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="fun2string">fun2string</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macr2lst">macr2lst</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="profile">profile</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="recompilefunction">recompilefunction</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="who">who</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>参考文献</title>
+        
         <para>
+            
             http://wiki.scilab.org/Scilab_function_variables%3A_representation%2C_manipulation
+            
         </para>
+        
     </refsection>
+    
 </refentry>
+
index 11e789a..c08b83a 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="macr2lst">
+    
     <refnamediv>
+        
         <refname>macr2lst</refname>
+        
         <refpurpose>リスト変換用の関数</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>lst = macr2lst(function_name)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>Arguments</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>function_name</term>
+                
                 <listitem>
-                    <para>a function to be converted.</para>
+                    
+                    <para>変換する関数.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>lst</term>
+                
                 <listitem>
-                    <para>a list.</para>
+                    
+                    <para>リスト.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             このプリミティブは,コンパイル済みのScilab関数 <varname>function_name</varname>
+            
             を,関数の内部表現をコード化(逆ポーランド表記)したリストに変換します.
+            
         </para>
+        
         <para>
+            
             リストの最初のエントリは関数名,2番目および3番目のエントリは
+            
             それぞれ左辺引数および右辺引数の変数名となります.
+            
             それ以降のエントリは,基本的な演算子レコードもしくは
+            
             <literal>if</literal>, <literal>for</literal>, ... のような制御構造の階層を含むリストのどちらかです.
+            
         </para>
+        
         <para>
+            
             基本的な演算子レコードは, 文字列ベクトルにより記述されます.
+            
             その最初の要素はオペコードを表します.
+            
         </para>
+        
         <informaltable border="1">
+            
             <tr>
+                
                 <td>オペコード</td>
+                
                 <td>意味</td>
+                
                 <td>パラメータ</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"0"</td>
+                
                 <td>無視されるオペコード</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"1"</td>
+                
                 <td>使用停止</td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>"2"</td>
+                
                 <td>変数または関数リファレンス</td>
+                
                 <td>変数名, #rhs, #lhs</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"3"</td>
+                
                 <td>スタック内に文字列を配置</td>
+                
                 <td>文字列</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"4"</td>
+                
                 <td>スタック内に空の行列を配置</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"5"</td>
+                
                 <td>処理を適用</td>
+                
                 <td>処理コード, #rhs,#lhs</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"6"</td>
+                
                 <td>数値をスタックに配置</td>
+                
                 <td>数値</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"12"</td>
+                
                 <td>停止コマンド</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"13"</td>
+                
                 <td>ブレークコマンド</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"14"</td>
+                
                 <td>中断コマンド</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"15"</td>
+                
                 <td>行終端記号</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"17"</td>
+                
                 <td>quit コマンド</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"18"</td>
+                
                 <td>名前のある変数</td>
+                
                 <td>変数名</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"19"</td>
+                
                 <td>再帰的な添え字構造を作成</td>
+                
                 <td>パスの長さ, 最終添え字の番号</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"20"</td>
+                
                 <td>関数コール</td>
+                
                 <td>関数名, #rhs, #lhs </td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"23"</td>
+                
                 <td>名前を指定して変数を作成</td>
+                
                 <td>変数名</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"24"</td>
+                
                 <td>0型の変数をスタックに代入</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"25"</td>
+                
                 <td>プロファイル用レコード</td>
+                
                 <td>コール数, 消費時間 </td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"26"</td>
+                
                 <td>文字列ベクトルをスタック内に配置</td>
+                
                 <td>#rows, #columns, 要素のシーケンス</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"27"</td>
+                
                 <td>組み込みリファレンスをスタックに配置</td>
+                
                 <td>インターフェイス番号, インターフェイス内の位置, 関数名</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"28"</td>
+                
                 <td>continue コマンド</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"29"</td>
+                
                 <td>代入</td>
+                
                 <td>#lhs, 表示モード, (変数名, #rhs)*</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"30"</td>
+                
                 <td>論理値式 省略形</td>
+                
                 <td>型, ジャンプの長さ</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"31"</td>
+                
                 <td>コメント</td>
+                
                 <td>コメント</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>"99"</td>
+                
                 <td>return コマンド</td>
+                
                 <td>なし</td>
+                
             </tr>
+            
             <tr>
+                
                 <td> &gt; "100"</td>
+                
                 <td>組み込みコール (古い)</td>
+                
                 <td>100*fun, #rhs, #lhs, fin</td>
+                
             </tr>
+            
         </informaltable>
+        
         <para>
+            
             <link linkend="fun2string">fun2string</link> 関数は,
+            
             初期コードを生成する際に使用できます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
 //DISPLAY
 function y=foo(x,flag)
@@ -197,22 +384,42 @@ endfunction
 L=macr2lst(foo)
 fun2string(L)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="macrovar">macrovar</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="fun2string">fun2string</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macr2tree">macr2tree</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="tree2code">tree2code</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 2c878bc..af06b65 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="macr2tree">
+    
     <refnamediv>
+        
         <refname>macr2tree</refname>
+        
         <refpurpose>ツリー変換用の関数</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>t=macr2tree(function-name)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>function-name</term>
+                
                 <listitem>
+                    
                     <para>cilabマクロ</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>t</term>
+                
                 <listitem>
+                    
                     <para>Scilab "ツリー"</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             このプリミティブは, コンパイル済みの Scilab 関数<literal>function-name</literal>
+            
             を関数を内部表現にコード化したツリー (鱗状のtlists)に変換します.
+            
             <literal>tree2code</literal>と共に使用します.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 tree=macr2tree(cosh);
 txt=tree2code(tree,%T);
 write(%io(2),txt,'(a)');
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="tree2code">tree2code</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index fa4e713..3a94094 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="macro">
+    
     <refnamediv>
+        
         <refname>macro</refname>
+        
         <refpurpose>Scilabプロシージャおよび Scilabオブジェクト</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             マクロはScilabプロシージャ("macro", "function" および "procedure"
+            
             は同じ意味です)です.
-            通常,これらはエディタによりファイルの中で定義さえ,
-            <function>exec</function>によりまたは
+            
+            通常,これらはエディタによりファイルの中で定義され,
+            
+            <function>exec</function>または
+            
             ライブラリによりScilabにロードされます.
+            
         </para>
+        
         <para>
+            
             マクロをオンラインで定義することも可能です(<link linkend="deff">deff</link>参照).
+            
             マクロを含むファイルは以下のように開始する必要があります:
+            
         </para>
+        
         <programlisting role='no-scilab-exec'><![CDATA[
 function [y1,...,yn]=foo(x1,...,xm)
  ]]></programlisting>
+        
         <para>
+            
             <literal>yi</literal> は,
+            
             入力変数およびマクロが実行される時点でScilabの中に存在する
+            
             変数の関数として計算される出力変数です.
+            
             マクロはより高速に実行するためにコンパイルすることが可能です.
+            
             複数のマクロをライブラリに集約することができます.
+            
             <literal>%</literal>記号で始まり(例: <literal>%foo</literal>),
+            
             その引数がリストであるマクロは,
+            
             特定の処理を実行する際に使用されます:
+            
             例えば, <code>z=%rmr(x,y)</code> は
+            
             <varname>x</varname> および <varname>z</varname>が
+            
             有理数の場合に<code>z=x*y</code>と等価です.
+            
             (すなわち, 多項式<varname>n</varname> および
+            
             <varname>d</varname> を指定した <code>x=list('r',n,d,[])</code>)
+            
         </para>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="deff">deff</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="comp">comp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="lib">lib</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index d7e10be..51c1e8b 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="macrovar">
+    
     <refnamediv>
+        
         <refname>macrovar</refname>
+        
         <refpurpose>関数の変数</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>vars = macrovar(function)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>vars</term>
+                
                 <listitem>
+                    
                     <para>
-                        リスト  <literal>list(in,out,nolocal,called,locals)</literal>.
+                        
+                        リスト,
+                        
+                        <literal>list(in, out, nolocal, called, locals)</literal>.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>function</term>
+                
                 <listitem>
+                    
                     <para>関数名.</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             関数で使用される変数の集合のリストを返します.
-            <varname>vars</varname> は5つの文字列の列ベクトルからなる
+            
+            <varname>vars</varname> は以下の5つの文字列の列ベクトルからなる
+            
             リストです:
+            
         </para>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <varname>in</varname> 入力変数 (<code>vars(1)</code>);
+                
             </member>
+            
             <member>
+                
                 <varname>out</varname>: 出力変数 (<code>vars(2)</code>);
+                
             </member>
+            
             <member>
+                
                 <varname>nolocal</varname>:
+                
                 関数内で定義されていない関数でない変数を参照
+                
                 (<code>vars(3)</code>);
+                
             </member>
+            
             <member>
+                
                 <varname>called</varname>: コールされた関数の名前 (<code>vars(4)</code>);
+                
             </member>
+            
             <member>
+                
                 <varname>locals</varname>: ローカル変数 (<code>vars(5)</code>).
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[
-deff('y=f(x1,x2)','loc=1;y=a*x1+x2-loc')
-vars=macrovar(f)
+deff('y = f(x1, x2)', 'loc = 1; y = a*x1+x2-loc');
+vars = macrovar(f)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="string">string</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="macr2lst">macr2lst</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 926164d..3099ad1 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2009 - DIGITEO - Allan CORNET
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="mode" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>mode</refname>
+        
         <refpurpose>ファイル実行のモードを選択</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>mode(k)
+            
             k = mode()
+            
         </synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             ファイル実行またはScilab関数の中で<emphasis role="bold">排他的に</emphasis>に
+            
             使用され,<literal>mode(k)</literal>は<literal>k</literal>の値に応じて
+            
             次のように実行時に表示される情報を変更することができます:
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>k = 0</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         新しい変数の値が必要に応じて表示されます
-                        (セミコロンまたはカンマのヘルプを参照).
+                        
+                        (<link linkend="semicolon">セミコロン</link>
+                        
+                        または
+                        
+                        <link linkend="comma">カンマ</link>のヘルプを参照).
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k = -1</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         ファイル実行またはScilab関数の実行時の
+                        
                         表示を行いません.
+                        
                         (これはScilab関数に関するデフォルト値です)
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k = 2</term>
+                
                 <listitem>
+                    
                     <para>Scilabプロンプトのデフォルト値.</para>
+                    
                     <para>
-                        このモードはプロンプトでは使用されず,
-                        ファイル実行またはScilab関数でのみ使用されることに注意してください.
+                        
+                        <literal>mode(2)</literal>はプロンプトでは使用されず,
+                        
+                        ファイル実行またはScilab関数でのみ使用されることに
+                        
+                        注意してください.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k = 1 または k = 3</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         命令の各行はプロンプトの前に表示されます.
+                        
                         新しい変数の値は必要に応じて表示されます.
+                        
                         これはファイル実行時のデフォルトです.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k = 4 または k = 7</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         新しい変数の値は必要に応じて表示され,
+                        
                         各行の命令は表示され,
+                        
                         プロンプト (&gt;&gt;) がキャレッジリターンを待つ各行の
+                        
                         後に出力されます.
+                        
                     </para>
+                    
                     <para>キャレッジリターンの後に "p" が続く場合,
+                        
                         実行は中断されています(<link linkend="pause">pause</link>参照).
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>k &gt; 7</term>
+                
                 <listitem>
+                    
                     <para>ユーザモード. ユーザが独自のモードを定義した場合,
+                        
                         100 より大きい値を使用することが推奨されます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <para>
-            コンパイル済みのScilab関数(comp参照)の場合,行の表示は無効化されます.
+            
+            コンパイル済みのScilab関数(<link linkend="comp">comp</link>参照)
+            
+            の場合,行の表示は無効化されます.
+            
             デフォルトでScilab関数はサイレントモード("-1")で実行されます.
+            
         </para>
+        
         <para>関数ライブラリ内の関数は, "-1" モードで実行されます.</para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 // scilab内にコピー/ペーストしてください
 function example_mode( level_mode )
@@ -115,22 +214,42 @@ example_mode(3)
 example_mode(7)
 mode(2)
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="exec">exec</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="execstr">execstr</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="semicolon">semicolon</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="comma">comma</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index 1ff7d4e..17481d9 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="overloading" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>overloading</refname>
+        
         <refpurpose>表示,関数および演算子オーバーロード機能</refpurpose>
+        
     </refnamediv>
+    
     <refsection>
+        
         <title>説明</title>
-        <para>Scilabにおいては, 変数表示, 関数および演算子は 関数(Scilabコードまたはプリミティブ)により新規オブジェクト用に
+        
+        <para>
+            
+            Scilabにおいては, 変数表示, 関数および演算子は
+            
+            関数(Scilabコードまたはプリミティブ)により新規オブジェクト用に
+            
             定義することができます.
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>表示</term>
+                
                 <listitem>
+                    
                     <para>
+                        
                         <literal>tlist</literal>により定義される 新規オブジェクトの表示は,
-                        オーバーロードすることができます (デフォルトの表示は<literal>list</literal>の出力に似ています).
+                        
+                        オーバーロードすることができます
+                        
+                        (デフォルトの表示は<literal>list</literal>の出力に似ています).
+                        
                         オーバーロード関数は入力引数を1つとし,出力引数を持たない必要があります.
-                        その関数の名前は,<literal>%&lt;tlist_type&gt;_p</literal>のように 作成します. ただし,
+                        
+                        その関数の名前は,<literal>%&lt;tlist_type&gt;_p</literal>のように 作成します. 
+                        
+                        ただし,
+                        
                         <literal>%&lt;tlist_type&gt;</literal> は,
-                        <literal>tlist</literal>型の要素の最初のエントリを 最初の9文字に丸めたものを意味します.
+                        
+                        <literal>tlist</literal>型の要素の最初のエントリを
+                        
+                        最初の9文字に丸めたものを意味します.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
             <varlistentry>
+                
                 <term>演算子</term>
+                
                 <listitem>
-                    <para>指定したオペランド型について定義されていない各演算子を 定義することができます.
-                        オーバーロード関数は入力引数を1つ,オペランドの数に基づき 1個または2個の入力を有する必要があります.
+                    
+                    <para>
+                        
+                        指定したオペランド型について定義されていない各演算子を定義することができます.
+                        
+                        オーバーロード関数は入力引数を1つ,オペランドの数に基づき 1個または
+                        
+                        2個の入力を有する必要があります.
+                        
                         関数名は以下のように作成されます:
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
         <para>2項演算子の場合:
+            
             <literal>%&lt;first_operand_type&gt;_&lt;op_code&gt;_&lt;second_operand_type&gt;</literal>
+            
         </para>
+        
         <para>単項演算子の場合:
+            
             <literal>%&lt;operand_type&gt;_&lt;op_code&gt;</literal>
+            
         </para>
+        
         <para>n項演算子の展開および挿入は以下のように記述されます.</para>
+        
         <warning>
+            
             <function>typename</function>関数に登録された型のみが
+            
             オーバーロードマクロの中で使用できることに注意してください.
+            
         </warning>
+        
         <para>
+            
             <literal>&lt;operand_type&gt;</literal>,
+            
             <literal>&lt;first_operand_type&gt;</literal>,
-            <literal>&lt;second_operand_type&gt;</literal> は, 以下のテーブルに記述された各データ型に関連する
-            文字の並びです:
+            
+            <literal>&lt;second_operand_type&gt;</literal> は, 
+            
+            以下のテーブルに記述された各データ型に関連する文字シーケンスです:
+            
         </para>
+        
         <informaltable border="1">
+            
             <tr>
+                
                 <td>データ型</td>
+                
                 <td>文字コード</td>
+                
                 <td>typeof</td>
+                
                 <td>コメント</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>double行列</td>
+                
                 <td>
+                    
                     <literal>s</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>定数</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>多項式行列</td>
+                
                 <td>
+                    
                     <literal>p</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>多項式</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>論理値行列</td>
+                
                 <td>
+                    
                     <literal>b</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>論理値</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>疎行列</td>
+                
                 <td>
+                    
                     <literal>sp</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>疎行列</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>論理値疎行列</td>
+                
                 <td>
+                    
                     <literal>spb</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>論理値疎行列</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>Matlab 疎行列</td>
+                
                 <td>
+                    
                     <literal>msp</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>Matlab疎行列</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>整数行列</td>
+                
                 <td>
+                    
                     <literal>i</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>int8, int16, int32, uint8, uint16, uint32</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>文字列行列</td>
+                
                 <td>
+                    
                     <literal>c</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>文字列</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>ハンドル</td>
+                
                 <td>
+                    
                     <literal>h</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>ハンドル</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>コンパイルされた関数</td>
+                
                 <td>
+                    
                     <literal>fptr</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>fptr</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>スクリプト関数</td>
+                
                 <td>
+                    
                     <literal>mc</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>関数</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>ライブラリ</td>
+                
                 <td>
+                    
                     <literal>l</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>ライブラリ</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>リスト</td>
+                
                 <td>
+                    
                     <literal>l</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>リスト</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>tlist</td>
+                
                 <td>
+                    
                     <literal>tlist型</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>tlist型</literal>
+                    
                 </td>
+                
                 <td>最初のtlistエントリの最初の文字列</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>mlist</td>
+                
                 <td>
+                    
                     <literal>mlist型</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>mlist型</literal>
+                    
                 </td>
+                
                 <td>最初のmlistエントリの最初の文字列</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>ハイパー行列</td>
+                
                 <td>
+                    
                     <literal>hm</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>hypermat</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>ポインタ</td>
+                
                 <td>
+                    
                     <literal>ptr</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>ポインタ</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>セル</td>
+                
                 <td>
+                    
                     <literal>ce</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>ce</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>structure</td>
+                
                 <td>
+                    
                     <literal>st</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>st</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>有理数</td>
+                
                 <td>
+                    
                     <literal>r</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>有理数</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>線形状態空間</td>
+                
                 <td>
+                    
                     <literal>lss</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>状態空間</literal>
+                    
                 </td>
+                
                 <td/>
+                
             </tr>
+            
             <tr>
+                
                 <td>暗黙の多項式</td>
+                
                 <td>
+                    
                     <literal>ip</literal>
+                    
                 </td>
+                
                 <td>
+                    
                     <literal>size implicit</literal>
+                    
                 </td>
+                
                 <td>1:1:$</td>
+                
             </tr>
+            
         </informaltable>
+        
         <para>
+            
             <literal>&lt;op_code&gt;</literal> は, 以下のテーブルに記述された
+            
             各演算子に関連する文字です:
+            
         </para>
+        
         <informaltable border="1">
+            
             <tr>
+                
                 <td>
+                    
                     <literal>op</literal>
+                    
                 </td>
+                
                 <td>char code</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>'</literal>
+                    
                 </td>
+                
                 <td>t</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>+</literal>
+                    
                 </td>
+                
                 <td>a</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>-</literal>
+                    
                 </td>
+                
                 <td>s</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>*</literal>
+                    
                 </td>
+                
                 <td>m</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>/</literal>
+                    
                 </td>
+                
                 <td>r</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>\</literal>
+                    
                 </td>
+                
                 <td>l</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>^</literal>
+                    
                 </td>
+                
                 <td>p</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>.*</literal>
+                    
                 </td>
+                
                 <td>x</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>./</literal>
+                    
                 </td>
+                
                 <td>d</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>.\</literal>
+                    
                 </td>
+                
                 <td>q</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>.*.</literal>
+                    
                 </td>
+                
                 <td>k</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>./.</literal>
+                    
                 </td>
+                
                 <td>y</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>.\.</literal>
+                    
                 </td>
+                
                 <td>z</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>:</literal>
+                    
                 </td>
+                
                 <td>b</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>*.</literal>
+                    
                 </td>
+                
                 <td>u</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>/.</literal>
+                    
                 </td>
+                
                 <td>v</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>\.</literal>
+                    
                 </td>
+                
                 <td>w</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>[a,b]</literal>
+                    
                 </td>
+                
                 <td>c</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>[a;b]</literal>
+                    
                 </td>
+                
                 <td>f</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>() extraction</literal>
+                    
                 </td>
+                
                 <td>e</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>() insertion</literal>
+                    
                 </td>
+                
                 <td>i</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>==</literal>
+                    
                 </td>
+                
                 <td>o</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>&lt;&gt;</literal>
+                    
                 </td>
+                
                 <td>n</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>|</literal>
+                    
                 </td>
+                
                 <td>g</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>&amp;</literal>
+                    
                 </td>
+                
                 <td>h</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>.^</literal>
+                    
                 </td>
+                
                 <td>j</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>.'</literal>
+                    
                 </td>
+                
                 <td>0</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>&lt;</literal>
+                    
                 </td>
+                
                 <td>1</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>&gt;</literal>
+                    
                 </td>
+                
                 <td>2</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>&lt;=</literal>
+                    
                 </td>
+                
                 <td>3</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>&gt;=</literal>
+                    
                 </td>
+                
                 <td>4</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>~</literal>
+                    
                 </td>
+                
                 <td>5</td>
+                
             </tr>
+            
             <tr>
+                
                 <td>
+                    
                     <literal>iext</literal>
+                    
                 </td>
+                
                 <td>6</td>
+                
             </tr>
+            
         </informaltable>
+        
         <para>
+            
             展開構文<literal>b=a(i1,...,in)</literal>の オーバーロード関数は,
+            
             以下のような呼び出し手順となります:
+            
             <literal>b=%&lt;type_of_a&gt;_e_(i1,...,in,a)</literal>
+            
         </para>
+        
         <para>
+            
             そして,構文 <literal>[x1,..,xm]=a(i1,...,in)</literal> は
+            
             以下のような呼び出し手順となります:
+            
             <literal>[x1,..,xm]=%&lt;type_of_a&gt;_e_(i1,...,in,a)</literal>
+            
         </para>
+        
         <para>
+            
             挿入構文に関するオーバーロード関数 <literal>a(i1,...,in)=b</literal>
+            
             は以下のような呼び出し手順となります:
+            
             <literal>a=%&lt;type_of_b&gt;_i_&lt;type_of_a&gt;(i1,...,in,b,a)</literal>.
+            
         </para>
+        
         <para>
+            
             文字コード<literal>6</literal> を
+            
             <code>x.b(2) = 33</code>のような複雑な挿入アルゴリズム で使用することができます.
+            
             ただし,<literal>b</literal>フィールドは構造体<literal>x</literal>で 定義されません.
+            
             挿入は自動的に<literal>temp=x.b;</literal> <code>temp(2) = 33</code>;
+            
             <code>x.b = temp</code>に分解されます. 文字コード<literal>6</literal>
+            
             がこのアルゴリズムの最初の手順で 使用されます.オーバーロード関数<literal>6</literal> は,
+            
             <literal>e</literal>のものに非常によく似ています.
+            
         </para>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>関数 :</term>
+                
                 <listitem>
+                    
                     <para>
-                        いくつかの基本プリミティブ関数新規データ型に関してオーバーロードができます. 特定のデータ型に関してこのような関数が未定義の場合,
+                        
+                        いくつかの基本プリミティブ関数新規データ型に関してオーバーロードができます. 
+                        
+                        特定のデータ型に関してこのような関数が未定義の場合,
+                        
                         関数<literal>%&lt;type_of_an_argument&gt;_&lt;function_name&gt;</literal>
-                        がコールされます. ユーザはこのコールされた関数に入力データ型に関する 定義を追加することができます.
+                        
+                        がコールされます. ユーザはこのコールされた関数に入力データ型に関する
+                        
+                        定義を追加することができます.
+                        
                     </para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
     </refsection>
+    
     <refsection>
+        
         <programlisting role="example">//表示
-            var = tlist('tab', ['a', 'b'], ['x'; 'y'], rand(2, 2)) // the type of var is 'tab'
+            
+            var = tlist('tab', ['a', 'b'], ['x'; 'y'], rand(2, 2)) // varの型は 'tab'です
+            
+            
+            
             typeof(var)
+            
+            
+            
             function [] = %tab_p(l)
+            
             disp([[' '; l(3)] [l(2); string(l(4))]])
+            
             endfunction
-            var // after overloading
+            
+            
+            
+            var // オーバーローディング後
+            
         </programlisting>
+        
     </refsection>
+    
     <refsection>
+        
         <programlisting role="example">//演算子
-            's' + 1 // it is impossible to add a number to a string
+            
+            's' + 1 // 数値は文字列に加算できません
+            
+            
+            
             function x = %c_a_s(a, b)
+            
             x = a + string(b);
+            
             endfunction
-            's' + 1 // after overloading
+            
+            
+            
+            's' + 1 // オーバーローディング後
+            
         </programlisting>
+        
     </refsection>
+    
     <refsection>
+        
         <programlisting role="example">//関数
-            sin('2 * x') // the sin function does not work with a string
+            
+            sin('2 * x') // sin関数は文字列では動作しません
+            
+            
+            
             function x = %c_sin(a)
+            
             x = 'sin(' + a + ')'
+            
             endfunction
-            sin('2 * x') // after overloading
+            
+            
+            
+            sin('2 * x') // オーバーローディング後
+            
         </programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="tlist">tlist</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="disp">disp</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="symbols">symbols</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="typeof">typeof</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="type">type</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="typename">typename</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
 </refentry>
+
index bb1e21d..453a8fe 100644 (file)
@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) ????-2008 - INRIA
  * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
 -->
+
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="add_profiling" xml:lang="ja">
+    
     <refnamediv>
+        
         <refname>add_profiling</refname>
+        
         <refpurpose>プロファイル命令を関数に追加.</refpurpose>
+        
     </refnamediv>
+    
     <refsynopsisdiv>
+        
         <title>呼び出し手順</title>
+        
         <synopsis>add_profiling(funname)</synopsis>
+        
     </refsynopsisdiv>
+    
     <refsection>
-        <title>パラメータ</title>
+        
+        <title>引数</title>
+        
         <variablelist>
+            
             <varlistentry>
+                
                 <term>funname</term>
+                
                 <listitem>
-                    <para>文字列, 関数名</para>
+                    
+                    <para>文字列, プロファイルされる関数の名前</para>
+                    
                 </listitem>
+                
             </varlistentry>
+            
         </variablelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>説明</title>
+        
         <para>
+            
             <literal>add_profiling(funname)</literal> は,
+            
             プロファイル命令を関数<literal>funname</literal>に
+            
             追加します.
+            
             この関数が実行された時に,コール数と消費時間が
+            
             各行毎に保存されます.
+            
+            これらのデータは
+            
+            <link linkend="profile">profile</link>関数により
+            
+            取得できます.
+            
         </para>
+        
     </refsection>
+    
     <refsection>
+        
         <title>例</title>
+        
         <programlisting role="example"><![CDATA[ 
 function x=foo(a,n)
  x=0;
@@ -57,29 +97,56 @@ add_profiling("foo")
 foo(0.1,100) //関数を実行
 profile(foo) //プロファイル情報を展開
  ]]></programlisting>
+        
     </refsection>
+    
     <refsection role="see also">
+        
         <title>参照</title>
+        
         <simplelist type="inline">
+            
             <member>
+                
                 <link linkend="profile">profile</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="plotprofile">plotprofile</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="remove_profiling">remove_profiling</link>
+                
             </member>
+            
             <member>
+                
                 <link linkend="reset_profiling">reset_profiling</link>
+                
             </member>
+            
         </simplelist>
+        
     </refsection>
+    
     <refsection>
+        
         <title>使用される関数</title>
+        
         <para>
+            
             この関数は Scilab 関数<literal>bytecode</literal>  および
+