Improve the Javasci documentation (FAQ)

- split the "Javasci cannot be found" issues into Linux & Windows issues
- add an entry for http://bugzilla.scilab.org/show_bug.cgi?id=12226

Change-Id: I22473601645905cca828625c44507090666b22bf

diff --git a/scilab/modules/javasci/help/en_US/javasci_faq.xml b/scilab/modules/javasci/help/en_US/javasci_faq.xml
index 46143ad..b61f95c 100644 (file)
--- a/scilab/modules/javasci/help/en_US/javasci_faq.xml
+++ b/scilab/modules/javasci/help/en_US/javasci_faq.xml
@@ -2,11 +2,11 @@
 <!--
  * 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    
+ * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
  *
  -->
@@ -34,17 +34,27 @@
             </qandaentry>
             <qandaentry>
                 <question>
-                    <para>The native library javasci2 does not exist or cannot be found.</para>
+                    <para>On Linux/Unix/MacOSX, the native library javasci2 does not exist or cannot be found.</para>
+                </question>
+                <answer>
+                    <para>Probably the java.library.path value has not been set. See
+                        <link linkend="compile_and_run_javasci_v2">Compile and run with javasci</link>
+                    </para>
+                </answer>
+            </qandaentry>
+            <qandaentry>
+                <question>
+                    <para>On Windows, the native library javasci.dll does not exist or cannot be found.</para>
                 </question>
                 <answer>
-                    <para>java.library.path has not been set or cannot be found.
+                    <para>The PATH environment variable may have not been set. See
                         <link linkend="compile_and_run_javasci_v2">Compile and run with javasci</link>
                     </para>
                 </answer>
             </qandaentry>
             <qandaentry>
                 <question>
-                    <para>The native library javasci2 does not exist or cannot be found even if java.library.path being set</para>
+                    <para>On Linux/Unix/MacOSX, the native library javasci2 does not exist or cannot be found even if the java.library.path is being set.</para>
                 </question>
                 <answer>
                     <para>
@@ -54,6 +64,16 @@
             </qandaentry>
             <qandaentry>
                 <question>
+                    <para>On Windows, the native library javasci.dll does not exist or cannot be found even if the PATH is being set.</para>
+                </question>
+                <answer>
+                    <para>
+                        If the error is something like: <emphasis role="italic">java.lang.UnsatisfiedLinkError: C:\Program Files\scilab-XXXX\bin\javasci.dll: The specified procedure could not be found</emphasis>, your PATH environment variable may introduce a conflict between the Scilab libraries with other libraries on your system. Try to move (in the PATH variable) the Scilab path to the front of paths.
+                    </para>
+                </answer>
+            </qandaentry>
+            <qandaentry>
+                <question>
                     <para>A Javasci program fails to start with:
                         <emphasis role="italic">An exception occurred: Auto detection of SCI failed.
                             Could not retrieve the variable SCI
@@ -66,7 +86,7 @@
                     </para>
                 </answer>
             </qandaentry>
-            
+
             <qandaentry>
                 <question>
                     <para>I try to plot a graphic but the graphic never appears.</para>