Review + translation before release 20/16920/4
Vincent COUVERT [Wed, 29 Jul 2015 08:37:05 +0000 (10:37 +0200)]
Change-Id: I1885f5d5691c1a0d85891c6a327bf5461026eaba

scilab/CHANGES_6.0.X
scilab/modules/helptools/data/pages/homepage-en_US.html
scilab/modules/helptools/data/pages/homepage-fr_FR.html

index ac69488..c71a2f6 100644 (file)
@@ -3,9 +3,9 @@
 
 
 
-This file details the technical changes done in the 6.0.0-alpha-1 release.
+This file details the technical changes done in Scilab 6.0.0-alpha-1 release.
 
-For a more complete overview of the changes in this release, please see the "What's new" page of the help, by simply typing "help" in Scilab.
+For a more complete overview of the changes in this release, please consult the "What's new" page of the help, by simply typing "help" in Scilab console.
 
 
 
@@ -31,22 +31,22 @@ Installation
 Compilation
 ===========
 
-* A conforming C++11 compiler is now needed.
+* A C++11 compliant compiler is now needed.
 
 * Java minimal version switch to 1.8.
 
-* Ant minimal version switched to 1.9.0 (for compatibility with Java 1.8).
+* Ant minimal version switched to 1.9.0 (for Java 1.8 compatibility).
 
-* ecj minimal version switched to 4.4.0 (for compatibility with Java 1.8).
+* ecj minimal version switched to 4.4.0 (for Java 1.8 compatibility).
 
-* --without-xcos now only disable Xcos compilation. Xcos Graphic interface is disabled
+* --without-xcos now only disable Xcos compilation. Xcos graphical interface is disabled
 using --without-gui.
 
 
-Packaging & Supported operating systems
+Packaging & Supported Operating Systems
 =======================================
 
-* Scilab embedded JVM has been upgraded to Java 1.8 then to run or compile Scilab you need at least:
+* Scilab embedded JVM has been upgraded to Java 1.8. To run or compile Scilab 6.0.0-alpha-1 you need at least:
    - Windows:
         Windows 8 (Desktop)
         Windows 7
@@ -60,63 +60,64 @@ Packaging & Supported operating systems
         Oracle Linux 5.5+, 6.x (32-bit), 6.x (64-bit), 7.x (64-bit)
         Ubuntu Linux 12.04 LTS, 13.x
         Suse Linux Enterprise Server 10 SP2+, 11.x
-For more information, see: http://java.com/en/download/help/sysreq.xml
+For more information, please consult: http://java.com/en/download/help/sysreq.xml
 
 
-Signal processing
+Signal Processing
 ==================
 
 * amell function:
-  - now checks its parameters be real numbers
-  - now throws an error if the second parameter isn't scalar
+  - now checks its parameters are real numbers,
+  - now throws an error if the second parameter is not a scalar.
 
 
-File input/output
+Input/Output File
 ==================
 
-* The use of I/O console is now allowed with functions: mget, mgetl, mgetstr, mput, mputl and mputstr.
+* The use of I/O console is now allowed with the following functions:
+  mget, mgetl, mgetstr, mput, mputl and mputstr.
 
 * mclearerr now returns a flag indicating the file identifier validity.
 
 * fileinfo can now take a row vector as input.
 
-* msprintf no more returns an error message when there are too many input argument (more values that format needs).
+* msprintf no more returns an error message when there are too many input arguments (more values that format needs).
 
 
-Data structures
+Data Structures
 ================
 
 * cells and structs are now native types, hence improving performances.
 
 * cells:
   - insertion and extraction must be done via () or {}.
-  - fields .dims and .entries have been removed, use size and () instead.
+  - .dims and .entries fields have been removed, please use size and () instead.
 
 * struct
-  - dims field has been removed, use size instead.
+  - dims field has been removed, please use size instead.
 
 * hypermatrix:
   - hypermatrices are natively managed (without mlist overloading).
   - typeof function now returns real type like constant, string, ... instead of hypermat
   - type function returns real type like 1, 10, ... instead of 17 (mlist).
-  - fields .dims and .entries have been removed, use size and () instead.
+  - .dims and .entries fields have been removed, please use size and () instead.
 
-Removed functions
+Removed Functions
 ==================
 
 * maxfiles function is now obsolete.
 
 * intersci has been removed. Please use swig instead.
 
