* Bug 14521 fixed: CONVERT block: missing doc for types 2,6,7,8 04/19804/6
Samuel GOUGEON [Mon, 26 Feb 2018 21:44:04 +0000 (22:44 +0100)]
  http://bugzilla.scilab.org/14521

  The fr_FR GUI image will be updated separately after updating mo/po files

Change-Id: Iebc998960eec018aaf8b761e0fd0c18ed28e39a8

scilab/CHANGES.md
scilab/modules/helptools/images/CONVERT_gui.png
scilab/modules/scicos_blocks/locales/fr_FR.po
scilab/modules/scicos_blocks/macros/IntegerOp/CONVERT.sci
scilab/modules/xcos/help/en_US/palettes/Integer_pal/CONVERT.xml
scilab/modules/xcos/help/fr_FR/palettes/Integer_pal/CONVERT.xml
scilab/modules/xcos/help/gui/integer_pal/en_US/CONVERT_gui.png
scilab/modules/xcos/help/gui/integer_pal/fr_FR/CONVERT_gui.png

index 98d938b..3eb37f3 100644 (file)
@@ -373,6 +373,7 @@ Known issues
 ### Bugs fixed in 6.0.2:
 * [#7675](http://bugzilla.scilab.org/show_bug.cgi?id=7675): sparse() got a wrong result, when creation with many values in same position.
 * [#8127](http://bugzilla.scilab.org/show_bug.cgi?id=8127): When using `ode()`, some internal errors messages were in french.
+* [#14521](http://bugzilla.scilab.org/show_bug.cgi?id=14521): For the CONVERT Xcos block, types codes 2, 6, 7, and 8 were not documented.
 * [#15440](http://bugzilla.scilab.org/show_bug.cgi?id=15440): Scilab debug help page linked to Xcos debug.
 * [#15422](http://bugzilla.scilab.org/show_bug.cgi?id=15422): `strsubst("ab", "", "cd")` crashed Scilab.
 
index 5abc42b..fc2eacb 100644 (file)
Binary files a/scilab/modules/helptools/images/CONVERT_gui.png and b/scilab/modules/helptools/images/CONVERT_gui.png differ
index c5e77e1..65fb365 100644 (file)
@@ -140,7 +140,7 @@ msgstr "Effacer un bit"
 
 #, c-format
 msgid "Set %s block parameters"
-msgstr "Définir %s les paramètres du bloc"
+msgstr "Définir les paramètres du bloc %s"
 
 #, c-format
 msgid "Data Type %s"
index e183b49..20de79a 100644 (file)
@@ -30,9 +30,16 @@ function [x,y,typ]=CONVERT(job,arg1,arg2)
         model=arg1.model
         exprs=graphics.exprs
         while %t do
-            [ok,it,ot,np,exprs] = scicos_getvalue([msprintf(gettext("Set %s block parameters"), "CONVERT");" "; gettext("Type conversion");" "], ..
-            [gettext("Input Type (1:double, 3:int32, 4:int16, 5:int8, ...)"); gettext("Output Type (1:double, 3:int32, 4:int16, 5:int8, ...)"); ..
-            gettext("Do on Overflow (0:Nothing, 1:Saturate, 2:Error)")], ..
+            [ok,it,ot,np,exprs] = scicos_getvalue(..
+            [ msprintf(gettext("Set %s block parameters"), "CONVERT")
+              " "
+              gettext("Type conversion")
+              ""
+              "(a) 1|2:double   3:int32   4:int16   5:int8   6:uint32   7:uint16   8:uint8"
+              gettext("(b) 0:Nothing, 1:Saturate, 2:Error")], ..
+            [gettext("Input type (a)")
+             gettext("Output type (a)")
+             gettext("Do on overflow (b)")], ..
             list("vec",1,"vec",1,"vec",1), exprs);
             if ~ok then
                 break,
index a2994a3..c56bed0 100644 (file)
  *
  * See the file ./license.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="CONVERT">
+<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="CONVERT">
     <refnamediv>
         <refname>CONVERT</refname>
         <refpurpose>Data Type Conversion</refpurpose>
     </refnamediv>
     <refsection>
         <title>Block Screenshot</title>
-        <para>
-            <inlinemediaobject>
-                <imageobject>
-                    <imagedata align="center" fileref="../../../../images/palettes/CONVERT.png" valign="middle"/>
-                </imageobject>
-            </inlinemediaobject>
-        </para>
+        <inlinemediaobject>
+            <imageobject>
+                <imagedata align="center" fileref="../../../../images/palettes/CONVERT.png" valign="middle"/>
+            </imageobject>
+        </inlinemediaobject>
     </refsection>
     <refsection id="Contents_CONVERT">
         <title>Contents</title>
         <itemizedlist>
             <listitem>
-                <para>
-                    <link linkend="CONVERT">Data Type Conversion</link>
-                </para>
+              <xref linkend="Description_CONVERT">Description</xref>
             </listitem>
             <listitem>
-                <itemizedlist>
-                    <listitem>
-                        <para>
-                            <xref linkend="Palette_CONVERT">Palette</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Description_CONVERT">Description</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Data_Type_CONVERT">Data types</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Dialogbox_CONVERT">Dialog box</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Defaultproperties_CONVERT">Default properties</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Example_CONVERT">Example</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Interfacingfunction_CONVERT">Interfacing function</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Computationalfunction_CONVERT">Computational function</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Seealso_CONVERT">See also</xref>
-                        </para>
-                    </listitem>
-                </itemizedlist>
+              <xref linkend="Data_Type_CONVERT">Data types</xref>
             </listitem>
-        </itemizedlist>
-    </refsection>
-    <refsection id="Palette_CONVERT">
-        <title>Palette</title>
-        <itemizedlist>
             <listitem>
-                <para>
-                    <link linkend="Integer_pal">Integer palette</link>
-                </para>
-                <para/>
+              <xref linkend="Dialogbox_CONVERT">Parameters</xref>
             </listitem>
             <listitem>
-                <para>
-                    <link linkend="Commonlyusedblocks_pal">Commonly used blocks palette</link>
-                </para>
+              <xref linkend="Defaultproperties_CONVERT">Default properties</xref>
+            </listitem>
+            <listitem>
+              <xref linkend="Interfacingfunction_CONVERT">Interfacing function</xref>
+            </listitem>
+            <listitem>
+              <xref linkend="Computationalfunction_CONVERT">Computational function</xref>
+            </listitem>
+            <listitem>
+              <xref linkend="Example_CONVERT">Example</xref>
+            </listitem>
+            <listitem>
+              <xref linkend="Seealso_CONVERT">See also</xref>
             </listitem>
         </itemizedlist>
     </refsection>
         </itemizedlist>
     </refsection>
     <refsection id="Dialogbox_CONVERT">
-        <title>Dialog box</title>
-        <para>
-            <inlinemediaobject>
-                <imageobject>
-                    <imagedata align="center" fileref="../../../gui/integer_pal/en_US/CONVERT_gui.png" valign="middle"/>
-                </imageobject>
-            </inlinemediaobject>
-        </para>
-        <para/>
+        <title>Parameters</title>
+        <inlinemediaobject>
+            <imageobject>
+                <imagedata fileref="../../../gui/integer_pal/en_US/CONVERT_gui.png"  align="center" style="float:right"/>
+                <!-- align => Javahelp, style => Online -->
+            </imageobject>
+        </inlinemediaobject>
         <itemizedlist>
             <listitem>
                 <para>
-                    <emphasis role="bold">Input Type (1: double, 3:int32, 4:int16, 5:int8, ...)</emphasis>
+                    <emphasis role="bold">Input Type</emphasis> (1|2: double, 3:int32, 4:int16,
+                    5:int8, 6:uint32, 7:uint16, 8:uint8)
                 </para>
                 <para>
-                    It indicates the input data type that it can be a double or an integer: Between 1 and 8.
+                    Sets the output data type, that can be a double or an integer:
+                    Integer code in [1,8].
                 </para>
                 <para>Properties : Type 'vec' of size 1.</para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis role="bold">Output Type (1: double, 3:int32, 4:int16, 5:int8, ...)</emphasis>
+                    <emphasis role="bold">Output Type</emphasis> (1|2: double, 3:int32, 4:int16,
+                    5:int8, 6:uint32, 7:uint16, 8:uint8)
                 </para>
                 <para>
-                    It indicates the output data type that can be a double or an integer: Between 1 and 8.
+                    Sets the output data type, that can be a double or an integer:
+                    Integer code in [1,8].
                 </para>
                 <para>Properties : Type 'vec' of size 1.</para>
             </listitem>
                 <para>Properties : Type 'vec' of size 1.</para>
             </listitem>
         </itemizedlist>
+        <para/>
     </refsection>
     <refsection id="Defaultproperties_CONVERT">
         <title>Default properties</title>
             </listitem>
         </itemizedlist>
     </refsection>
-    <refsection id="Example_CONVERT">
-        <title>Example</title>
-        <para>
-            This example shows the sign bit's propagation during a conversion from int8 to int16.
-        </para>
-        <para>
-            <link type="scilab" linkend="scilab.xcos/xcos/examples/integer_pal/en_US/CONVERT_en_US.zcos">
-                <inlinemediaobject>
-                    <imageobject>
-                        <imagedata fileref="../../../../examples/integer_pal/en_US/CONVERT_en_US.zcos" align="center" valign="middle"/>
-                    </imageobject>
-                </inlinemediaobject>
-            </link>
-        </para>
-    </refsection>
     <refsection id="Interfacingfunction_CONVERT">
         <title>Interfacing function</title>
         <itemizedlist>
             </listitem>
         </itemizedlist>
     </refsection>
+    <refsection id="Example_CONVERT">
+        <title>Example</title>
+        <para>
+            This example shows the sign bit's propagation during a conversion from int8 to int16.
+        </para>
+        <para>
+            <link type="scilab" linkend="scilab.xcos/xcos/examples/integer_pal/en_US/CONVERT_en_US.zcos">
+                <inlinemediaobject>
+                    <imageobject>
+                        <imagedata fileref="../../../../examples/integer_pal/en_US/CONVERT_en_US.zcos" align="center" valign="middle"/>
+                    </imageobject>
+                </inlinemediaobject>
+            </link>
+        </para>
+    </refsection>
     <refsection role="see also" id="Seealso_CONVERT">
         <title>See also</title>
         <itemizedlist>
index 6dac73b..3795572 100644 (file)
  * along with this program.
  *
  -->
-<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:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="CONVERT" xml:lang="fr_FR" xml.mml="http://www.w3.org/1998/Math/MathML">
+<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:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+        xml:id="CONVERT" xml:lang="fr_FR" xml.mml="http://www.w3.org/1998/Math/MathML">
     <refnamediv>
         <refname>CONVERT</refname>
         <refpurpose>Conversion de type de données</refpurpose>
     </refnamediv>
     <refsection>
         <title>Aperçu</title>
-        <para>
-            <inlinemediaobject>
-                <imageobject>
-                    <imagedata align="center" fileref="../../../../images/palettes/CONVERT.png" valign="middle"/>
-                </imageobject>
-            </inlinemediaobject>
-        </para>
+        <inlinemediaobject>
+            <imageobject>
+                <imagedata align="center" fileref="../../../../images/palettes/CONVERT.png" valign="middle"/>
+            </imageobject>
+        </inlinemediaobject>
     </refsection>
     <refsection id="Contents_CONVERT">
         <title>Contenu</title>
         <itemizedlist>
             <listitem>
-                <para>
-                    <link linkend="CONVERT">Conversion de type de données</link>
-                </para>
+                <xref linkend="Description_CONVERT">Description</xref>
             </listitem>
             <listitem>
-                <itemizedlist>
-                    <listitem>
-                        <para>
-                            <xref linkend="Palette_CONVERT">Palettes</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Description_CONVERT">Description</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Data_Type_CONVERT">Types de données</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Dialogbox_CONVERT">Boîte de dialogue</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Defaultproperties_CONVERT">Propriétés par défaut</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Example_CONVERT">Exemple</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Interfacingfunction_CONVERT">Fonction d'interfaçage</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Computationalfunction_CONVERT">Fonction de calcul</xref>
-                        </para>
-                    </listitem>
-                    <listitem>
-                        <para>
-                            <xref linkend="Seealso_CONVERT">Voir aussi</xref>
-                        </para>
-                    </listitem>
-                </itemizedlist>
+                <xref linkend="Data_Type_CONVERT">Types de données</xref>
             </listitem>
-        </itemizedlist>
-    </refsection>
-    <refsection id="Palette_CONVERT">
-        <title>Palettes</title>
-        <itemizedlist>
             <listitem>
-                <para>
-                    <link linkend="Integer_pal">Palette Entier</link>
-                </para>
-                <para/>
+                <xref linkend="Dialogbox_CONVERT">Boîte de dialogue</xref>
             </listitem>
             <listitem>
-                <para>
-                    <link linkend="Commonlyusedblocks_pal">Palette Blocs couramment utiisés</link>
-                </para>
+                <xref linkend="Defaultproperties_CONVERT">Propriétés par défaut</xref>
+            </listitem>
+            <listitem>
+                <xref linkend="Interfacingfunction_CONVERT">Fonction d'interfaçage</xref>
+            </listitem>
+            <listitem>
+                <xref linkend="Computationalfunction_CONVERT">Fonction de calcul</xref>
+            </listitem>
+            <listitem>
+                <xref linkend="Example_CONVERT">Exemple</xref>
+            </listitem>
+            <listitem>
+                <xref linkend="Seealso_CONVERT">Voir aussi</xref>
             </listitem>
         </itemizedlist>
     </refsection>
     <refsection id="Description_CONVERT">
         <title>Description</title>
         <para>
-            Ce bloc convertit une entrée de type entier ou réel double vers un autre type réel double ou
-            entier. Ce bloc est particulièrement utile pour connecter un bloc qui accepte ou produit seulement
-            le type de données entier avec un autre bloc qui produit ou accepte seulement le type de données
-            double.
+            Ce bloc convertit une entrée de type entier ou réel double vers un autre type réel
+            double ou entier. Ce bloc est particulièrement utile pour connecter un bloc qui accepte
+            ou produit seulement le type de données entier avec un autre bloc qui produit ou
+            accepte seulement le type de données double.
         </para>
         <para>
             Il peut également être utilisé pour prendre la demi-partie inférieure de l'entrée par une
             conversion dégradante telle que int16 vers int8. Pour ce type d'utilisation et si vous ne voulez
             pas de conversion de type, vous pouvez également utiliser le bloc
-            <link linkend="EXTRACTBITS">EXTRACTBITS</link> avec le paramètre <literal>Bits to extract</literal>
-            placé à <literal>Lower half</literal>.
+            <link linkend="EXTRACTBITS">EXTRACTBITS</link> avec le paramètre
+            <literal>Bits to extract</literal>  placé à <literal>Lower half</literal>.
         </para>
         <para>
             Pour une conversion vers le haut d'un entier signé vers un autre entier signé, le signe
             est propagé.
         </para>
         <para>
-            Quand la sortie est un entier et qu'un dépassement de capacité se produit, le bloc donne trois formes de résultats :
+            Quand la sortie est un entier et qu'un dépassement de capacité se produit, le bloc
+            donne trois formes de résultats :
         </para>
         <orderedlist>
             <listitem>
                 <para>
-                    Un résultat normal non saturé. Par exemple, si le type est int8 et le résultat 128, la valeur de sortie
-                    du bloc sera -128.
+                    Un résultat normal non saturé. Par exemple, si le type est int8 et le résultat
+                    128, la valeur de sortie du bloc sera -128.
                 </para>
             </listitem>
             <listitem>
         </itemizedlist>
     </refsection>
     <refsection id="Dialogbox_CONVERT">
-        <title>Boîte de dialogue</title>
-        <para>
-            <inlinemediaobject>
-                <imageobject>
-                    <imagedata align="center" fileref="../../../gui/integer_pal/fr_FR/CONVERT_gui.png" valign="middle"/>
-                </imageobject>
-            </inlinemediaobject>
-        </para>
-        <para/>
+        <title>Paramètres</title>
+        <inlinemediaobject>
+            <imageobject>
+                <imagedata fileref="../../../gui/integer_pal/fr_FR/CONVERT_gui.png" align="center" style="float:right"/>
+                <!-- align => Javahelp, style => Online -->
+            </imageobject>
+        </inlinemediaobject>
         <itemizedlist>
             <listitem>
                 <para>
-                    <emphasis role="bold">Input Type (1: double, 3:int32, 4:int16, 5:int8, ...)</emphasis>
+                    <emphasis role="bold">Input Type</emphasis> (1|2: double, 3:int32, 4:int16,
+                    5:int8, 6:uint32, 7:uint16, 8:uint8)
                 </para>
                 <para>
-                    Indique le type de donnée en entrée qui peut être double ou entier. Entre 1 et 8.
+                    Indique le type de données en entrée, qui peut être décimal ou entier :
+                    code entier de 1 à 8.
                 </para>
                 <para>Propriétés : Type 'vec' de taille 1.</para>
             </listitem>
             <listitem>
                 <para>
-                    <emphasis role="bold">Output Type (1: double, 3:int32, 4:int16, 5:int8, ...)</emphasis>
+                    <emphasis role="bold">Output Type</emphasis> (1|2: double, 3:int32, 4:int16,
+                    5:int8, 6:uint32, 7:uint16, 8:uint8)
                 </para>
                 <para>
-                    Indique le type de donnée en sortie qui peut être double ou entier : entre 1 et 8.
+                    Fixe le type de données en sortie, qui peut être décimal ou entier :
+                    code entier de 1 à 8.
                 </para>
                 <para>Propriétés : Type 'vec' de taille 1.</para>
             </listitem>
                     </listitem>
                     <listitem>
                         <para>
-                            <emphasis role="bold">2</emphasis> : la simulation affiche un message d'erreur.
+                          <emphasis role="bold">2</emphasis> : la simulation affiche un message d'erreur.
                         </para>
                     </listitem>
                 </itemizedlist>
                 <para>Propriétés : Type 'vec' de taille 1.</para>
             </listitem>
         </itemizedlist>
+        <para/>
     </refsection>
     <refsection id="Defaultproperties_CONVERT">
         <title>Propriétés par défaut</title>
                 </para>
             </listitem>
         </itemizedlist>
-    </refsection>
-    <refsection id="Example_CONVERT">
-        <title>Exemple</title>
-        <para>
-            Cet exemple montre la propagation du bit de signe pendant une conversion d'int8 à int16.
-        </para>
-        <para>
-            <link type="scilab" linkend="scilab.xcos/xcos/examples/integer_pal/fr_FR/CONVERT_fr_FR.zcos">
-                <inlinemediaobject>
-                    <imageobject>
-                        <imagedata align="center" fileref="../../../../examples/integer_pal/fr_FR/CONVERT_fr_FR.zcos" valign="middle"/>
-                    </imageobject>
-                </inlinemediaobject>
-            </link>
-        </para>
+        <para/>
     </refsection>
     <refsection id="Interfacingfunction_CONVERT">
         <title>Fonction d'interfaçage</title>
             </listitem>
         </itemizedlist>
     </refsection>
+    <refsection id="Example_CONVERT">
+        <title>Exemple</title>
+        <para>
+            Cet exemple montre la propagation du bit de signe pendant une conversion d'int8 à int16.
+        </para>
+        <para>
+            <link type="scilab" linkend="scilab.xcos/xcos/examples/integer_pal/fr_FR/CONVERT_fr_FR.zcos">
+                <inlinemediaobject>
+                    <imageobject>
+                        <imagedata align="center" fileref="../../../../examples/integer_pal/fr_FR/CONVERT_fr_FR.zcos" valign="middle"/>
+                    </imageobject>
+                </inlinemediaobject>
+            </link>
+        </para>
+    </refsection>
     <refsection role="see also" id="Seealso_CONVERT">
         <title>Voir aussi</title>
         <itemizedlist>
index 5abc42b..fc2eacb 100644 (file)
Binary files a/scilab/modules/xcos/help/gui/integer_pal/en_US/CONVERT_gui.png and b/scilab/modules/xcos/help/gui/integer_pal/en_US/CONVERT_gui.png differ
index c8dc70a..fc2eacb 100644 (file)
Binary files a/scilab/modules/xcos/help/gui/integer_pal/fr_FR/CONVERT_gui.png and b/scilab/modules/xcos/help/gui/integer_pal/fr_FR/CONVERT_gui.png differ