8 files changed, 626 insertions, 0 deletions
diff --git a/help/en_US/annotation_tag/CHAPTER b/help/en_US/annotation_tag/CHAPTER
new file mode 100644
index 00000000..c32ac0b3
--- /dev/null
+++ b/help/en_US/annotation_tag/CHAPTER
@@ -0,0 +1 @@
+title = Annotation TAGS
diff --git a/help/en_US/annotation_tag/NIN.xml b/help/en_US/annotation_tag/NIN.xml
new file mode 100644
index 00000000..32f41b99
--- /dev/null
+++ b/help/en_US/annotation_tag/NIN.xml
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+   * Copyright (C) DIGITEO - Bruno JOFRET
+   *
+   * This file is released into the public domain
+   *
+  -->
+<refentry version="5.0-subset Scilab" xml:id="scilab2c_tag_NIN" xml:lang="en"
+          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">
+  <info>
+    <pubdate>$LastChangedDate$</pubdate>
+  </info>
+
+  <refnamediv>
+    <refname>NIN annotation tag</refname>
+    <refpurpose>Scilab2C Function annotation : NIN</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <title>Calling Sequence</title>
+
+    <synopsis>
+      //SCI2C: NIN=    number
+    </synopsis>
+  </refsynopsisdiv>
+
+  <refsection>
+    <title>Parameters</title>
+    <variablelist>
+      <varlistentry>
+        <term>number</term>
+        <listitem>
+          <para>Specifies the number of input arguments</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+  </refsection>
+
+  <refsection>
+    <title>Description</title>
+    <para>This annotation must be placed before a user function to allow Scilab2C to convert it.</para>
+  </refsection>
+
+  <refsection>
+    <title>Examples</title>
+
+    <programlisting role="example"><![CDATA[
+//SCI2C: NIN= 0
+function helloWorld()
+  disp("Hello World !");
+emdfunction
+]]></programlisting>
+
+    <programlisting role="example"><![CDATA[
+//SCI2C: NIN= 1
+function displayArg(x)
+  disp("x");
+emdfunction
+]]>
+    </programlisting>
+
+    <programlisting role="example"><![CDATA[
+//SCI2C: NIN= 2
+function z=doAddition(x, y)
+  z = x + y;
+emdfunction
+]]>
+    </programlisting>
+
+</refsection>
+
+  <refsection>
+    <title>Authors</title>
+
+    <simplelist type="vert">
+      <member>Bruno JOFRET</member>
+      <member>Raffaele NUTRICATO</member>
+    </simplelist>
+  </refsection>
+</refentry>
diff --git a/help/en_US/build_help.sce b/help/en_US/build_help.sce
new file mode 100644
index 00000000..783533c9
--- /dev/null
+++ b/help/en_US/build_help.sce
@@ -0,0 +1,12 @@
+// ====================================================================
+// Copyright INRIA 2008
+// Allan CORNET
+// Simon LIPP
+// This file is released into the public domain
+// ====================================================================
+
+help_lang_dir = get_absolute_file_path('build_help.sce');
+
+tbx_build_help(TOOLBOX_TITLE, help_lang_dir);
+
+clear help_lang_dir;
diff --git a/help/en_US/runscicode.xml b/help/en_US/runscicode.xml
new file mode 100644
index 00000000..981caf4b
--- /dev/null
+++ b/help/en_US/runscicode.xml
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) DIGITEO - Bruno JOFRET
+    *
+    * This file is released into the public domain
+    *
+  -->
+<refentry version="5.0-subset Scilab" xml:id="runscicode" xml:lang="en"
+          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">
+  <info>
+    <pubdate>$LastChangedDate$</pubdate>
+  </info>
+
+  <refnamediv>
+    <refname>runscicode</refname>
+
+    <refpurpose>Launch a scilabfunction with specific path loaded.</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <title>Calling Sequence</title>
+
+    <synopsis>
+      runscicode(UserScilabMainFile, UserSciFilesPaths);
+    </synopsis>
+  </refsynopsisdiv>
+
+  <refsection>
+    <title>Parameters</title>
+    <variablelist>
+      <varlistentry>
+        <term>UserScilabMainFile</term>
+        <listitem>
+          <para>This file should contain the main scilab function to run.</para>
+	  <para>The function should have the same name as the file.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>UserSciFilesPaths</term>
+        <listitem>
+          <para>This is a matrix of PATH containing .sci files.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+  </refsection>
+
+  <refsection>
+    <title>Description</title>
+
+    <para>Run a Scilab function with specific PATH loaded.</para>
+
+    <para>This function will load all .sci files given in UserSciFilesPaths.
+Then it loads UserScilabMainFile and the function corresponding to the file name is launched.</para>
+  </refsection>
+
+  <refsection>
+    <title>Examples</title>
+
+    <programlisting role="example">
+      runscicode("./mysScript.sci", []);
+      // Will load myScript.sci then run myScript()
+      runscicode("./myScript.sci", "/tmp/myScriptDependencies");
+      // Will load each .sci file in /tmp/myScriptDependencies
+      // Then load myScript.sci and run myScript()
+    </programlisting>
+  </refsection>
+
+  <refsection>
+    <title>Authors</title>
+
+    <simplelist type="vert">
+      <member>Bruno JOFRET</member>
+      <member>Raffaele NUTRICATO</member>
+    </simplelist>
+  </refsection>
+</refentry>
diff --git a/help/en_US/scilab2c.xml b/help/en_US/scilab2c.xml
new file mode 100644
index 00000000..c726406e
--- /dev/null
+++ b/help/en_US/scilab2c.xml
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+    * Copyright (C) DIGITEO - Bruno JOFRET
+    *
+    * This file is released into the public domain
+    *
+  -->
+<refentry version="5.0-subset Scilab" xml:id="scilab2c" xml:lang="en"
+          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">
+  <info>
+    <pubdate>$LastChangedDate$</pubdate>
+  </info>
+
+  <refnamediv>
+    <refname>scilab2c</refname>
+
+    <refpurpose>Scilab to C Converter</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <title>Calling Sequence</title>
+
+    <synopsis>
+      scilab2c();
+      scilab2c(inputScript, outputPath);
+      scilab2c(inputScript, outputPath, pathToADditionnalFunctions);
+      scilab2c(inputScript, outputPath, pathToADditionnalFunctions, RunMode);
+   </synopsis>
+  </refsynopsisdiv>
+
+  <refsection>
+    <title>Parameters</title>
+    <variablelist>
+      <varlistentry>
+        <term>inputScript</term>
+        <listitem>
+          <para>This file should contain the scilab function we want
+	    to translate.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>outputPath</term>
+        <listitem>
+          <para>Output Path for code genrated and logs.</para>
+        </listitem>
+      </varlistentry>
+
+     <varlistentry>
+	<term>pathToADditionnalFunctions</term>
+        <listitem>
+          <para>This is the path to look in for additional user defined functions.</para>
+        </listitem>
+      </varlistentry>
+
+     <varlistentry>
+	<term>RunMode</term>
+        <listitem>
+          <para>Must be "All", "Translate" or "GenLibraryStructure"</para>
+        </listitem>
+      </varlistentry>
+
+   </variablelist>
+
+  </refsection>
+
+  <refsection>
+    <title>Description</title>
+
+    <para>Convert a scilab function into a C File.</para>
+
+  </refsection>
+
+  <refsection>
+    <title>Examples</title>
+
+    <programlisting role="example">
+      // Launch the GUI
+      scilab2c();
+
+      // Convert the function present in myScript.sci
+      // into a C file : myMain.c
+      scilab2c("./mysScript.sci", "./");
+
+      // Example in unit_tests
+      global SCI2CHOME
+      scilab2c(SCI2CHOME+"/tests/unit_tests/test000_TrigonIdentity/scilabcode/mainfunction.sci", TMPDIR);
+    </programlisting>
+  </refsection>
+
+  <refsection>
+    <title>See Also</title>
+    <simplelist type="inline">
+      <member>
+        <link linkend="scilab2c_annotations">Sciab2C Annotations</link>
+      </member>
+    </simplelist>
+  </refsection>
+
+  <refsection>
+    <title>Authors</title>
+
+    <simplelist type="vert">
+      <member>Bruno JOFRET</member>
+      <member>Raffaele NUTRICATO</member>
+    </simplelist>
+  </refsection>
+</refentry>
diff --git a/help/en_US/scilab2c_annotations.xml b/help/en_US/scilab2c_annotations.xml
new file mode 100644
index 00000000..2e412827
--- /dev/null
+++ b/help/en_US/scilab2c_annotations.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+   * Copyright (C) DIGITEO - Bruno JOFRET
+   *
+   * This file is released into the public domain
+   *
+  -->
+<refentry version="5.0-subset Scilab" xml:id="scilab2c_annotations" xml:lang="en"
+          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">
+  <info>
+    <pubdate>$LastChangedDate$</pubdate>
+  </info>
+
+  <refnamediv>
+    <refname>Scilab2C Annotations</refname>
+
+    <refpurpose>Scilab to C Converter : Annotations How To</refpurpose>
+  </refnamediv>
+
+  <refsection>
+    <title>Introduction</title>
+    <para>
+      Both data and functions declared into the Scilab source code must be annotated in order make the translator able to extract size, precision and type of data and of input and output function arguments.
+    </para>
+  </refsection>
+
+  <refsection>
+    <title>See Also</title>
+     <simplelist type="inline">
+      <member>
+        <link linkend="scilab2c">Scilab2C Code Generator</link>,
+        <link linkend="scilab2c_data_annotations">Data annotations</link>,
+        <link linkend="scilab2c_functions_annotations">Functions annotations</link>
+      </member>
+     </simplelist>
+  </refsection>
+
+  <refsection>
+    <title>Authors</title>
+    <simplelist type="vert">
+      <member>Bruno JOFRET</member>
+      <member>Raffaele NUTRICATO</member>
+    </simplelist>
+  </refsection>
+</refentry>
diff --git a/help/en_US/scilab2c_data_annotations.xml b/help/en_US/scilab2c_data_annotations.xml
new file mode 100644
index 00000000..f8dc32c6
--- /dev/null
+++ b/help/en_US/scilab2c_data_annotations.xml
@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+   * Copyright (C) DIGITEO - Bruno JOFRET
+   *
+   * This file is released into the public domain
+   *
+  -->
+<refentry version="5.0-subset Scilab" xml:id="scilab2c_data_annotations" xml:lang="en"
+          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">
+  <info>
+    <pubdate>$LastChangedDate$</pubdate>
+  </info>
+
+  <refnamediv>
+    <refname>Scilab2C Data Annotations</refname>
+
+    <refpurpose>Scilab to C Converter : Data Annotations How To</refpurpose>
+  </refnamediv>
+
+  <refsection>
+    <title>Description</title>
+    <para>
+      Data annotations are used to define the size, type and precisions of variables and numbers used in the Scilab code.
+    </para>
+    <para>
+      By default Sci2C assumes the double precision, which is the default precision used by the Scilab language.
+      Actually the whole Scilab software only works with double precision. Pay attention that the computation done in Scilab and the C code generated with single precision can differ.
+    </para>
+    <para>
+      It is possible to force a default precision for each source file, by using a dedicated annotation that must be inserted after the function annotation section (Cf. <link linkend="scilab2c_functions_annotations">Function Annotation.</link>):
+      <programlisting role=""><![CDATA[//SCI2C: DEFAULT_PRECISION= precision]]></programlisting>
+
+      This annotation specifies the default precision for all the data used in the function body.
+      Allowed settings for precision are:
+      <itemizedlist>
+        <listitem><literal><![CDATA[//SCI2C: DEFAULT_PRECISION= FLOAT]]></literal></listitem>
+        <listitem><literal><![CDATA[//SCI2C: DEFAULT_PRECISION= DOUBLE]]></literal></listitem>
+      </itemizedlist>
+      If not otherwise specified, the precision of the data will be float single and float double, respectively.
+    </para>
+
+    <para>
+      It is also possible to force some variable having a certain type using functions :
+      <itemizedlist>
+        <listitem>float: forces a variable or a number or a matrix of numbers to be real float.</listitem>
+        <listitem>double: forces a variable or a number or a matrix of numbers to be real double.</listitem>
+        <listitem>floatcomplex: forces a variable or a number or a matrix of numbers to be complex float.</listitem>
+        <listitem>doublecomplex: forces a variable or a number or a matrix of numbers to be complex double.</listitem>
+      </itemizedlist>
+    </para>
+
+  </refsection>
+
+  <refsection>
+    <title>Example 1</title>
+      <programlisting role="example"><![CDATA[
+//SCI2C: DEFAULT_PRECISION= FLOAT
+y = 10;
+]]></programlisting>
+      This will generate a C code with the <literal>y</literal> variable declared as a scalar, real, float.
+  </refsection>
+
+  <refsection>
+    <title>Example 2</title>
+      <programlisting role="example"><![CDATA[
+x = -10.3;
+y = zeros(10,3);
+z = double(-10.3);
+]]></programlisting>
+      Assuming <literal><![CDATA[//SCI2C: DEFAULT_PRECISION]]></literal> is not present, the default precision will be <literal><![CDATA[DOUBLE]]></literal>
+      This will generate a C code with
+      <itemizedlist>
+        <listitem>
+          <literal>x</literal> as scalar real double.
+        </listitem>
+        <listitem>
+          <literal>y</literal> as 10 by 3 matrix of real double filled with zeros.
+        </listitem>
+        <listitem>
+          <literal>z</literal> as scalar real double. In this case the double specifier is redundant.
+        </listitem>
+      </itemizedlist>
+  </refsection>
+
+
+  <refsection>
+    <title>Example 3</title>
+      <programlisting role="example"><![CDATA[
+//SCI2C: DEFAULT_PRECISION= FLOAT
+x = -10.3;
+y = float(zeros(10,3));
+z = double(-10.3);
+]]></programlisting>
+      This will generate a C code with
+      <itemizedlist>
+        <listitem>
+          <literal>x</literal> as scalar real float.
+        </listitem>
+        <listitem>
+          <literal>y</literal> as 10 by 3 matrix of real float filled with zeros. In this case the float specifier is redundant.
+        </listitem>
+        <listitem>
+          <literal>z</literal> as scalar real double.
+        </listitem>
+      </itemizedlist>
+  </refsection>
+
+
+  <refsection>
+    <title>Example 4</title>
+      <programlisting role="example"><![CDATA[
+//SCI2C: DEFAULT_PRECISION= FLOAT
+x = double(3);
+y = double(4);
+z = x + y;
+]]></programlisting>
+      This will generate a C code with
+      <itemizedlist>
+        <listitem>
+          <literal>x</literal> as scalar real double.
+        </listitem>
+        <listitem>
+          <literal>y</literal> as scalar real double.
+        </listitem>
+        <listitem>
+          <literal>z</literal> as scalar real double. According to the behaviour of <literal>+</literal> operator and due to the fact that <literal>x</literal>
+          and <literal>y</literal> are both in double precision, Scilab2C will set <literal>z</literal> with double precision.
+        </listitem>
+      </itemizedlist>
+  </refsection>
+
+  <refsection>
+    <title>See Also</title>
+    <simplelist type="inline">
+      <member>
+        <link linkend="scilab2c_annotations">Sciab2C Annotations</link>,
+        <link linkend="scilab2c">Scilab2C Code Generator</link>
+      </member>
+    </simplelist>
+  </refsection>
+
+
+
+  <refsection>
+    <title>Authors</title>
+    <simplelist type="vert">
+      <member>Bruno JOFRET</member>
+      <member>Raffaele NUTRICATO</member>
+    </simplelist>
+  </refsection>
+</refentry>
diff --git a/help/en_US/scilab2c_functions_annotations.xml b/help/en_US/scilab2c_functions_annotations.xml
new file mode 100644
index 00000000..15a4d97a
--- /dev/null
+++ b/help/en_US/scilab2c_functions_annotations.xml
@@ -0,0 +1,121 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+   * Copyright (C) DIGITEO - Bruno JOFRET
+   *
+   * This file is released into the public domain
+   *
+  -->
+<refentry version="5.0-subset Scilab" xml:id="scilab2c_functions_annotations" xml:lang="en"
+          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">
+  <info>
+    <pubdate>$LastChangedDate$</pubdate>
+  </info>
+
+  <refnamediv>
+    <refname>Scilab2C Functions Annotations</refname>
+
+    <refpurpose>Scilab to C Converter : Functions Annotations How To</refpurpose>
+  </refnamediv>
+
+  <refsection>
+    <title>Description</title>
+    <para>
+      The annotation of every Scilab function is mandatory. Only the main function of the Scilab program you are translating doesn’t need any annotation.
+    </para>
+    <para>
+      The main function can not return any output argument and can not accept any input argument.
+    </para>
+    <para>
+      It is important to specify for each output argument of the Scilab function, its size and type in order to have the possibility to allocate the correct memory space at translation time.
+      When the size of the returned output can be estimated only at run time, as happens for find-like functions that return an output whose size is related to the condition tested by the function,
+      the user must be able to specify at least the maximum size that can be returned by the function.
+      If it is not possible then the function should dynamically allocate memory and so can not be translated by Sci2C.
+    </para>
+    <para>
+      Function annotation must specify:
+      <itemizedlist>
+        <listitem>the number of input arguments. (See <link linkend="scilab2c_tag_NIN">NIN tag</link>)</listitem>
+        <listitem>the number of output arguments. (See <link linkend="scilab2c_tag_NOUT">NOUT tag</link>)</listitem>
+        <listitem>the type and precision of each output argument. (See <link linkend="scilab2c_tag_TP">TP tag</link>)</listitem>
+        <listitem>the size of every output argument. (See <link linkend="scilab2c_tag_SZ">SZ tag</link>)</listitem>
+        <listitem>the default precision for the data declared in the function body.</listitem>
+      </itemizedlist>
+    </para>
+  </refsection>
+
+  <refsection>
+    <title>Simple Example</title>
+    <programlisting role="example"><![CDATA[
+//SCI2C: NIN= 1
+//SCI2C: NOUT= 2
+//SCI2C: OUT(1).TP= IN(1).TP
+//SCI2C: OUT(1).SZ(1)= IN(1).SZ(1)
+//SCI2C: OUT(1).SZ(2)= IN(1).SZ(2)
+//SCI2C: OUT(2).TP= IN(1).TP
+//SCI2C: OUT(2).SZ(1)= IN(1).SZ(1)
+//SCI2C: OUT(2).SZ(2)= IN(1).SZ(2)
+//SCI2C: DEFAULT_PRECISION= DOUBLE
+]]></programlisting>
+    This will declare a function with the following informations:
+    <itemizedlist>
+      <listitem>1 input argument.</listitem>
+      <listitem>2 output arguments.</listitem>
+      <listitem>first output argument has the same type than first input argument.</listitem>
+      <listitem>first output argument has the same width than first input argument.</listitem>
+      <listitem>first output argument has the same height than first input argument.</listitem>
+      <listitem>second output argument has the same type than first input argument.</listitem>
+      <listitem>second output argument has the same width than first input argument.</listitem>
+      <listitem>second output argument has the same height than first input argument.</listitem>
+    </itemizedlist>
+  </refsection>
+
+  <refsection>
+    <title>Simple Example</title>
+    <programlisting role="example"><![CDATA[
+NIN=          2
+NOUT=         2
+OUT(1).TP=    IN(1).TP
+OUT(1).SZ(1)= '1'
+OUT(1).SZ(2)= FA_MUL(IN(1).SZ(1),IN(1).SZ(2))
+OUT(2).TP=    IN(1).TP
+OUT(2).SZ(1)= '1'
+OUT(2).SZ(2)= FA_MUL(IN(1).SZ(1),IN(1).SZ(2))
+]]></programlisting>
+    This will declare a function with the following informations:
+    <itemizedlist>
+      <listitem>2 input arguments.</listitem>
+      <listitem>2 output arguments.</listitem>
+      <listitem>first output argument has the same type than first input argument.</listitem>
+      <listitem>first output argument is a row vetor.</listitem>
+      <listitem>first output argument's height is the product of the first input width by height.</listitem>
+      <listitem>second output argument has the same type than first input argument.</listitem>
+      <listitem>second output argument is a row vector.</listitem>
+      <listitem>second output argument's height is the product of the first input width by height.</listitem>
+    </itemizedlist>
+  </refsection>
+  <refsection>
+    <title>See Also</title>
+    <simplelist type="inline">
+      <member>
+        <link linkend="scilab2c_annotations">Sciab2C Annotations</link>,
+        <link linkend="scilab2c">Scilab2C Code Generator</link>
+      </member>
+    </simplelist>
+  </refsection>
+
+
+
+  <refsection>
+    <title>Authors</title>
+    <simplelist type="vert">
+      <member>Bruno JOFRET</member>
+      <member>Raffaele NUTRICATO</member>
+    </simplelist>
+  </refsection>
+</refentry>