-* numdiff removed. Please use numderivative instead.
+* numdiff has been removed. Please use numderivative instead.
 
-* derivative removed. Please use numderivative instead.
+* derivative has been removed. Please use numderivative instead.
 
-* curblockc removed. Please use curblock instead.
+* curblockc has been removed. Please use curblock instead.
 
-* extract_help_examples removed. (Undocumented and based on old help format).
+* extract_help_examples has been removed. (Undocumented and based on former help format).
 
-* Symbolic module functions removed:
+* Symbolic module functions have been removed:
   - addf
   - cmb_lin
   - ldivf
@@ -128,37 +129,45 @@ Removed functions
   - trisolve
   - block2exp
 
-Removed functions (based on old Scilab stack)
-==============================================
+Removed Functions (based on former Scilab stack)
+================================================
 
-* fun2string removed.
+* comp.
 
-* getvariablesonstack removed.
+* errcatch.
 
-* gstacksize removed.
+* iserror.
 
-* macr2lst removed.
+* fun2string.
 
-* stacksize removed.
+* getvariablesonstack.
 
-* code2str removed.
+* gstacksize.
 
-* str2code removed.
+* macr2lst.
 
-* -mem option removed (used to set stacksize at startup).
+* stacksize.
 
+* code2str.
 
-Functions modified
+* str2code.
+
+* -mem option (used to set stacksize at startup).
+
+
+Modified Functions
 ===================
 
-* impl   : Recall impl with the same parameters as in its previous stop is now available.
-* ode    : y0 is restricted to a column vector.
-* pppdiv : return a scalar of type 'constant' when the rank is 0.
-* pdiv   : return a matrix of type 'constant' when all the rank are 0.
-* typeof : add a 2nd argument "overload" of get overloaded name (typeof(cell(), "overload") -> "ce")
+* exec: exec of macro executes the body in the current scope but the prototype must have zero input and output arguments.
+* error: an error number in input is deprecated.
+* impl: Recall impl with the same parameters as in its previous stop is now available.
+* ode: y0 is restricted to a column vector.
+* pppdiv: Return a scalar of type 'constant' when the rank is 0.
+* pdiv: Return a matrix of type 'constant' when all the rank are 0.
+* typeof: Add a 2nd argument "overload" of get overloaded name (typeof(cell(), "overload") -> "ce")
 
 
-Syntax modifications
+Syntax Modifications
 =====================
 
 * Declaration of a number on two lines is no longer allowed:
@@ -172,19 +181,21 @@ Syntax modifications
 * New shortcut operators have been introduced: && and ||.
 
 
-Deprecated behavior
-====================
+Deprecated Behaviors
+=====================
 
-* {} become different of [] and wiil be use on cells.
+* {} becomes different of [] and will be used on cells.
 
-* Syntax %i:10 is now deprecated. (only real scalar can be used).
+* Syntax %i:10 is now deprecated (only real scalars can be used).
 
-* write string or string matrix in file does not add black space before each value
+* Writing string or string matrix in a file does not add blanck space before each value:
     write("TMPDIR/test", ["test", "sample"; "sample", "test"])
     "-" + mgetl("TMPDIR/test") + "-"
 
 * while/else control instruction is no more supported.
 
+* (a=b) executed like a == b is now deprecated and returns an error.
+
 
 Scilab Bug Fixes
 ================
@@ -195,7 +206,7 @@ Scilab Bug Fixes
 
 * Bug #9621 fixed - A tlist with undefined fields can now be saved.
 
-* Bug #12202 fixed - Mixing int8 and doubles with colon operator lead to wrong results.
+* Bug #12202 fixed - Mixing int8 and doubles with colon operator led to wrong results.
 
 * Bug #13289 fixed - Using non-integer indexes for mlists made Scilab crash.
 
@@ -206,11 +217,11 @@ Scilab Bug Fixes
 
 * Bug #13829 fixed - mean and sum functions returned wrong results for hypermatrices.
 
-* Bug #13834 fixed - Drawing a high number of strings in a figure generated a Java exceptions.
+* Bug #13834 fixed - Drawing a high number of strings in a figure generated a Java exception.
 
 * Bug #13838 fixed - Sparse and complex substraction made Scilab crash.
 
