added japanese translation of MPI module. 41/14441/3
Rui Hirokawa [Mon, 21 Apr 2014 13:44:49 +0000 (22:44 +0900)]
Change-Id: I2060de5af7dc4628173b680d61897cc0daf22159

12 files changed:
scilab/modules/api_scilab/help/ja_JP/low_level_functions/nbInputArgument.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Bcast.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Init.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Irecv.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Isend.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Recv.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Send.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/MPI_Wait.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/mpi.xml [new file with mode: 0644]
scilab/modules/mpi/help/ja_JP/mpi_technical.xml [new file with mode: 0644]
scilab/modules/preferences/help/ja_JP/getPreferencesValue.xml [new file with mode: 0644]
scilab/modules/preferences/help/ja_JP/setPreferencesValue.xml [new file with mode: 0644]

diff --git a/scilab/modules/api_scilab/help/ja_JP/low_level_functions/nbInputArgument.xml b/scilab/modules/api_scilab/help/ja_JP/low_level_functions/nbInputArgument.xml
new file mode 100644 (file)
index 0000000..cafe90d
--- /dev/null
@@ -0,0 +1,142 @@
+<?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:html="http://www.w3.org/1999/xhtml" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="nbInputArgument" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>nbInputArgument (Scilab ゲートウェイ)</refname>
+        
+        <refpurpose>
+            
+            Scilab関数コール時の入力引数の数を取得するCゲートウェイ関数
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>int nb_params = nbInputArgument(void* _pvCtx)</synopsis>
+        
+        <synopsis>int nb_params = Rhs</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>_pvCtx</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        Scilab環境ポインタ,
+                        
+                        api_scilab.hにより提供された"pvApiCtx"を指定
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>nb_params</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        Scilab関数コール時の入力引数の数
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            Scilab関数コール時の入力引数の数を取得するCゲートウェイ関数.
+            
+            この関数を使用するにはapi_scilab.hをインクルードしておく
+            
+            必要があります.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <para>
+            
+            この例では,Cインターフェイス関数は
+            
+            複数の入力をとり,Scilab関数コール時に検出された
+            
+            入力引数の数に対応する整数をScilabコンソールに出力します.
+            
+        </para>
+        
+        <programlisting role="example">
+            
+            <![CDATA[ 
+#include "api_scilab.h"
+#include "sciprint.h"
+
+int sci_myrhs(char * fname)
+{
+  sciprint("The number of input parameters is %d\n", nbInputArgument);
+
+  return 0;
+}
+ ]]>
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="getNbInputArgument">getNbInputArgument</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="sciprint">sciprint</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Bcast.xml b/scilab/modules/mpi/help/ja_JP/MPI_Bcast.xml
new file mode 100644 (file)
index 0000000..a729151
--- /dev/null
@@ -0,0 +1,160 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Bcast" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI_Bcast</refname>
+        
+        <refpurpose>
+            
+            ランクルートを有するプロセスからグループの
+            
+            他の全プロセスにメッセージをブロードキャストする.
+            
+        </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>res = MPI_Bcast(value,rootID)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>value</term>
+                
+                <listitem>
+                    
+                    <para>全ノードに送信する値.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>rootID</term>
+                
+                <listitem>
+                    
+                    <para>メッセージのソース</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>res</term>
+                
+                <listitem>
+                    
+                    <para>ブロードキャストされた値</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            全ノードに変数を送信します.
+            
+            この値は関数<link linkend="MPI_Recv">MPI_Recv</link>により
+            
+            ノードで取得されます.
+            
+        </para>
+        
+        <para>
+            
+            内部的な技術面では,2つのブロードキャストが透過的に
+            
+            使用されます.
+            
+            初回はデータの大きさ,2回目はデータ自体を送信します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example">
+            
+            MPI_Init();
+            
+            rnk =    MPI_Comm_rank();
+            
+            sizeNodes =    MPI_Comm_size();
+            
+            
+            
+            SLV = rnk;                // 手軽なショートカット, マスターはランク0です
+            
+            Master = ~ SLV;            // その他は全てスレーブ
+            
+            a=-1
+            
+            if Master
+            
+            // aを宣言
+            
+            a=42
+            
+            end
+            
+            b=MPI_Bcast(a, 0);
+            
+            assert_checkequal(b,42);
+            
+            MPI_Finalize();
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Recv">MPI_Recv</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Init.xml b/scilab/modules/mpi/help/ja_JP/MPI_Init.xml
new file mode 100644 (file)
index 0000000..cb62a33
--- /dev/null
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Init" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI_Init</refname>
+        
+        <refpurpose>MPI環境を初期化する</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>res = MPI_Init()</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>value</term>
+                
+                <listitem>
+                    
+                    <para>指定したノードに送信する値.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>node</term>
+                
+                <listitem>
+                    
+                    <para>データを送信するノード</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>res</term>
+                
+                <listitem>
+                    
+                    <para>処理結果 (成功時にtrue,失敗した場合に false)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            指定したノードに変数を送信します.
+            
+            その値は,関数<link linkend="MPI_Send">MPI_Send</link>により
+            
+            ノードで取得されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example">//TODO</programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Recv">MPI_Recv</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Irecv.xml b/scilab/modules/mpi/help/ja_JP/MPI_Irecv.xml
new file mode 100644 (file)
index 0000000..65f731a
--- /dev/null
@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Irecv" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI_Irecv</refname>
+        
+        <refpurpose>ノードからデータをノンブロッキング受信する</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>MPI_Irecv(rank,tag)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>rank</term>
+                
+                <listitem>
+                    
+                    <para>ランク. TODO</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>tag</term>
+                
+                <listitem>
+                    
+                    <para>タグ. TODO</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            ノンブロッキング(非同期)方式で指定したノードから変数を取得します.
+            
+            この値は,通常,<link linkend="MPI_Isend">MPI_Isend</link>関数から
+            
+            送信されます.
+            
+        </para>
+        
+        <para>
+            
+            非同期の特性のため, MPI_Irecv は値を返されないことに注意してください.
+            
+            ソースノードにより送信された値は,
+            
+            <link linkend="MPI_Wait">MPI_Wait</link>により返されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>技術的実装</title>
+        
+        <para>
+            
+            Scilab/MPIの実装に関する詳細については,
+            
+            <link linkend="mpi_technical">実装に関する技術的詳細</link>を
+            
+            参照ください.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+
+
+                MPI_Init();
+                rnk =    MPI_Comm_rank();
+                sizeNodes =    MPI_Comm_size();
+
+                SLV = rnk;
+                Master = ~ SLV;
+
+                assert_checkequal(MPI_Comm_size(), 2);
+
+                if Master
+                   for slaveId = 1:sizeNodes-1
+                     value = slaveId*2
+                     MPI_Isend(value, slaveId, 42);
+                   end
+                else
+                    rankSource=0;
+                    tag=0;
+                    MPI_Irecv(rankSource, tag, 42); // MPI_Irecv は値を返しません
+                    value=MPI_Wait(42) // 値はMPI_Waitで取得します
+                    assert_checkequal(value,2);
+                end
+
+                MPI_Finalize();
+                exit()
+
+           ]]> </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Isend">MPI_Isend</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="MPI_Wait">MPI_Wait</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Isend.xml b/scilab/modules/mpi/help/ja_JP/MPI_Isend.xml
new file mode 100644 (file)
index 0000000..c678456
--- /dev/null
@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Isend" xml:lang="en">
+    
+    <refnamediv>
+        
+        <refname>MPI_Isend</refname>
+        
+        <refpurpose>Nonblocking send data from a node to an other</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>Calling Sequence</title>
+        
+        <synopsis>res = MPI_Isend(value,node)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>Arguments</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>value</term>
+                
+                <listitem>
+                    
+                    <para>The value to be sent to the specified node.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>node</term>
+                
+                <listitem>
+                    
+                    <para>The node to send the data</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>res</term>
+                
+                <listitem>
+                    
+                    <para>The result of the operation (true if success, false if failed)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Description</title>
+        
+        <para>
+            
+            Send a variable to a specified node in a nonblock (asynchronous) way. The value should be retrieved by the node with the function <link linkend="MPI_Irecv">MPI_Irecv</link>.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Examples</title>
+        
+        <programlisting role="example"><![CDATA[ 
+
+
+                MPI_Init();
+                rnk =    MPI_Comm_rank();
+                sizeNodes =    MPI_Comm_size();
+
+                SLV = rnk;
+                Master = ~ SLV;
+
+                assert_checkequal(MPI_Comm_size(), 2);
+
+                if Master
+                   for slaveId = 1:sizeNodes-1
+                     value = slaveId*2
+                     MPI_Isend(value, slaveId, 42);
+                   end
+                else
+                    rankSource=0;
+                    tag=0;
+                    MPI_Irecv(rankSource, tag, 42); // MPI_Irecv does not return any value
+                    value=MPI_Wait(42) // the value will be returned by MPI_Wait
+                    assert_checkequal(value,2);
+                end
+
+                MPI_Finalize();
+                exit()
+
+           ]]> </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>See Also</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Irecv">MPI_Irecv</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="MPI_Wait">MPI_Wait</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Recv.xml b/scilab/modules/mpi/help/ja_JP/MPI_Recv.xml
new file mode 100644 (file)
index 0000000..9d68300
--- /dev/null
@@ -0,0 +1,200 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Recv" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI_Recv</refname>
+        
+        <refpurpose>ノードからデータを受信する</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>value = MPI_Recv(rank,tag)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>rank</term>
+                
+                <listitem>
+                    
+                    <para>ランク. TODO</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>tag</term>
+                
+                <listitem>
+                    
+                    <para>タグ. TODO</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>res</term>
+                
+                <listitem>
+                    
+                    <para>MPI_Sendから取得した値.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            指定したノードから値を取得します.
+            
+            その値は,通常,関数
+            
+            <link linkend="MPI_Send">MPI_Send</link>から送信されます.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>技術的実装</title>
+        
+        <para>
+            
+            Scilab/MPIの実装に関する詳細については,
+            
+            <link linkend="mpi_technical">実装に関する技術的詳細</link>を
+            
+            参照ください.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example">
+            
+            MPI_Init();
+            
+            rnk =    MPI_Comm_rank();
+            
+            sizeNodes =    MPI_Comm_size();
+            
+            
+            
+            SLV = rnk;                // 便利なショートカット, マスターはランク 0
+            
+            Master = ~ SLV;            // その他は全てスレーブ
+            
+            tag=0;
+            
+            if Master
+            
+            // マスターノード
+            
+            for slaveId = 1:sizeNodes-1
+            
+            // Send data to the slaves
+            
+            value = rand(100,100) + rand(100,100) * %i;
+            
+            MPI_Send(value, slaveId);
+            
+            end
+            
+            
+            
+            for slaveId = 1:sizeNodes-1
+            
+            valueBack=MPI_Recv(slaveId, tag);
+            
+            // スレーブが期待するものを送信したか確認
+            
+            assert_checkequal(valueBack,value + 1);
+            
+            end
+            
+            else
+            
+            // スレーブ
+            
+            rankSource=0;
+            
+            // マスターから情報を受信
+            
+            value=MPI_Recv(rankSource);
+            
+            // 値を1つ増加
+            
+            value=value+1;
+            
+            // マスターに戻す
+            
+            MPI_Send(value,0);
+            
+            
+            
+            end
+            
+            
+            
+            MPI_Finalize();
+            
+            
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Send">MPI_Send</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Send.xml b/scilab/modules/mpi/help/ja_JP/MPI_Send.xml
new file mode 100644 (file)
index 0000000..8ad6bd3
--- /dev/null
@@ -0,0 +1,180 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Send" xml:lang="en">
+    
+    <refnamediv>
+        
+        <refname>MPI_Send</refname>
+        
+        <refpurpose>Send data from a node to an other</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>Calling Sequence</title>
+        
+        <synopsis>res = MPI_Send(value,node)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>Arguments</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>value</term>
+                
+                <listitem>
+                    
+                    <para>The value to be sent to the specified node.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>node</term>
+                
+                <listitem>
+                    
+                    <para>The node to send the data</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>res</term>
+                
+                <listitem>
+                    
+                    <para>The result of the operation (true if success, false if failed)</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Description</title>
+        
+        <para>
+            
+            Send a variable to a specified node. The value should be retrieved by the node with the function <link linkend="MPI_Recv">MPI_Recv</link>.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Examples</title>
+        
+        <programlisting role="example">
+            
+            MPI_Init();
+            
+            rnk =    MPI_Comm_rank();
+            
+            sizeNodes =    MPI_Comm_size();
+            
+            
+            
+            SLV = rnk;                // handy shortcuts, master is rank 0
+            
+            Master = ~ SLV;            // slaves are all other
+            
+            tag=0;
+            
+            if Master
+            
+            // The master node
+            
+            for slaveId = 1:sizeNodes-1
+            
+            // Send data to the slaves
+            
+            value = rand(100,100) + rand(100,100) * %i;
+            
+            MPI_Send(value, slaveId);
+            
+            end
+            
+            
+            
+            for slaveId = 1:sizeNodes-1
+            
+            valueBack=MPI_Recv(slaveId, tag);
+            
+            // Check that the slaves gaves us what we expected
+            
+            assert_checkequal(valueBack,value + 1);
+            
+            end
+            
+            else
+            
+            // The slaves
+            
+            rankSource=0;
+            
+            // Receive the information from the master
+            
+            value=MPI_Recv(rankSource);
+            
+            // Increment all the values by one
+            
+            value=value+1;
+            
+            // Send back to the master
+            
+            MPI_Send(value,0);
+            
+            
+            
+            end
+            
+            
+            
+            MPI_Finalize();
+            
+            
+            
+        </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>See Also</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Recv">MPI_Recv</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/MPI_Wait.xml b/scilab/modules/mpi/help/ja_JP/MPI_Wait.xml
new file mode 100644 (file)
index 0000000..f166b23
--- /dev/null
@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ -->
+
+<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" version="5.0-subset Scilab" xml:id="MPI_Wait" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI_Wait</refname>
+        
+        <refpurpose>MPIリクエストの完了を待つ </refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>res = MPI_Wait(request)</synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>request</term>
+                
+                <listitem>
+                    
+                    <para>MPIリクエスト.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>res</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        MPI_Isendにより送信され,
+                        
+                        MPI_Irecvにより宣言されたMPIリクエストに一致する変数
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>TODO.</para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[ 
+
+
+                MPI_Init();
+                rnk =    MPI_Comm_rank();
+                sizeNodes =    MPI_Comm_size();
+
+                SLV = rnk;
+                Master = ~ SLV;
+
+                assert_checkequal(MPI_Comm_size(), 2);
+
+                if Master
+                   for slaveId = 1:sizeNodes-1
+                     value = slaveId*2
+                     MPI_Isend(value, slaveId, 42);
+                   end
+                else
+                    rankSource=0;
+                    tag=0;
+                    MPI_Irecv(rankSource, tag, 42); // MPI_Irecv は値を返しません
+                    value=MPI_Wait(42) // 値はMPI_Waitにより返されます
+                    assert_checkequal(value,2);
+                end
+
+                MPI_Finalize();
+                exit()
+
+           ]]> </programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Irecv">MPI_Irecv</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="MPI_Isend">MPI_Isend</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/mpi.xml b/scilab/modules/mpi/help/ja_JP/mpi.xml
new file mode 100644 (file)
index 0000000..0100c55
--- /dev/null
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ * 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
+ *
+ -->
+
+<!-- This document was created with Syntext Serna Free. -->
+
+<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" version="5.0-subset Scilab" xml:id="mpi" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI</refname>
+        
+        <refpurpose>ScilabからのMPI機能へのアクセス</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            MPIインターフェイスがScilabに提供されています. 
+            
+            このインターフェイスにより高性能なメッセージ指定
+            
+            計算が可能となります.
+            
+        </para>
+        
+        <para>
+            
+            他のMPIアプリケーションと同様に, Scilab/MPI は
+            
+            <literal>mpirun</literal>コマンドにより開始され,通常,
+            
+            開始するノード数を指定する引数<literal>-c</literal>を
+            
+            指定します.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>サポートされるデータ型</title>
+        
+        <para>
+            
+            Scilab MPI実装は以下の
+            
+            (行列またはスカラー形式の)Scilabデータ型をサポートします:
+            
+            <simplelist type="inline">
+                
+                <member>Double</member><member>Boolean</member><member>int (全て)</member><member>String</member><member>Sparse</member><member>Boolean Sparse</member>
+                
+            </simplelist>
+            
+            現時点では,list, tlistまたは mlistのような高位の
+            
+            データ型構造はサポートされていません.
+            
+            これらをサポートするためには,バグレポートを新規に投稿するのが
+            
+            良いでしょう.
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Scilab MPIの例</title>
+        
+        <programlisting role="scilab"><![CDATA[ 
+// TODO. 例を追加 (PI ?)
+
+]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="MPI_Recv">MPI_Recv</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="mpi_technical">実装に関する技術的詳細</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/mpi/help/ja_JP/mpi_technical.xml b/scilab/modules/mpi/help/ja_JP/mpi_technical.xml
new file mode 100644 (file)
index 0000000..ebf9d25
--- /dev/null
@@ -0,0 +1,314 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2011 - DIGITEO - Sylvestre Ledru
+ * 
+ * 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
+ *
+ -->
+
+<!-- This document was created with Syntext Serna Free. -->
+
+<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" version="5.0-subset Scilab" xml:id="mpi_technical" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>MPI implementation</refname>
+        
+        <refpurpose>実装に関する技術的詳細</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>データの送信および受信</title>
+        
+        <para>
+            
+            スクリプト言語によるMPI実装の主な問題は,ネーティブな特徴に起因します.
+            
+            つまり,スクリプト言語は,もともと,
+            
+            種々の<literal>型</literal>および大きさの動的な変数を用いているのです.
+            
+        </para>
+        
+        <para>
+            
+            ScilabにおけるMPIの実装はMPIデータ型MPI_INTへの内部的なシリアル化および
+            
+            非シリアル化処理を用いています.
+            
+            送信関数(MPI_Send, MPI_Isend, MPI_BCast, など)は
+            
+            全てのサポートされるデータ型を MPI_INTに変換し,一方,
+            
+            受信関数(MPI_Recv, MPI_Irecv, など) は元の変数を 
+            
+            <literal>回復</literal> します.
+            
+        </para>
+        
+        <para>
+            
+            5系列におけるメモリ表現と同様に,変数は以下のようにシリアル化されます:
+        </para>
+        
+        <para>
+            
+            Double, Boolean, 文字列(?)
+            
+            <informaltable border="1">
+                
+                <tr>
+                    
+                    <td>
+                        
+                        <para>型</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>行数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>列数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>複素数 (関係する場合)</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>データ</para>
+                        
+                    </td>
+                    
+                </tr>
+                
+            </informaltable>
+            
+        </para>
+        
+        <para>整数
+            
+            <informaltable border="1">
+                
+                <tr>
+                    
+                    <td>
+                        
+                        <para>型</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>行数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>列数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>精度</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>データ</para>
+                        
+                    </td>
+                    
+                </tr>
+                
+            </informaltable>
+            
+            <para>
+                
+            </para>
+            
+            疎行列 (double または boolean)
+            
+            <informaltable border="1">
+                
+                <tr>
+                    
+                    <td>
+                        
+                        <para>型</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>行数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>列数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>複素数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>要素数</para>
+                        
+                    </td>
+                    
+                    <td>
+                        
+                        <para>データ</para>
+                        
+                    </td>
+                    
+                </tr>
+                
+            </informaltable>
+            
+        </para>
+        
+        <para>
+            
+            他の解を検討しましたが,種々の理由により棄却されました:
+            
+            <simplelist type="inline">
+                
+                <member>
+                    
+                    <literal>MPIに基づく新規データ型</literal> は
+                    
+                    <literal>事前に</literal>変数の大きさを知る必要があります.
+                    
+                </member>
+                
+                <member>
+                    
+                    <literal>
+                        
+                        メタデータ(大きさ, 型)が送信されたり,
+                        
+                        データが送信されたりします.
+                        
+                    </literal>
+                     
+                    
+                    性能は低下し,コードはかなり複雑化します.
+                    
+                </member>
+                
+            </simplelist>
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>非同期通信</title>
+        
+        <para>
+            
+            MPI_Irecv とMPI_Isendの標準的な動作はScilab言語で共通する方法とは実際には
+            
+            異なり、MPI_WairがScilab MPIバインディングに値を返します.
+            
+        </para>
+        
+        <para>
+            
+            リクエストのリストとMPI_Irecv/MPI_Waitで想定されるMPI変数を保存するために,
+            
+            最大 10 000 要素を有する静的C構造体が使用されます.
+            
+            これらは,非同期通信で使用される種々のMPIリクエストと
+            
+            MPI_Irecvから期待される変数へのリファレンスを保存する際に使用されます.
+            
+            受信された値はMPI_Waitにより取得されます.
+            
+        </para>
+        
+        <para>以下の例では, "42"という名前のリクエストがこのデータ構造体に保存されます.
+            
+            <programlisting role="example"><![CDATA[ 
+
+
+                MPI_Init();
+                rnk =    MPI_Comm_rank();
+                sizeNodes =    MPI_Comm_size();
+
+                SLV = rnk;
+                Master = ~ SLV;
+
+                assert_checkequal(MPI_Comm_size(), 2);
+
+                if Master
+                   for slaveId = 1:sizeNodes-1
+                     value = slaveId*2
+                     MPI_Isend(value, slaveId, 42);
+                   end
+                else
+                    rankSource=0;
+                    tag=0;
+                    MPI_Irecv(rankSource, tag, 42); // MPI_Irecv は値を返しません
+                    value=MPI_Wait(42) // 値は MPI_Waitにより返されます
+                    assert_checkequal(value,2);
+                end
+
+                MPI_Finalize();
+                exit()
+
+           ]]> </programlisting>
+            
+        </para>
+        
+    </refsection>
+    
+    
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="mpi">MPIの概要</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/preferences/help/ja_JP/getPreferencesValue.xml b/scilab/modules/preferences/help/ja_JP/getPreferencesValue.xml
new file mode 100644 (file)
index 0000000..5b636a9
--- /dev/null
@@ -0,0 +1,203 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2014 - Scilab Enterprises - Calixte DENIZET
+ *
+ * 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: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="getPreferencesValue" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>getPreferencesValue</refname>
+        
+        <refpurpose>設定値を取得</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>
+            
+            getPreferencesValue(xpath, attributes [, doc])
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>xpath</term>
+                
+                <listitem>
+                    
+                    <para>文字列, 
+                        
+                        設定ファイルのノードを取得する
+                        
+                        XPathリクエストを表す.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>attributes</term>
+                
+                <listitem>
+                    
+                    <para>文字列の行列, 属性名.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>doc</term>
+                
+                <listitem>
+                    
+                    <para>XMLDoc型のmlist, 設定ファイルのXML文書.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            設定ファイル(<literal>SCIHOME+'/XConfiguration.xml'</literal>)の
+            
+            属性の値を取得します. 
+            
+        </para>
+        
+        <para>
+            
+            docを指定した場合, 値はこの文書内で探されます. 
+            
+            複数のリクエストを実行する必要がある際,
+            
+            同じ設定ファイルを重複してパースすることを避けるために
+            
+            有用です.
+            
+        </para>
+        
+        <para>
+            
+            有効な任意のXPathリクエストを指定できます.
+            
+            例えば,proxy設定を取得するXPathリクエストは以下のように
+            
+            記述できます:
+            
+        </para>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <para>
+                    
+                    ファイル<literal>SCIHOME+'/XConfiguration.xml'</literal>
+                    
+                    を開き,指定したノードにアクセスするためのノード名を
+                    
+                    取得します:
+                    
+                </para>
+                
+                <programlisting role="xml"><![CDATA[
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<interface height="600" path="1/" version="0.17" width="800">
+    <general title="_(General)">
+    ...
+    </general>
+    <web title="_(Web)">
+        <body>
+            <web command-browser="" command-mailer="" default-browser="true" default-mailer="true"/>
+            <proxy enabled="false" host="" password="" port="" user=""/>
+            <previous-proxy enabled="false" host="" password="" port="" user=""/>
+        </body>
+    </web>
+    ...
+</interface>
+             ]]></programlisting>
+                
+                <para>
+                    
+                    パスは<literal>"/interface/web/body/proxy"</literal> 
+                    
+                    (または簡単化するために<literal>"//web/body/proxy"</literal>)
+                    
+                    となります. 
+                    
+                </para>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+getPreferencesValue("//web/body/proxy", ["enabled", "host", "port"]);
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="setPreferencesValue">setPreferencesValue</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/preferences/help/ja_JP/setPreferencesValue.xml b/scilab/modules/preferences/help/ja_JP/setPreferencesValue.xml
new file mode 100644 (file)
index 0000000..6859269
--- /dev/null
@@ -0,0 +1,220 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2014 - Scilab Enterprises - Calixte DENIZET
+ *
+ * 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: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="setPreferencesValue" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>setPreferencesValue</refname>
+        
+        <refpurpose>設定値を設定</refpurpose>
+        
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        
+        <title>呼び出し手順</title>
+        
+        <synopsis>
+            
+            setPreferencesValue(xpath, key_value [, doc])
+            
+        </synopsis>
+        
+    </refsynopsisdiv>
+    
+    <refsection>
+        
+        <title>引数</title>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>xpath</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        文字列, 設定ファイルのノードを取得する
+                        
+                        XPathリクエストを表す.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+            <varlistentry>
+                
+                <term>key_value</term>
+                
+                <listitem>
+                    
+                    <para>2xNの文字列行列, 設定するキーの値.</para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+        <variablelist>
+            
+            <varlistentry>
+                
+                <term>doc</term>
+                
+                <listitem>
+                    
+                    <para>
+                        
+                        XMLDoc型のmlist, 設定ファイルのXML文書.
+                        
+                    </para>
+                    
+                </listitem>
+                
+            </varlistentry>
+            
+        </variablelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            設定ファイル(<literal>SCIHOME+'/XConfiguration.xml'</literal>)
+            
+            の属性の値を設定します. 
+            
+        </para>
+        
+        <warning>
+            
+            誤って設定を修正するとScilabの動作を改変することになります.
+            
+        </warning>
+        
+        <para>
+            
+            docを指定した場合, 値はこの文書内で探されます. 
+            
+            複数のリクエストを実行する必要がある際,
+            
+            同じ設定ファイルを重複してパースすることを避けるために
+            
+            有用です.
+            
+        </para>
+        
+        <para>
+            
+            有効な任意のXPathリクエストを指定できます.
+            
+            例えば,proxy設定を書き込むXPathリクエストは以下のように
+            
+            記述できます:
+            
+        </para>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <para>
+                    
+                    ファイル<literal>SCIHOME+'/XConfiguration.xml'</literal>
+                    
+                    を開き,指定したノードにアクセスするためのノード名を
+                    
+                    取得します:
+                    
+                </para>
+                
+                <programlisting role="xml"><![CDATA[
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<interface height="600" path="1/" version="0.17" width="800">
+    <general title="_(General)">
+    ...
+    </general>
+    <web title="_(Web)">
+        <body>
+            <web command-browser="" command-mailer="" default-browser="true" default-mailer="true"/>
+            <proxy enabled="false" host="" password="" port="" user=""/>
+            <previous-proxy enabled="false" host="" password="" port="" user=""/>
+        </body>
+    </web>
+    ...
+</interface>
+             ]]></programlisting>
+                
+                <para>
+                    
+                    パスは<literal>"/interface/web/body/proxy"</literal> 
+                    
+                    (または簡単化するために<literal>"//web/body/proxy"</literal>)
+                    
+                    となります. 
+                    
+                </para>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="example"><![CDATA[
+// カレントの値を取得
+prev = getPreferencesValue("//web/body/proxy", ["enabled", "host", "port"]);
+setPreferencesValue("//web/body/proxy", ["enabled", "host", "port"; "true", "my.proxy.org", "1234"]);
+
+// 確認します
+getPreferencesValue("//web/body/proxy", ["enabled", "host", "port"])
+
+// 前の値に戻します
+setPreferencesValue("//web/body/proxy", ["enabled", "host", "port" ; prev]);
+getPreferencesValue("//web/body/proxy", ["enabled", "host", "port"])
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link linkend="getPreferencesValue">getPreferencesValue</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+