added japanese translation of javasci. 15/14515/3
Rui Hirokawa [Sun, 11 May 2014 02:40:19 +0000 (11:40 +0900)]
Change-Id: I3feeafc4b0fc7e8464bc21777ccd46b41ef64201

scilab/modules/javasci/help/ja_JP/compile_and_run_javasci.xml [new file with mode: 0644]
scilab/modules/javasci/help/ja_JP/javasci.xml [new file with mode: 0644]
scilab/modules/javasci/help/ja_JP/javasci_faq.xml [new file with mode: 0644]
scilab/modules/javasci/help/ja_JP/javasci_limitations.xml [new file with mode: 0644]
scilab/modules/javasci/help/ja_JP/javasci_step_by_step.xml [new file with mode: 0644]

diff --git a/scilab/modules/javasci/help/ja_JP/compile_and_run_javasci.xml b/scilab/modules/javasci/help/ja_JP/compile_and_run_javasci.xml
new file mode 100644 (file)
index 0000000..abcf2e6
--- /dev/null
@@ -0,0 +1,396 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA - Allan CORNET
+ *
+ * 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="compile_and_run_javasci_v2" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>javasci v2でコンパイル/実行</refname>
+        
+        <refpurpose>Javasci v2によりJavaアプリケーションをコンパイルする方法</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>Linux/Unix/MacOSX</title>
+        
+        <para>Linux/Unix/MacOSXでは, Scilab は グローバル変数SCIを以下のように設定する必要があります:</para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>
+                    
+                    バイナリ版のScilabでは, SCI は <literal>/path/to/scilab/share/scilab/</literal>を指します
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    Scilabのソースツリーでは, SCIはソースツリーのルート
+                    
+                    <literal>/path/to/scilab/source/tree/</literal>を指します
+                    
+                </para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        
+        
+        <para>
+            
+            Javasci v2でJavaアプリケーションをコンパイルする際,
+            
+            以下のライブラリへのパスをclasspathに追加する必要があります:
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <literal>org.scilab.modules.javasci.jar</literal> (全てのJavasciアプリケーションで必要) 
+                
+            </listitem>
+            
+            <listitem>
+                
+                <literal>org.scilab.modules.types.jar</literal> (アプリケーションが
+                
+                Javasci型を使用する場合)
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        
+        
+        <para>
+            
+            例に示すコード(コードはこのページに後述)をコンパイルするためには, 
+            
+            以下のようにコマンドラインに入力します:
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            <literal>javac -cp $SCI/modules/javasci/jar/org.scilab.modules.javasci.jar:$SCI/modules/types/jar/org.scilab.modules.types.jar:. BasicExample.java</literal>
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            Javaアプリケーションを起動するには, 
+            
+            以下のどちらかにより,
+            
+            libjavasci ネーティブライブラリへのパスを
+            
+            指定する必要があります:
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>LD_LIBRARY_PATHで指定:</para>
+                
+                <itemizedlist mark="opencircle">
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            バイナリ版のScilabでは, LD_LIBRARY_PATH は
+                            
+                            <literal>/path/to/scilab/lib/scilab/</literal> および
+                            
+                            <literal>/path/to/scilab/lib/thirdparty/</literal>を指します
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                    <listitem>
+                        
+                        <para>
+                            
+                            Scilabのソースツリーでは, LD_LIBRARY_PATH は
+                            
+                            ソースツリーのルート
+                            
+                            <literal>/path/to/scilab/modules/javasci/.libs/</literal>,
+                            
+                            <literal>/path/to/scilab/modules/types/.libs/</literal> および
+                            
+                            <literal>/path/to/scilab/.libs/</literal>
+                            
+                            を指します.
+                            
+                        </para>
+                        
+                    </listitem>
+                    
+                </itemizedlist>
+                
+                
+                
+                <para>
+                    
+                    アプリケーションは以下のコマンドライン入力により実行します:
+                    
+                </para>
+                
+                <literal>java -cp $SCI/modules/javasci/jar/org.scilab.modules.javasci.jar:$SCI/modules/types/jar/org.scilab.modules.types.jar:. BasicExample</literal>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    または, コマンドラインで, javaの引数として指定します:
+                    
+                </para>
+                
+                <para>
+                    
+                    <literal>java -Djava.library.path=/path/to/libjavasci/:/path/to/scilab/lib/thirdparty/ -cp $SCI/modules/javasci/jar/org.scilab.modules.javasci.jar:$SCI/modules/types/jar/org.scilab.modules.types.jar:. BasicExample</literal>
+                    
+                </para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Windows</title>
+        
+        <para>
+            
+            このパラグラフでは, Scilabがディレクトリ
+            
+            <literal>C:\Program Files\scilab-XXXX</literal> 
+            
+            (ただし, XXXX は Scilabのバージョン, 例えば"5.4.0")
+            
+            にインストールされていると仮定します.
+            
+        </para>
+        
+        
+        
+        <para>Windowsでは, 特定の環境変数を定義する必要はありません.</para>
+        
+        
+        
+        <para>
+            
+            JavaアプリケーションをJavasci v2によりコンパイルするには, 
+            
+            以下のライブラリへのパスをclasspathに追加します:
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <literal>org.scilab.modules.javasci.jar</literal> (全てのJavasciアプリケーションで必要) 
+                
+            </listitem>
+            
+            <listitem>
+                
+                <literal>org.scilab.modules.types.jar</literal> (アプリケーションがJavasci型を使用する場合) 
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+        
+        
+        <para>
+            
+            例に示すコードをコンパイルする, コマンドラインを示します:
+        </para>
+        
+        <para>
+            
+            <literal>javac -cp "C:\Program Files\scilab-XXXX\modules\javasci\jar\org.scilab.modules.javasci.jar;C:\Program Files\scilab-XXXX\modules\types\jar\org.scilab.modules.types.jar";. BasicExample.java</literal>
+            
+        </para>
+        
+        
+        
+        <para>
+            
+            実行の際には, ネーティブライブラリlibjavasci.dllと
+            
+            それが依存するものへのパスを環境変数PATHに追加する必要があります.
+            
+            必要な全てのライブラリは"bin"フォルダにありますので,
+            
+            コマンドラインは以下のようになります:
+            
+        </para>
+        
+        <para>
+            
+            <literal>set PATH="C:\Program Files\scilab-XXXX\bin";%PATH%</literal>
+            
+        </para>
+        
+        
+        
+        <para>Javaアプリケーションを起動する際のコマンドラインはLinuxとほぼ同じです:</para>
+        
+        <para>
+            
+            <literal>java -cp "C:\Program Files\scilab-XXXX\modules\javasci\jar\org.scilab.modules.javasci.jar;C:\Program Files\scilab-XXXX\modules\types\jar\org.scilab.modules.types.jar";. BasicExample</literal>
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>オプション</title>
+        
+        <para>
+            
+            javaを起動する際のオプション : <literal>-Djava.compiler=JIT -Xmx256m</literal>
+            
+        </para>
+        
+        <para>(これらの引数を指定すると, javasci は
+            
+            標準scilabと同様に同じ初期オプションを指定して起動されます.
+            
+        </para>
+        
+        <para>
+            
+            特定のニーズに基づき以下の2つの環境変数が使用される
+            
+            ことに注意してください:
+            
+        </para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <literal>SCI_DISABLE_TK=1</literal> はTk (TclのGUI)を無効にします
+                    
+                </para>
+                
+            </listitem>
+            
+            <listitem>
+                
+                <para>
+                    
+                    <literal>SCI_JAVA_ENABLE_HEADLESS=1</literal> 
+                    
+                    は, Javaをヘッドレスモード(AWT/Swingなし)で起動します.
+                    
+                </para>
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>例</title>
+        
+        <programlisting role="java"><![CDATA[
+// 簡単な Javaの例
+// javasci v2
+// Filename: BasicExample.java
+
+import org.scilab.modules.javasci.Scilab;
+import org.scilab.modules.types.ScilabType;
+
+class BasicExample {
+
+    public static void main(String[] args) {
+        try {
+            Scilab sci = new Scilab();
+            sci.open();
+            sci.exec("a=cos(%pi)*sin(%pi^2);");
+            ScilabType a = sci.get("a");
+            System.out.println("a = " + a);
+        } catch (org.scilab.modules.javasci.JavasciException e) {
+            System.err.println("Could not find variable type: " + e.getLocalizedMessage());
+        }
+   }
+}
+
+ ]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link>を閲覧.
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="javasci">Javasci</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="javasci_faq_v2">Javasci FAQ</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/javasci/help/ja_JP/javasci.xml b/scilab/modules/javasci/help/ja_JP/javasci.xml
new file mode 100644 (file)
index 0000000..0d26eab
--- /dev/null
@@ -0,0 +1,234 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA - Allan CORNET
+ *
+ * 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" xmlns:scilab="http://www.scilab.org" xml:id="javasci" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>javasci</refname>
+        
+        <refpurpose>JavaアプリケーションからScilabエンジンをコール</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>
+            
+            Scilab はJavaアプリケーションからコールできる機能を提供します.
+            
+        </para>
+        
+        <para>
+            
+            このヘルプは, javasci APIの機能を記述するものです.
+            
+        </para>
+        
+        <para>
+            
+            Scilab バージョン 5.3.0以降, 
+            
+            Javasci v2と呼ばれる Javasciの新バージョンが導入されました.
+            
+            このバージョンは,
+            
+            <link linkend="javasci_v1_limitations">Javasci v1の制限</link>の多くを修正しています.
+            
+        </para>
+        
+        <para>
+            
+            <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link> を閲覧 
+            
+            (これによりWebブラウザがオープンします).
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Javasci v2の例</title>
+        
+        <programlisting role="java"><![CDATA[
+// javasci v2を使用する簡単なJavaの例
+// Filename: DisplayPI.java
+
+import org.scilab.modules.javasci.Scilab;
+import org.scilab.modules.types.ScilabType;
+import org.scilab.modules.types.ScilabDouble;
+
+class Example1 {
+
+    public static void main(String[] args) {
+
+      try {
+            Scilab sci = new Scilab();
+            sci.open();
+            sci.exec("disp(%pi);");
+
+            ScilabDouble a = new ScilabDouble(3.14);
+            sci.put("a",a);
+            sci.exec("b=sin(a);");
+            ScilabType b = sci.get("b");
+            System.out.println("b = " + b);
+
+            sci.close();
+
+      } catch (org.scilab.modules.javasci.JavasciException e) {
+            System.err.println("An exception occurred: " + e.getLocalizedMessage());
+      }
+
+    }
+}
+
+]]></programlisting>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link type="remote" linkend="javasci/javadoc/index.html">
+                    
+                    Javasci v2の文書
+                </link>
+                を閲覧 (これによりWebブラウザがオープンします).
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="compile_and_run_javasci_v2">Javasci v2でコンパイル/実行</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="javasci_faq_v2">Javasci v2 FAQ</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revdescription>
+                    
+                    Javasci v1 が削除されました.
+                    
+                </revdescription>
+                
+            </revision>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revdescription>新規メソッド追加:
+                    
+                    <itemizedlist>
+                        
+                        <listitem>Scilab.execException(String)
+                            
+                            <para>
+                                
+                                Scilab.exec(String) と同じですが, Scilabエラーが
+                                
+                                発生した際に例外を返します
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>Scilab.execException(String[])
+                            
+                            <para>
+                                
+                                Scilab.exec(String[]) と同じですが, Scilabエラーが
+                                
+                                発生した際に例外を返します
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                        <listitem>Scilab.execException(File)
+                            
+                            <para>
+                                
+                                Scilab.exec(File) と同じですが, Scilabエラーが
+                                
+                                発生した際に例外を返します
+                                
+                            </para>
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </revdescription>
+                
+            </revision>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revdescription>
+                    
+                    <itemizedlist>
+                        
+                        <listitem>Javasci は疎行列と論理値疎行列データ型をサポートします.</listitem>
+                        
+                        <listitem>Javasci はtlists, mlists およびリストデータ型をサポートします.</listitem>
+                        
+                        <listitem>Javasci 多項式データ型をサポートします.</listitem>
+                        
+                        <listitem>mList形式のJavasciデータ型構造体をサポートします.
+                            
+                        </listitem>
+                        
+                    </itemizedlist>
+                    
+                </revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/javasci/help/ja_JP/javasci_faq.xml b/scilab/modules/javasci/help/ja_JP/javasci_faq.xml
new file mode 100644 (file)
index 0000000..253257c
--- /dev/null
@@ -0,0 +1,403 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA - Allan CORNET
+ *
+ * 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" scilab:needs-examples="no" xml:id="javasci_faq_v2" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>javasci FAQ</refname>
+        
+        <refpurpose>Javasci v2に関するFAQ</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>質問 / 回答</title>
+        
+        <qandaset>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>javasciに基づくアプリケーションを実行した際,エラー
+                        
+                        <emphasis role="italic">Exception in thread "main" java.lang.NoClassDefFoundError:
+                            
+                            org/scilab/modules/javasci/Scilab
+                            
+                        </emphasis>
+                        が発生しました.
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        おそらく,
+                        
+                        org.scilab.modules.javasci.jar が CLASSPATHで定義されていないと
+                        
+                        思われます.
+                        
+                        <link linkend="compile_and_run_javasci_v2">javasciでコンパイル/実行</link>
+                        
+                        参照ください.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Linux/Unix/MacOSXで,ネーティブライブラリjavasci2が存在しない
+                        
+                        または見つかりません.
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        おそらく the java.library.path の値が設定されていません. 
+                        
+                        <link linkend="compile_and_run_javasci_v2">javasciでコンパイル/実行</link>
+                        
+                        参照ください.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Windowsで, ネーティブライブラリ javasci.dll が存在しないまたは見つかりません.
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>環境変数 PATH が設定されていない可能性があります. 
+                        
+                        <link linkend="compile_and_run_javasci_v2">javasciでコンパイル/実行</link>
+                        
+                        参照ください.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Linux/Unix/MacOSXで, java.library.path を設定した
+                        
+                        後でも,ネーティブライブラリjavasci2 が
+                        
+                        存在しないまたは見つかりません.
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        以下のようなエラーが発生した場合: <emphasis role="italic">java.lang.UnsatisfiedLinkError: /path/to/scilab/lib/scilab/libscilab.so.0.0.0: libsciparameters.so.5: cannot open shared object file: No such file or directory</emphasis>, 
+                        
+                        LD_LIBRARY_PATHにScilabネーティブライブラリが存在するパスを設定して
+                        
+                        みてください.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Windowsで, PATHを設定した後でもネーティブライブラリ
+                        
+                        javasci.dll が存在しないまたは見つかりません.
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        以下のようなエラーが発生した場合: <emphasis role="italic">java.lang.UnsatisfiedLinkError: C:\Program Files\scilab-XXXX\bin\javasci.dll: The specified procedure could not be found</emphasis>, 
+                        
+                        環境変数PATHにより,Scilabライブラリと使用するシステム上の他のライブラリが
+                        
+                        衝突するようになった可能性があります.
+                        
+                        (PATH変数で)Scilabパスを他のパスの前に移動してみてください.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Javasciプログラムが以下のように起動に失敗します:
+                        
+                        <emphasis role="italic">An exception occurred: Auto detection of SCI failed.
+                            
+                            Could not retrieve the variable SCI
+                            
+                        </emphasis>
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        SCIを, GNU/Linuxでは
+                        
+                        <emphasis role="italic">scilab-X.Y.Z/share/scilab/</emphasis>,
+                        
+                        Mac OS Xでは
+                        
+                        <emphasis role="italic">scilab-X.Y.Z/Contents/MacOS/share/scilab/</emphasis>,
+                        
+                        Windowsでは
+                        
+                        <emphasis role="italic">scilab-X.Y.Z/</emphasis>
+                        
+                        に設定する必要があります.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        グラフィックをプロットしようとしましたが,
+                        
+                        グラフィックが現れません.
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        論理値 <emphasis role="italic">true</emphasis>を指定して
+                        
+                        コンストラクタ
+                        
+                        (<emphasis role="italic">Scilab sci = new Scilab(true);</emphasis>) 
+                        
+                        をコールしたか確認してください.
+                        
+                        これにより, Scilab をアドバンスドモードで起動します.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Javasciから既存のSwingアプリケーションにアタッチしようと
+                        
+                        しています.
+                        
+                        どのようにすればよいのでしょう?
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        現時点では, 簡単に行うことはできません.
+                        
+                        この機能は将来のバージョンのScilabで提供されます.
+                        
+                        いつもと同様, 貢献はウエルカムです!
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        javasciからScilabグラフィックウインドウを管理する現在の手法は
+                        
+                        非常に大変とわかりました.
+                        
+                        どのようにすれば良いのでしょう?
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para>
+                        
+                        困りましたね. 我々は現在のソリューションは完全とはほど遠いと認識しています.
+                        
+                        この制限に将来のリリースで対応したいと考えています.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+            <qandaentry>
+                
+                <question>
+                    
+                    <para>
+                        
+                        Scilabインスタンスが外部モジュールを有しますが,
+                        
+                        <literal>undefined symbol</literal>により起動に失敗しました:
+                        
+                    </para>
+                    
+                </question>
+                
+                <answer>
+                    
+                    <para><literal>
+                            
+                            <emphasis role="italic">atomsLoad: An error occurred while loading 'module-0.0.2': link : Library could not be loaded: /path/2.0-1/sci_gateway/c/../../src/cpp/libmy.so: undefined symbol: scirun_</emphasis>
+                            
+                        </literal>
+                        
+                        これには,2種類の解決策が考えられます.
+                        
+                        1番目は,
+                        
+                        シンボルを定義するライブラリを指定して構築することにより,
+                        
+                        モジュール自体を修正するものです.
+                        
+                        2番目は,未定義の変数が宣言されたライブラリを
+                        
+                        <literal>LD_PRELOAD=/path/to/the/lib/providing/the/symbol/libmy.so</literal>で
+                        
+                        定義することです.
+                        
+                    </para>
+                    
+                </answer>
+                
+            </qandaentry>
+            
+        </qandaset>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link> を閲覧(これによりWebブラウザがオープンします).
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="javasci">Javasci</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="compile_and_run_javasci_v2">javasciでコンパイル/実行</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/javasci/help/ja_JP/javasci_limitations.xml b/scilab/modules/javasci/help/ja_JP/javasci_limitations.xml
new file mode 100644 (file)
index 0000000..4e2283a
--- /dev/null
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA - Allan CORNET
+ * 
+ * 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" xmlns:scilab="http://www.scilab.org" xml:id="javasci_v1_limitations" scilab:needs-examples="no" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>javasci v1 の制限</refname>
+        
+        <refpurpose>なぜjavasci v1は廃止されたのですか?</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>説明</title>
+        
+        <para>javasciのバージョンV1には以下に示すいくつかの重要な制限がありました:</para>
+        
+        <itemizedlist>
+            
+            <listitem>
+                
+                Scilab言語か任意の変数を取得するためには,
+                
+                事前に変数の型を知ることが必要でした.
+                
+            </listitem>
+            
+            <listitem>
+                
+                インターフェイスにより管理されるのは小数の型のみでした
+                
+                (論理値, double, 複素数および文字列).
+                
+            </listitem>
+            
+            <listitem>
+                
+                ScilabとJavaの間で整合性を欠いていました.
+                
+                例えば, Scilab では,スカラー ([1,1]の行列)は行列です.
+                
+                Javaインターフェイスでは, 異なる2種類のデータ型
+                
+                (例: SciDouble および SciDoubleArray)となります.
+                
+            </listitem>
+            
+            <listitem>
+                
+                多くのデータ型ではシリアル化ができませんでした.
+                
+            </listitem>
+            
+            <listitem>
+                
+                Scilab関数のコールはExecメソッドでのみ可能で,
+                
+                複数の出力引数を取得する場合に複雑になっていました.
+                
+            </listitem>
+            
+            <listitem>
+                
+                パッケージ名はScilabおよびScilab Java checkstyleの
+                
+                パッケージ名命名規則に従っていませんでした.
+                
+            </listitem>
+            
+            <listitem>
+                
+                グラフィックウインドウの管理が大変でした
+                
+                (この問題はJavasci v2でもまだ未解決です).
+                
+            </listitem>
+            
+            <listitem>
+                
+                イベントループとの連携がありません
+                
+                (この問題はJavasci v2でもまだ未解決です).
+                
+            </listitem>
+            
+        </itemizedlist>
+        
+    </refsection>
+    
+    <refsection role="see also">
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link> を閲覧(これによりWebブラウザがオープンします).
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="compile_and_run_javasci_v2">Javasciでコンパイル/実行</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="javasci_faq_v2">Javasci FAQ</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>履歴</title>
+        
+        <revhistory>
+            
+            <revision>
+                
+                <revnumber>5.4.0</revnumber>
+                
+                <revdescription>
+                    
+                    Javasci v1 が削除されました.
+                    
+                </revdescription>
+                
+            </revision>
+            
+        </revhistory>
+        
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/javasci/help/ja_JP/javasci_step_by_step.xml b/scilab/modules/javasci/help/ja_JP/javasci_step_by_step.xml
new file mode 100644 (file)
index 0000000..6b8eaea
--- /dev/null
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2010 - 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" xmlns:scilab="http://www.scilab.org" xml:id="javasci_step_by_step" scilab:needs-examples="no" xml:lang="ja">
+    
+    <refnamediv>
+        
+        <refname>javasci - ステップバイステップ</refname>
+        
+        <refpurpose>javasci v2に基づくアプリケーションの書き方</refpurpose>
+        
+    </refnamediv>
+    
+    <refsection>
+        
+        <title>ステップ1 - コード本体</title>
+        
+        <para>Javasci v2 では Java APIからScilabエンジンをコールできます.
+            
+        </para>
+        
+        <para>
+            
+            いくつかのオブジェクトとメソッドがこのようなタスクを実行するために
+            
+            提供されています.
+            
+            メインクラスは <emphasis role="italic">Scilab</emphasis>です. 
+            
+            このオブジェクトにより, Scilabエンジンからのデータ送信/受信,
+            
+            エラー管理およびScilabスクリプト/コードの実行ができるようになります.
+            
+        </para>
+        
+        <para>クラスは以下の2つのパッケージに分割されています: </para>
+        
+        <itemizedlist>
+            
+            <listitem>org.scilab.modules.javasci.*; // 主要なScilabクラスを含む</listitem>
+            
+            <listitem>org.scilab.modules.types.*; // Scilab &lt;=&gt; Javaマッピングを含む</listitem>
+            
+        </itemizedlist>
+        
+        <para>
+            
+            <para>以下に古典的な使用例を示します:</para>
+            
+        </para>
+        
+        <programlisting role="java"><![CDATA[
+/*
+ *
+ * This file is released under the 3-clause BSD license. See COPYING-BSD.
+ *
+ */
+
+import org.scilab.modules.javasci.Scilab;
+import org.scilab.modules.types.ScilabType;
+import org.scilab.modules.types.ScilabDouble;
+
+class Example1 {
+
+    public static void main(String[] args) {
+        try {
+            Scilab sci = new Scilab();
+            if (sci.open()) {
+                /* Send a Scilab instruction */
+                sci.exec("foo = [ 2, 4, 6; 4, 0, 10; 6, 10, 12 ];");
+
+/* Retrieve the variable foo */
+                ScilabType foo = sci.get("foo");
+
+/* Display the variable */
+                System.out.println("Representation of  : "+foo);
+
+/* Get the data and retrieve the 2,2 value */
+                double[][] aReal = ((ScilabDouble)foo).getRealPart();
+                System.out.println("foo[1,1] = " + aReal[1][1]);
+
+/* Change the value of 2,2 */
+                aReal[1][1] = Math.PI;
+
+/* Create a new variable */
+                ScilabDouble bar = new ScilabDouble(aReal);
+
+/* Send it to Scilab */
+                sci.put("bar",bar);
+
+/* Display it through Scilab */
+                sci.exec("disp(bar)");
+
+                sci.close();
+            } else {
+                System.out.println("Could not start Scilab ");
+            }
+
+
+/* Can be improved by other exceptions: AlreadyRunningException,
+ * InitializationException, UndefinedVariableException,
+ * UnknownTypeException, etc
+ */
+        } catch (org.scilab.modules.javasci.JavasciException e) {
+            System.err.println("An exception occurred: " + e.getLocalizedMessage());
+        }
+    }
+}
+
+
+        ]]></programlisting>
+        
+        <para>ソースは SCI/modules/javasci/examples/v2/ で提供されています</para>
+        
+        <para>このプログラムの出力は以下のようになります:</para>
+        
+        <programlisting><![CDATA[Representation of  : [2.0, 4.0, 6.0 ; 4.0, 0.0, 10.0 ; 6.0, 10.0, 12.0]
+foo[1,1] = 0.0
+
+2.    4.           6.
+4.    3.1415927    10.
+6.    10.          12.
+        ]]></programlisting>
+        
+        <para>
+            
+            オブジェクトおよびメソッドに関する詳細については,
+            
+            <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link>
+            
+            を閲覧してください (これによりWebブラウザがオープンします).
+            
+        </para>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>ステップ 2 - 構築</title>
+        
+        <para>
+            
+            GNU/Linux および Mac OS Xでは
+            
+            Scilabデータへのパスも指定します
+            
+            (Microsoft Windowsでは,自動的に検出されます).
+            
+        </para>
+        
+        <programlisting><![CDATA[# Variable SCI
+# GNU/LinuxのScilabバイナリのパス:
+/path/to/scilab-xxx/share/scilab/
+# GNU/LinuxおよびMac OS Xのソースツリーでは, パスはソースツリーのトップです
+/path/to/scilab/sources/
+# Mac OS X上の パス:
+/Applications/scilab-xxx/Contents/MacOS/share/scilab/
+# Windows上のパス:
+C:\Program Files\Scilab-5.3.0\
+        ]]></programlisting>
+        
+        <para>
+            
+            Javasci v2によりコードを構築するには,
+            
+            CLASSPATHに2つのjarファイルがある必要があります.
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[# 例えば, 変数CLASSPATHを作成
+$(SCI)/modules/javasci/jar/org.scilab.modules.javasci.jar
+$(SCI)/modules/types/jar/org.scilab.modules.types.jar
+]]></programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>ステップ3 - 実行</title>
+        
+        <para>構築ステップと同様, 2つのjarを指定します. </para>
+        
+        <para>
+            
+            JavaがScilabと通信するためにネーティブライブラリへのパスを設定する必要があります.
+            
+        </para>
+        
+        <para>
+            
+            Javasci v2は,2つのライブラリ
+            
+            libjavasci2.{so,dylib,dll} および libscilab.{so,dylib,dll}がロードされていることを
+            
+            必要とします.他のライブラリは透過的にロードされます.
+            
+        </para>
+        
+        <programlisting role="example"><![CDATA[# 例えば, 変数CLASSPATHを作成
+# GNU/LinuxのScilabバイナリのパス:
+/path/to/scilab-xxx/lib/scilab/
+# GNU/LinuxおよびMac OS Xのソースツリーのパス:
+$(SCI)/modules/javasci/.libs/:$(SCI)/modules/.libs/
+# Mac OS X上の パス:
+/Applications/scilab-xxx/Contents/MacOS/lib/scilab/
+# Windows上のパス:
+set LIBPATH="C:\Program Files\Scilab-5.3.0\bin"
+        ]]></programlisting>
+        
+        <para>プログラムを起動するコマンドは以下のようになります:</para>
+        
+        <programlisting>java -cp $CLASSPATH:. -DSCI=$SCI -Djava.library.path=$LIBPATH Example1</programlisting>
+        
+    </refsection>
+    
+    <refsection>
+        
+        <title>Makefileの例</title>
+        
+        <para>シンプルなMakefileは以下のようになります:</para>
+        
+        <programlisting><![CDATA[SCI = /path/to/scilab/share/scilab/
+CLASSPATH = $(SCI)/modules/javasci/jar/org.scilab.modules.javasci.jar:$(SCI)/modules/types/jar/org.scilab.modules.types.jar
+LIB_PATH = /path/to/scilab/lib/scilab
+all:
+javac -cp $(CLASSPATH) Example1.java
+java -cp $(CLASSPATH):. -DSCI=$(SCI) -Djava.library.path=$(LIB_PATH) Example1
+        ]]></programlisting>
+        
+    </refsection>
+    
+    <para>SCI/modules/javasci/examples/v2 ディレクトリにある
+        
+        Windows用build.batを参照ください.
+    </para>
+    
+    <refsection>
+        
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            
+            <member>
+                
+                <link type="remote" linkend="javasci/javadoc/index.html">Javasci v2の文書</link> を閲覧(これによりWebブラウザがオープンします).
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="compile_and_run_javasci_v2">Javasci v2でコンパイル/実行</link>
+                
+            </member>
+            
+            <member>
+                
+                <link linkend="javasci_faq_v2">Javasci v2 FAQ</link>
+                
+            </member>
+            
+        </simplelist>
+        
+    </refsection>
+    
+</refentry>
+