-* Bug #13854 fixed - On some operating systems, SciNotes did not initialize a new document at startup.
+* Bug #13854 fixed - Under some operating systems, SciNotes did not initialize a new document at startup.
 
 * Bug #13866 fixed - There were some issues with FFTW3 library.
 
index 6355a13..7880ca9 100644 (file)
         </ul>
       </p>
       <p class="para">
-        The language changes are <i>not all</i> backward-compatible. You will have to update your scripts/programs/modules, but it will be very simple in pretty much all cases. In particular, the following changes may require modifications to existing code:
+        The language changes are not all backward-compatible. You will have to update your scripts/programs/modules, but it will be very simple in pretty much all cases. In particular, the following changes may require modifications to existing code:
         <ul>
           <li>Literal strings cannot mix single-quote and double-quote delimiters: they have to start and finish with either both single-quotes, or both double-quotes,</li>
-          <li>Usage of commas (to put multiple instructions on the same line) has been clarified: it can not be used following control instructions such as <a href="try">try</a>,</li>
+          <li>Usage of commas (to put multiple instructions on the same line) has been clarified: it can not be used following control instructions such as <a href="try.html">try</a>,</li>
           <li>Three dots or more are not supported anymore.</li>
         </ul>
         </p>
@@ -89,7 +89,7 @@
         <ul>
           <li>Xcos is not functional yet; the editor is not working yet at in this alpha 1 (it will in the final release, for sure). The simulator has been ported but is still not usable,</li>
           <li>The debugging and profiling capabilities present in the 5.5.2 version are not ported to 6; most likely it will be replaced by completly new features,</li>
-          <li>ATOMS is functional, but since none of ATOMS module currently on <a href="http://atoms.scilab.org/">http://atoms.scilab.org/</a> have been ported, it is not of much use.</li>
+          <li>ATOMS is functional, but since none of ATOMS modules currently on <a href="http://atoms.scilab.org/">http://atoms.scilab.org/</a> have been ported, it is not of much use.</li>
         </ul>
       </p>
     </div>
index ea17843..96f2d92 100644 (file)
     <br/>
     <br/>
 
-    <!-- Scilab 6.0.0 -->
     <div class="refsection">
