Add a warning about associativity. 15/15015/6
Vincent COUVERT [Fri, 8 Aug 2014 15:11:14 +0000 (17:11 +0200)]
Change-Id: Ia4b1ec64a7844a93ae95088ee41e0437a4413ba9

scilab/modules/core/help/en_US/1_keywords/hat.xml
scilab/modules/core/help/en_US/1_keywords/power.xml
scilab/modules/core/help/fr_FR/1_keywords/hat.xml
scilab/modules/core/help/fr_FR/1_keywords/power.xml
scilab/modules/m2sci/help/en_US/m2sci_equivalents/operators/power.xml

index 75c7572..3d27413 100644 (file)
                 <literal>x2</literal> the value of  <literal>x1^x2</literal> is the "principal value"
                 determined by <literal>x1^x2 = exp(x2*log(x1))</literal>.
             </para>
+            <para>
+                <warning>
+                    Exponentiation is right-associative in Scilab contrarily to Matlab&#174; and Octave. For example 2^3^4 is equal to 2^(3^4) in Scilab but is equal to (2^3)^4 in Matlab&#174; and Octave.
+                </warning>
+            </para>
         </refsection>
     </refsection>
     <refsection>
index 59ea002..b2442bc 100644 (file)
         <para>
             6. <literal>**</literal> and <literal>^</literal> operators are synonyms.
         </para>
+        <para>
+            <warning>
+                Exponentiation is right-associative in Scilab contrarily to Matlab&#174; and Octave. For example 2^3^4 is equal to 2^(3^4) in Scilab but is equal to (2^3)^4 in Matlab&#174; and Octave.
+            </warning>
+        </para>
     </refsection>
     <refsection>
         <title>Examples</title>
index b098d70..abf6b41 100644 (file)
                 <literal>x1^x2</literal> est la "valeur principale" déterminée par 
                 <literal>x1^x2 = exp(x2*log(x1))</literal>.
             </para>
+            <para>
+                <warning>
+                    L'élévation à la puissance est associative à droite dans Scilab contrairement à Matlab&#174; et Octave. Par exemple 2^3^4 est égal à 2^(3^4) dans Scilab mais est égal à (2^3)^4 dans Matlab&#174; et Octave.
+                </warning>
+            </para>
         </refsection>
     </refsection>
     <refsection>
index 1ba66c4..ed961fd 100644 (file)
             -
             Les opérateurs <literal>**</literal> et <literal>^</literal> sont synonymes.
         </para>
+        <para>
+            <warning>
+                L'élévation à la puissance est associative à droite dans Scilab contrairement à Matlab&#174; et Octave. Par exemple 2^3^4 est égal à 2^(3^4) dans Scilab mais est égal à (2^3)^4 dans Matlab&#174; et Octave.
+            </warning>
+        </para>
     </refsection>
     <refsection>
         <title>Exemples</title>
index 966ed8c..c98e40f 100644 (file)
                 Note that Matlab seems to have a bug for <emphasis role="bold">X^(Y)</emphasis> when <emphasis role="bold">X</emphasis> is a character and that in Scilab operations such as <emphasis role="bold">X^(Y)</emphasis> with <emphasis role="bold">X</emphasis> a scalar and <emphasis role="bold">Y</emphasis> a matrix is equivalent to <emphasis role="bold">X.^(Y)</emphasis> (Will change in next Scilab versions...).
             </note>
         </para>
+        <para>
+            <warning>
+                Exponentiation is right-associative in Scilab contrarily to Matlab&#174; and Octave. For example 2^3^4 is equal to 2^(3^4) in Scilab but is equal to (2^3)^4 in Matlab&#174; and Octave.
+            </warning>
+        </para>
     </refsection>
 </refentry>