-      <h3 class="title">Nouveautés</h3>
-      <h2>Scilab 6.0.0</h2>
-      Scilab 6.0.0 est ...
-      <br/><br/>
-      <a href="http://www.scilab.org/community/news/XXXXXXXX/release_notes">Voir les notes de version de Scilab 6.0.0 (anglais)</a>
-      <br/>
+      <h3 class="title">Bienvenue dans Scilab 6.0.0-alpha-1</h3>
+      <p class="para">
+        Scilab 6.0.0 est une nouvelle version majeure de Scilab, la plateforme open source de calcul numérique. Cette version 6.0.0-alpha-1 est un aperçu pour les développeurs, les partenaires et la communauté à des fins de tests.
+      </p>
+      <p class="para">
+        Comme toute alpha, cette version n’est encore pas prête pour être utilisée en production. Si vous débutez sur Scilab, ou si vous êtes un simple utilisateur, vous devriez continuer à utiliser la version 5.5.2, et attendre une version bêta avant d'essayer la famille 6.
+      </p>
+
+      <p class="para">
+        Toutefois, si vous avez déjà développé du code sur Scilab, ou si vous êtes un utilisateur avancé, vous pourriez être intéressé par cette version. Pourquoi ne pas essayer vos développements effectués sur des versions antérieures de Scilab dans cette version : vérifier la compatibilité peut vous économiser du temps par la suite. Si vous trouvez des bugs ou des incompatibilités, merci de les signaler sur notre <a href="http://bugzilla.scilab.org/" class="ulink">gestionnaire de bugs</a> : cela vous aidera à avoir un meilleur produit, plus rapide, dont vous serez également bénéficiaire.
+      </p>
+
+      <h2 class="title">Les nouveautés de Scilab 6.0.0-alpha-1</h2>
+
+      <p class="para">
+        Cette version inclut une réécriture majeure du noyau interne de Scilab. Les modifications apportées aux aspects visibles du logiciel sont limitées.
+      </p>
+      <p class="para">
+        Le premier grand changement interne est un tout nouvel analyseur syntaxique et un interprète, incluant les modifications suivantes :
+        <ul>
+          <li>Le langage est beaucoup plus cohérent et prévisible,</li>
+          <li>La grammaire est plus stricte, mais plus cohérente,</li>
+          <li>La gestion des erreurs a été améliorée (mais peut encore être limitée dans l'alpha : merci d’avance de nous signaler les problèmes que vous pourriez rencontrer),</li>
+          <li>Le langage est légèrement plus comptabile avec le langage Matlab (par exemple dans le cas d’instructions de contrôle telles que les déclarations switch/case).</li>
+        </ul>
+      </p>
+      <p class="para">
+        Les changements de langage ne sont pas tous rétrocompatibles. Vous devez mettre à jour vos scripts/programmes/modules, ce qui devrait être très rapide dans la plupart des cas. Par exemple, les modifications suivantes peuvent nécessiter des adaptations d’un code existant :
+        <ul>
+          <li>Les chaînes de caractères littérales ne peuvent pas mélanger des délimiteurs simple quote et double quote: elles doivent commencer et finir avec soit des simple quotes, soit des double quotes,</li>
+          <li>L’utilisation des virgules (pour avoir plusieurs instructions sur une même ligne) a été clarifiée : elles ne peuvent pas être utilisées après des instructions de contrôle comme <a href="try.html">try</a>,</li>
+          <li>Trois points ou plus ne sont plus supportés.</li>
+        </ul>
+        </p>
+      <p class="para">
+        Le deuxième grand changement interne, est la possibilité de manipuler de plus grands ensembles de données, sans épuiser les ressources du système. Cela comprend en particulier :
+        <ul>
+          <li>Une meilleure gestion de la mémoire. L’utilisation de la mémoire est dorénavant limitée par la mémoire de la machine. Cette fonctionnalité était très attendue et nécessaire. <i>stacksize</i> n’est donc plus utile.</li>
+          <li>Les grandes tailles de données sont supportées en particulier pour les fichiers HDF5,</li>
+          <li>Des nouveaux types de données et des améliorations : les entiers 64 bits; la possibilité de définir des types d'utilisateurs dans les modules C++. En outre, les matrices de plus de deux dimensions sont maintenant implémentées de manière native.</li>
+          <li>Les structures de données natives (cell, struct), ainsi que les matrices multidimensionnelles ont, dans la plupart des cas, de meilleures performances, tant en utilisation de la mémoire, qu’en rapidité d'exécution. Si dans certains cas, vous observez une baisse de performances, nous vous remercions de nous le signaler.</li>
+        </ul>
+      </p>
+      <p class="para">
+        Ces changements peuvent ne pas impacter certains utilisateurs finaux, mais ils étaient grandement nécessaires, ont été travaillés très sérieusement pour apporter des améliorations majeures à la plateforme Scilab. Ces améliorations conduiront à de nouvelles améliorations futures, en termes de gestion de code, d’outils de développement (débogueur, analyseur ...), ainsi que des améliorations de Xcos, qui ne seraient pas possibles sans cette version.
+      </p>
+      <h2 class="title">Nouvelles fonctionnalités spécifiques et changelog complet</h2>
+      <p class="para">
+        Pour une liste complète des changements entre la version 5.5.2 et cette version, veuillez consulter le fichier CHANGES_6.0.X présent à la racine de l'installation de Scilab.
+      </p>
+      <h2 class="title">Principales limitations</h2>
+      <p class="para">
+        Plusieurs éléments importants de la plateforme ne sont pas fonctionnels dans cette alpha :
+        <ul>
+          <li>Xcos ne fonctionne pas encore; l'éditeur ne fonctionne pas encore dans cette version alpha 1 (il le sera dans la version finale, bien sûr). Le simulateur a été porté, mais n’est pas encore utilisable,</li>
+          <li>TLes fonctionnalités de débogage et de profiling disponibles dans la version 5.5.2 ne sont pas portées dans la 6; Très probablement, elles seront remplacées par de toutes nouvelles fonctionnalités,</li>
+          <li>ATOMS est fonctionnel, mais comme aucun des modules ATOMS actuellement disponibles sur <a href="http://atoms.scilab.org/">http://atoms.scilab.org/</a> n’a été porté, il n’est pas d'une grande utilité.</li>
+        </ul>
+      </p>
     </div>
 
     <hr/>