[doc] misc. small fix and improvements 33/20633/20
Samuel GOUGEON [Fri, 23 Nov 2018 20:53:23 +0000 (21:53 +0100)]
  * rand : http://bugzilla.scilab.org/10484
  * odedc: http://bugzilla.scilab.org/11273

Change-Id: Ib6edaa5ffce7225310feadefeaa1ea40e0b19f0d

40 files changed:
scilab/modules/console/help/en_US/lines.xml
scilab/modules/console/help/ja_JP/lines.xml
scilab/modules/console/help/ru_RU/lines.xml
scilab/modules/core/help/en_US/variables/predefined/TMPDIR.xml
scilab/modules/core/help/en_US/variables/predefined/home.xml
scilab/modules/core/help/fr_FR/variables/predefined/TMPDIR.xml
scilab/modules/core/help/ja_JP/variables/predefined/TMPDIR.xml
scilab/modules/core/help/ja_JP/variables/predefined/home.xml
scilab/modules/core/help/ru_RU/variables/predefined/TMPDIR.xml
scilab/modules/differential_equations/help/en_US/odedc.xml
scilab/modules/differential_equations/help/ja_JP/odedc.xml
scilab/modules/differential_equations/help/pt_BR/odedc.xml
scilab/modules/differential_equations/help/ru_RU/odedc.xml
scilab/modules/elementary_functions/help/en_US/elementarymatrices/rand.xml
scilab/modules/elementary_functions/help/fr_FR/elementarymatrices/rand.xml
scilab/modules/elementary_functions/help/ja_JP/elementarymatrices/rand.xml
scilab/modules/elementary_functions/help/pt_BR/elementarymatrices/rand.xml
scilab/modules/elementary_functions/help/ru_RU/elementarymatrices/rand.xml
scilab/modules/fileio/help/en_US/deletefile.xml
scilab/modules/fileio/help/en_US/path_filename/pathconvert.xml
scilab/modules/fileio/help/ja_JP/deletefile.xml
scilab/modules/fileio/help/ja_JP/path_filename/pathconvert.xml
scilab/modules/fileio/help/ru_RU/deletefile.xml
scilab/modules/fileio/help/ru_RU/path_filename/pathconvert.xml
scilab/modules/functions/help/en_US/deff.xml
scilab/modules/functions/help/ja_JP/deff.xml
scilab/modules/functions/help/pt_BR/deff.xml
scilab/modules/functions/help/ru_RU/deff.xml
scilab/modules/graphics/help/en_US/polygon/polyline_properties.xml
scilab/modules/graphics/help/ja_JP/polygon/polyline_properties.xml
scilab/modules/gui/help/en_US/console_properties.xml
scilab/modules/gui/help/en_US/root_properties.xml
scilab/modules/gui/help/fr_FR/root_properties.xml
scilab/modules/gui/help/ja_JP/console_properties.xml
scilab/modules/gui/help/ja_JP/root_properties.xml
scilab/modules/helptools/images/_LaTeX_rand.xml_1.png [deleted file]
scilab/modules/helptools/images/_LaTeX_rand.xml_2.png [deleted file]
scilab/modules/helptools/images/_LaTeX_rand.xml_3.png [deleted file]
scilab/modules/spreadsheet/help/en_US/csvTextscan.xml
scilab/modules/windows_tools/help/en_US/getsystemmetrics.xml

index c2a3dc3..6fc7546 100644 (file)
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-    * Copyright (C) 2002 - INRIA
-    * Copyright (C) 2012 - DIGITEO - Allan CORNET
-    *
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2002 - INRIA
+ * Copyright (C) 2012 - DIGITEO - Allan CORNET
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2018 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="lines" xml:lang="en">
+<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="lines" xml:lang="en">
     <refnamediv>
         <refname>lines</refname>
-        <refpurpose>rows and columns used for display</refpurpose>
+        <refpurpose>sets and queries the display width and pagination for the console</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>lines(nl)
+        <synopsis>
+            lines(nl)
             lines(nl, nc)
             lines(ncl)
             ncl = lines()
             the window is resized.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+lines(0,100)
+rand(2,8)
+
+lines(0,65)
+rand(2,8)
+   ]]></programlisting>
+      <screen><![CDATA[
+--> lines(0,100)
+--> rand(2,8)
+ ans  =
+   0.2113249   0.0002211   0.6653811   0.8497452   0.8782165   0.5608486   0.7263507   0.5442573
+   0.7560439   0.3303271   0.6283918   0.685731    0.068374    0.6623569   0.1985144   0.2320748
+
+--> lines(0,65)
+--> rand(2,8)
+ ans  =
+         column 1 to 5
+   0.2312237   0.8833888   0.3076091   0.2146008   0.3616361
+   0.2164633   0.6525135   0.9329616   0.312642    0.2922267
+
+         column 6 to 8
+   0.5664249   0.3321719   0.5015342
+   0.4826472   0.5935095   0.4368588
+]]></screen>
+    </refsection>
     <refsection role="see also">
         <title>See also</title>
         <simplelist type="inline">
             <member>
+                <link linkend="mode">mode</link>
+            </member>
+            <member>
+                <link linkend="format">format</link>
+            </member>
+            <member>
                 <link linkend="disp">disp</link>
             </member>
             <member>
                 <link linkend="print">print</link>
             </member>
+            <member>
+                <link linkend="clc">clc</link>
+            </member>
         </simplelist>
     </refsection>
     <refsection>
                 <revdescription>
                     <itemizedlist>
                         <listitem>lines is set by default to 0. Argument -1 added. See SEP #67 for more information.</listitem>
-                        <listitem>lines manages a 1x2 vector [nc, nl] as input
-                            argument
+                        <listitem>lines manages a 1x2 vector [nc, nl] as input argument
                         </listitem>
                     </itemizedlist>
                 </revdescription>
index 8cbfb2a..c2c2dbf 100644 (file)
@@ -1,9 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-    * Copyright (C) 2002 - INRIA
-    *
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2002 - INRIA
+ * Copyright (C) 2012 - DIGITEO - Allan CORNET
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2018 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="lines">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="lines">
     <refnamediv>
         <refname>lines</refname>
         <refpurpose>表示に使用される行および列</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>lines(nl)
+        <synopsis>
+            lines(nl)
             lines(nl, nc)
             lines(ncl)
             ncl = lines()
             自動的に修正されます.
         </para>
     </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+lines(0,100)
+rand(2,8)
+
+lines(0,65)
+rand(2,8)
+   ]]></programlisting>
+      <screen><![CDATA[
+--> lines(0,100)
+--> rand(2,8)
+ ans  =
+   0.2113249   0.0002211   0.6653811   0.8497452   0.8782165   0.5608486   0.7263507   0.5442573
+   0.7560439   0.3303271   0.6283918   0.685731    0.068374    0.6623569   0.1985144   0.2320748
+
+--> lines(0,65)
+--> rand(2,8)
+ ans  =
+         column 1 to 5
+   0.2312237   0.8833888   0.3076091   0.2146008   0.3616361
+   0.2164633   0.6525135   0.9329616   0.312642    0.2922267
+
+         column 6 to 8
+   0.5664249   0.3321719   0.5015342
+   0.4826472   0.5935095   0.4368588
+]]></screen>
+    </refsection>
     <refsection role="see also">
         <title>参照</title>
         <simplelist type="inline">
             <member>
+                <link linkend="mode">mode</link>
+            </member>
+            <member>
+                <link linkend="format">format</link>
+            </member>
+            <member>
                 <link linkend="disp">disp</link>
             </member>
             <member>
                 <link linkend="print">print</link>
             </member>
+            <member>
+                <link linkend="clc">clc</link>
+            </member>
         </simplelist>
     </refsection>
     <refsection>
index 111a2ba..980371a 100644 (file)
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-    * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-    * Copyright (C) 2002 - INRIA
-    * Copyright (C) 2012 - DIGITEO - Allan CORNET
-    *
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2002 - INRIA
+ * Copyright (C) 2012 - DIGITEO - Allan CORNET
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2018 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  * and continues to be available under such terms.
  * For more information, see the COPYING file which you should have received
  * 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="lines" xml:lang="ru">
+ *
+ -->
+<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="lines" xml:lang="ru">
     <info>
         <pubdate>$LastChangedDate$</pubdate>
     </info>
@@ -24,7 +27,8 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Синтаксис</title>
-        <synopsis>lines(nl)
+        <synopsis>
+            lines(nl)
             lines(nl, nc)
             lines(ncl)
             ncl = lines()
             при изменении размера окна.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+lines(0,100)
+rand(2,8)
+
+lines(0,65)
+rand(2,8)
+   ]]></programlisting>
+      <screen><![CDATA[
+--> lines(0,100)
+--> rand(2,8)
+ ans  =
+   0.2113249   0.0002211   0.6653811   0.8497452   0.8782165   0.5608486   0.7263507   0.5442573
+   0.7560439   0.3303271   0.6283918   0.685731    0.068374    0.6623569   0.1985144   0.2320748
+
+--> lines(0,65)
+--> rand(2,8)
+ ans  =
+         column 1 to 5
+   0.2312237   0.8833888   0.3076091   0.2146008   0.3616361
+   0.2164633   0.6525135   0.9329616   0.312642    0.2922267
+
+         column 6 to 8
+   0.5664249   0.3321719   0.5015342
+   0.4826472   0.5935095   0.4368588
+]]></screen>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
             <member>
+                <link linkend="mode">mode</link>
+            </member>
+            <member>
+                <link linkend="format">format</link>
+            </member>
+            <member>
                 <link linkend="disp">disp</link>
             </member>
             <member>
                 <link linkend="print">print</link>
             </member>
+            <member>
+                <link linkend="clc">clc</link>
+            </member>
         </simplelist>
     </refsection>
     <refsection>
index 1d58eca..47efe48 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:ns4="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="TMPDIR" xml:lang="en">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="TMPDIR" xml:lang="en">
     <refnamediv>
         <refname>TMPDIR</refname>
         <refpurpose>temporary directory path.</refpurpose>
             temporary directory (usually <literal>/tmp</literal>) can be selected by
             altering the <literal>TMPDIR</literal> system variable.
         </para>
+        <note>
+          <literal>dirname(TMPDIR)</literal> can be used as a general temporary directory,
+          without respect to any Scilab session.
+        </note>
     </refsection>
     <refsection>
         <title>Examples</title>
@@ -52,10 +59,11 @@ cd(TMPDIR)
         <title>See also</title>
         <simplelist type="inline">
             <member>
+                <link linkend="home">home</link>
+            </member>
+            <member>
                 <link linkend="SCIHOME">SCIHOME</link>
             </member>
-        </simplelist>
-        <simplelist type="inline">
             <member>
                 <link linkend="SCI">SCI</link>
             </member>
index 06ff27f..c4d32d6 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="home" xml:lang="en">
+<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="home" xml:lang="en">
     <refnamediv>
         <refname>home</refname>
         <refpurpose>Gives the user directory.</refpurpose>
@@ -25,7 +28,7 @@
     <refsection>
         <title>Description</title>
         <para>
-            <literal>home</literal> gives the user directory.
+            <literal>home</literal> gives the main user's directory.
         </para>
     </refsection>
     <refsection>
@@ -47,6 +50,9 @@
             <member>
                 <link linkend="SCI">SCI</link>
             </member>
+            <member>
+                <link linkend="TMPDIR">TMPDIR</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index 41e712d..0db9f99 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="TMPDIR">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="fr" xml:id="TMPDIR">
     <refnamediv>
         <refname>TMPDIR</refname>
         <refpurpose>chemin du répertoire temporaire</refpurpose>
             <literal>/tmp</literal>) peut-être sélectionné en modifiant la
             variable système <literal>TMPDIR</literal>.
         </para>
+        <note>
+          <literal>dirname(TMPDIR)</literal> peut être utilisé comme dossier temporaire général,
+          toutes sessions Scilab confondues.
+        </note>
     </refsection>
     <refsection role="see also">
         <title>Voir aussi</title>
         <simplelist type="inline">
             <member>
+                <link linkend="home">home</link>
+            </member>
+            <member>
                 <link linkend="SCIHOME">SCIHOME</link>
             </member>
-        </simplelist>
-        <simplelist type="inline">
             <member>
                 <link linkend="SCI">SCI</link>
             </member>
index bf81b2a..d559958 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="TMPDIR">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="TMPDIR">
     <refnamediv>
         <refname>TMPDIR</refname>
         <refpurpose>テンポラリディレクトリのパス</refpurpose>
             システム変数<literal>TMPDIR</literal>を変更することにより,
             選択することができます.
         </para>
+        <note>
+          <literal>dirname(TMPDIR)</literal> can be used as a general temporary directory,
+          without respect to any Scilab session.
+        </note>
+    </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+ls TMPDIR
+ls(TMPDIR)
+cd(TMPDIR)
+        ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="home">home</link>
+            </member>
+            <member>
+                <link linkend="SCIHOME">SCIHOME</link>
+            </member>
+            <member>
+                <link linkend="SCI">SCI</link>
+            </member>
+        </simplelist>
     </refsection>
 </refentry>
index 9039b29..e52bb5c 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="home" xml:lang="ja">
+<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="home" xml:lang="ja">
     <refnamediv>
         <refname>home</refname>
         <refpurpose>ユーザディレクトリを取得する.</refpurpose>
@@ -47,6 +50,9 @@
             <member>
                 <link linkend="SCI">SCI</link>
             </member>
+            <member>
+                <link linkend="TMPDIR">TMPDIR</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index 8572c9b..e64d3c2 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:ns4="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="TMPDIR" xml:lang="ru">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="TMPDIR" xml:lang="ru">
     <refnamediv>
         <refname>TMPDIR</refname>
         <refpurpose>путь до временной директории</refpurpose>
             <literal>/tmp</literal>) может быть выбрана через изменение системной переменной
             <literal>TMPDIR</literal>.
         </para>
+        <note>
+          <literal>dirname(TMPDIR)</literal> может использоваться как общая временная директория без
+          привязки к какой-либо Scilab-сессии.
+        </note>
     </refsection>
     <refsection>
         <title>Примеры</title>
@@ -52,10 +59,11 @@ cd(TMPDIR)
         <title>Смотрите также</title>
         <simplelist type="inline">
             <member>
+                <link linkend="home">home</link>
+            </member>
+            <member>
                 <link linkend="SCIHOME">SCIHOME</link>
             </member>
-        </simplelist>
-        <simplelist type="inline">
             <member>
                 <link linkend="SCI">SCI</link>
             </member>
index 050fa60..3ea5134 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="odedc" xml:lang="en">
+<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="odedc" xml:lang="en">
     <refnamediv>
         <refname>odedc</refname>
         <refpurpose>discrete/continuous ode solver</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>yt=odedc(y0,nd,stdel,t0,t,f)</synopsis>
+        <synopsis>yt = odedc(y0, nd, stdel, t0, t, f)</synopsis>
     </refsynopsisdiv>
     <refsection role="parameters">
         <title>Arguments</title>
@@ -71,7 +74,7 @@
                 <term>f</term>
                 <listitem>
                     <para>an external i.e. a function or a character string or a list with
-                        syntax: <literal>yp=f(t,yc,yd,flag)</literal>.
+                        syntax: <literal>yp = f(t,yc,yd,flag)</literal>.
                     </para>
                 </listitem>
             </varlistentry>
@@ -79,8 +82,9 @@
                 <term>f</term>
                 <listitem>
                     <para>
-                        an <link linkend="external" role="" version="">external</link> i.e. a function or a character string or a list with
-                        syntax: <literal>yp=f(t,yc,yd,flag)</literal>
+                        an <link linkend="external" role="" version="">external</link> i.e. a
+                        function or a character string or a list with
+                        syntax: <literal>yp = f(t,yc,yd,flag)</literal>
                     </para>
                     <variablelist>
                         <varlistentry>
                                 <para>This form of external is used to pass parameters to the
                                     function. It must be as follows:
                                 </para>
-                                <programlisting role="no-scilab-exec"><![CDATA[
+                                <screen><![CDATA[
 list(f, p1, p2,...)
- ]]></programlisting>
+]]></screen>
                                 <para>where the syntax of the function
                                     <literal>f</literal> is now
                                 </para>
-                                <programlisting role="no-scilab-exec"><![CDATA[
+                                <screen><![CDATA[
 yp = f(t, yc, yd, flag, p1, p2,...)
- ]]></programlisting>
+]]></screen>
                                 <para>
                                     <literal>f</literal> still returns the function value
                                     as a function of <literal>(t, yc, yd, flag, p1, p2,...)</literal>, and
@@ -162,15 +166,18 @@ yp = f(t, yc, yd, flag, p1, p2,...)
                                     <listitem>
                                         <para>
                                             <literal>y</literal> = <literal>[yc; yd; param]</literal>.
-                                            param may be used to get extra arguments which have been given in
-                                            the odedc call <literal>(y = odedc([y0c; y0d], nd, stdel, t0, t, list('fexcd', param)))</literal>
+                                            param may be used to get extra arguments which have
+                                            been given in  the odedc call
+                                           <literal>(y = odedc([y0c; y0d], nd, stdel, t0, t, list('fexcd', param)))</literal>
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            As output <literal>ydp</literal>, the routine must compute
-                                            <literal>ydp[0:nc-1]) = d/dt ( yc(t) )</literal> for <literal>iflag=0</literal> and
-                                            <literal>ydp[0:nd-1] = yd(t+)</literal> for <literal>iflag=1</literal>.
+                                            As output <literal>ydp</literal>, the routine must
+                                            compute <literal>ydp[0:nc-1] = d/dt ( yc(t) )</literal>
+                                            for <literal>iflag=0</literal> and
+                                            <literal>ydp[0:nd-1] = yd(t+)</literal>
+                                            for <literal>iflag=1</literal>.
                                         </para>
                                     </listitem>
                                 </itemizedlist>
@@ -184,45 +191,53 @@ yp = f(t, yc, yd, flag, p1, p2,...)
     <refsection role="description">
         <title>Description</title>
         <para>
-            <literal>y=odedc([y0c;y0d],nd,[h,delta],t0,t,f)</literal> computes
+            <literal>y = odedc([y0c;y0d], nd, [h,delta], t0, t, f)</literal> computes
             the solution of a mixed discrete/continuous system. The discrete system
-            state <literal>yd_k</literal> is embedded into a piecewise constant
+            state <literal>yd<subscript>k</subscript></literal> is embedded into a piecewise constant
             <literal>yd(t)</literal> time function as follows:
+        <literal>yd(t) = yd<subscript>k</subscript></literal> for <literal>t</literal> in
+        <literal>[t<subscript>k</subscript> = h*(delta+k) , t<subscript>k+1</subscript> = h*(delta+k+1) )</literal>.
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t) = yd_k for t in
-[t_k=delay+k*h,t_(k+1)=delay+(k+1)*h] (with delay=h*delta).
- ]]></programlisting>
-        <para>The simulated equations are now:</para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-dyc/dt = f(t,yc(t),yd(t),0),  for t in [t_k,t_(k+1)]
+        <para>
+            The simulated equations are now,
+            for t in [ t<subscript>k</subscript> , t<subscript>k+1</subscript> ):
+        </para>
+        <screen>
+dyc/dt = f(t, yc(t), yd(t), 0)
 yc(t0) = y0c
- ]]></programlisting>
+</screen>
         <para>
-            and at instants <literal>t_k</literal> the discrete variable
-            <literal>yd</literal> is updated by:
+            and at instants <literal>t<subscript>k</subscript></literal> the discrete variable
+            <literal>yd</literal> is updated by
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t_k+) = f(yc(t_k-),yd(t_k-),1)
- ]]></programlisting>
         <para>
+            <literal>yd(t<subscript>k+</subscript>)
+            = f(yc(t<subscript>k-</subscript>), yd(t<subscript>k-</subscript>), 1)</literal>.
+        </para>
+            <para>
             Note that, using the definition of <literal>yd(t)</literal> the last
             equation gives
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc is time-continuous: yc(t_k-)=yc(tk))
- ]]></programlisting>
+        <para>
+            <literal>yd<subscript>k</subscript>
+            = f(t<subscript>k</subscript>, yc(t<subscript>k-</subscript>), yd(t<subscript>k-1</subscript>), 1)
+            </literal>
+        </para>
+        <para>
+            (<literal>yc</literal> is time-continuous:
+            <literal>yc(t<subscript>k-</subscript>) = yc(t<subscript>k</subscript>)</literal>).
+        </para>
         <para>
             The calling parameters of <literal>f</literal> are fixed:
-            <literal>ycd=f(t,yc,yd,flag)</literal>; this function must return either
+            <literal>ycd = f(t,yc,yd,flag)</literal>; this function must return either
             the derivative of the vector <literal>yc</literal> if
             <literal>flag=0</literal> or the update of <literal>yd</literal> if
             <literal>flag=1</literal>.
         </para>
         <para>
-            <literal>ycd=dot(yc)</literal> must be a vector with same dimension
+            <literal>ycd = dot(yc)</literal> must be a vector with same dimension
             as <literal>yc</literal> if <literal>flag=0</literal> and
-            <literal>ycd=update(yd)</literal> must be a vector with same dimension as
+            <literal>ycd = update(yd)</literal> must be a vector with same dimension as
             <literal>yd</literal> if <literal>flag=1</literal>.
         </para>
         <para>
@@ -231,7 +246,7 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc is time-continuous: yc(t_k-)=yc(tk))
         </para>
         <para>
             <literal>y</literal> is the vector
-            <literal>y=[y(t(1)),y(t(2)),...]</literal>.
+            <literal>y = [y(t(1)), y(t(2)),...]</literal>.
         </para>
         <para>
             This function can be called with the same optional parameters as the <literal>ode</literal>
@@ -240,11 +255,7 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc is time-continuous: yc(t_k-)=yc(tk))
             integration flags, tolerances can be set. Optional parameters can be set
             by the <literal>odeoptions</literal> function.
         </para>
-        <para>An example for calling an external routine is given in
-            <literal>SCIDIR/default/fydot2.f</literal>
-        </para>
-        <para>External routines can be dynamically linked (see
-            <literal>link</literal>).
+        <para>External routines can be dynamically linked (see <link linkend="link">link</link>).
         </para>
     </refsection>
     <refsection role="examples">
index 0b27292..88249d9 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="odedc" xml:lang="ja">
+<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="odedc" xml:lang="ja">
     <refnamediv>
         <refname>odedc</refname>
         <refpurpose>離散/連続 ODE ソルバ</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>yt=odedc(y0,nd,stdel,t0,t,f)</synopsis>
+        <synopsis>yt = odedc(y0, nd, stdel, t0, t, f)</synopsis>
     </refsynopsisdiv>
     <refsection role="parameters">
         <title>引数</title>
                                     指定する際に使用されます.
                                     以下のようにします:
                                 </para>
-                                <programlisting role="no-scilab-exec"><![CDATA[
+                                <screen><![CDATA[
 list(f, p1, p2,...)
- ]]></programlisting>
+]]></screen>
                                 <para>
                                     ただし,関数 <literal>f</literal>の呼び出し手順は,
                                 </para>
-                                <programlisting role="no-scilab-exec"><![CDATA[
+                                <screen><![CDATA[
 yp = f(t, yc, yd, flag, p1, p2,...)
- ]]></programlisting>
+]]></screen>
                                 <para>
                                     <literal>f</literal> はここでも
                                     <literal>(t, yc, yd, flag, p1, p2,...)</literal>
@@ -178,7 +181,7 @@ yp = f(t, yc, yd, flag, p1, p2,...)
                                         <para>
                                             出力 <literal>ydp</literal>と同様に,
                                             このルーチンは
-                                            <literal>ydp[0:nc-1]) = d/dt ( yc(t) )</literal>
+                                            <literal>ydp[0:nc-1] = d/dt ( yc(t) )</literal>
                                             (<literal>iflag=0</literal>の場合) および
                                             <literal>ydp[0:nd-1] = yd(t+)</literal>
                                             (<literal>iflag=1</literal>の場合)
@@ -196,45 +199,52 @@ yp = f(t, yc, yd, flag, p1, p2,...)
     <refsection role="description">
         <title>説明</title>
         <para>
-            <literal>y=odedc([y0c;y0d],nd,[h,delta],t0,t,f)</literal> は,
+            <literal>y = odedc([y0c;y0d], nd, [h,delta], t0, t, f)</literal> は,
             離散/連続混合系の解を計算します.
-            離散系の状態量 <literal>yd_k</literal> は以下のように
+            離散系の状態量 <literal>yd<subscript>k</subscript></literal> は以下のように
             区間内は定数となる時間関数<literal>yd(t)</literal>として
             組み込まれます:
+            以下の <literal>t</literal> について <literal>yd(t) = yd<subscript>k</subscript></literal>
+            <literal>[t<subscript>k</subscript> = h*(delta+k) , t<subscript>k+1</subscript> = h*(delta+k+1) )</literal>.
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-以下の t について yd(t) = yd_k
-[t_k=delay+k*h,t_(k+1)=delay+(k+1)*h] (ただし delay=h*delta).
- ]]></programlisting>
-        <para>シミュレーションされる方程式は以下のようになります:</para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-dyc/dt = f(t,yc(t),yd(t),0),  for t in [t_k,t_(k+1)]
+        <para>シミュレーションされる方程式は以下のようになります
+            for t in [ t<subscript>k</subscript> , t<subscript>k+1</subscript> ):
+        </para>
+        <screen>
+dyc/dt = f(t, yc(t), yd(t), 0)
 yc(t0) = y0c
- ]]></programlisting>
+</screen>
         <para>
-            そして, 時刻 <literal>t_k</literal> において
+            そして, 時刻 <literal>t<subscript>k</subscript></literal> において
             離散変数 <literal>yd</literal> が以下のように更新されます:
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t_k+) = f(yc(t_k-),yd(t_k-),1)
- ]]></programlisting>
+        <para>
+            <literal>yd(t<subscript>k+</subscript>)
+            = f(yc(t<subscript>k-</subscript>), yd(t<subscript>k-</subscript>), 1)</literal>.
+        </para>
         <para>
             <literal>yd(t)</literal>の定義に基づき,
             最後の式から以下が導かれることに注意してください
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc は時間連続: yc(t_k-)=yc(tk))
- ]]></programlisting>
+        <para>
+            <literal>yd<subscript>k</subscript>
+            = f(t<subscript>k</subscript>, yc(t<subscript>k-</subscript>), yd(t<subscript>k-1</subscript>), 1)
+            </literal>
+        </para>
+        <para>
+            (<literal>yc</literal> は時間連続:
+            <literal>yc(t<subscript>k-</subscript>) = yc(t<subscript>k</subscript>)</literal>).
+        </para>
         <para>
             <literal>f</literal>をコールする際のパラメータは以下のように固定されています:
-            <literal>ycd=f(t,yc,yd,flag)</literal>;
+            <literal>ycd = f(t,yc,yd,flag)</literal>;
             この関数は, <literal>flag=0</literal> の場合に
             微係数ベクトル <literal>yc</literal>,
             <literal>flag=1</literal> の場合に
             <literal>yd</literal> の更新値を返す必要があります.
         </para>
         <para>
-            <literal>ycd=dot(yc)</literal> は,
+            <literal>ycd = dot(yc)</literal> は,
             <literal>flag=0</literal>の場合には<literal>yc</literal>と同じ次元の
             ベクトルである必要があり,
             <literal>flag=1</literal>の場合には<literal>yd</literal>と同じ次元の
@@ -246,7 +256,7 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc は時間連続: yc(t_k-)=yc(tk))
         </para>
         <para>
             <literal>y</literal> は
-            ベクトル<literal>y=[y(t(1)),y(t(2)),...]</literal>です.
+            ベクトル<literal>y = [y(t(1)), y(t(2)),...]</literal>です.
         </para>
         <para>
             この関数は <literal>ode</literal> 関数と同じオプションパラメータを指定して
@@ -257,11 +267,8 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc は時間連続: yc(t_k-)=yc(tk))
             オプションのパラメータは <literal>odeoptions</literal> 関数により
             設定できます.
         </para>
-        <para>外部ルーチンをコールする例が
-            <literal>SCIDIR/default/fydot2.f</literal>に提供されています.
-        </para>
         <para>
-            外部ルーチンは動的にリンクすることが可能です (<literal>link</literal>参照).
+            外部ルーチンは動的にリンクすることが可能です (<link linkend="link">link</link>参照).
         </para>
     </refsection>
     <refsection role="examples">
index c56272b..1926904 100644 (file)
@@ -1,9 +1,8 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
  * ...
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="odedc" xml:lang="pt">
+<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="odedc" xml:lang="pt">
     <refnamediv>
         <refname>odedc</refname>
         <refpurpose>solucionador de EDOs contínuas/discretas</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
-        <synopsis>yt=odedc(y0,nd,stdel,t0,t,f)</synopsis>
+        <synopsis>yt = odedc(y0, nd, stdel, t0, t, f)</synopsis>
     </refsynopsisdiv>
     <refsection role="parameters">
         <title>Parâmetros</title>
     <refsection role="description">
         <title>Descrição</title>
         <para>
-            <literal>y=odedc([y0c;y0d],nd,[h,delta],t0,t,f)</literal> computa a
+            <literal>y = odedc([y0c;y0d], nd, [h,delta], t0, t, f)</literal> computa a
             solução de um sistema misto contínuo/discreto. O estado de sistema
-            discreto <literal>yd_k</literal> é embutido em uma função de tempo
+            discreto <literal>yd<subscript>k</subscript></literal> é embutido em uma função de tempo
             seccional constante <literal>yd(t)</literal> como segue:
+            <literal>yd(t) = yd<subscript>k</subscript></literal> para <literal>t</literal> em
+            <literal>[t<subscript>k</subscript> = h*(delta+k) , t<subscript>k+1</subscript> = h*(delta+k+1) )</literal>.
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t)=yd_k para t em
-[t_k=atraso+k*h,t_(k+1)=delay+(k+1)*h] (com atraso=h*delta).
- ]]></programlisting>
-        <para>As equações simuladas são agora:</para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-dyc/dt=f(t,yc(t),yd(t),0),  para t em [t_k,t_(k+1)]
-yc(t0)=y0c
- ]]></programlisting>
+        <para>As equações simuladas são agora
+            para t em [ t<subscript>k</subscript> , t<subscript>k+1</subscript> ):
+        </para>
+        <screen>
+dyc/dt = f(t, yc(t), yd(t), 0)
+yc(t0) = y0c
+</screen>
         <para>
-            e nos instantes <literal>t_k</literal> a variável discreta
-            <literal>yd</literal> é atualizada por:
+            e nos instantes <literal>td<subscript>k</subscript></literal> a variável discreta
+            <literal>yd</literal> é atualizada por
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t_k+)=f(yc(t_k-),yd(t_k-),1)
- ]]></programlisting>
         <para>
-            Note que, utilizando a definição de <literal>yd(t)</literal>, a
-            última equação fornece
+            <literal>yd(t<subscript>k+</subscript>)
+            = f(yc(t<subscript>k-</subscript>), yd(t<subscript>k-</subscript>), 1)</literal>.
+        </para>
+        <para>
+            Note que, utilizando a definição de <literal>yd(t)</literal>, a última equação fornece
+        </para>
+        <para>
+            <literal>yd<subscript>k</subscript>
+            = f(t<subscript>k</subscript>, yc(t<subscript>k-</subscript>), yd(t<subscript>k-1</subscript>), 1)
+            </literal>
+        </para>
+        <para>
+            (<literal>yc</literal> é de tempo contínuo :
+            <literal>yc(t<subscript>k-</subscript>) = yc(t<subscript>k</subscript>)</literal>).
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc é de tempo contínuo: yc(t_k-)=yc(tk))
- ]]></programlisting>
         <para>
             Os parâmetros de chamada de <literal>f</literal> são fixados:
-            <literal>ycd=f(t,yc,yd,flag)</literal>; esta função deve retornar a
+            <literal>ycd = f(t,yc,yd,flag)</literal>; esta função deve retornar a
             derivada do vetor <literal>yc</literal> se <literal>flag=0</literal> ou a
             atualização de <literal>yd</literal> se <literal>flag=1</literal>.
         </para>
         <para>
-            <literal>ycd=dot(yc)</literal> deve ser um vetor de mesma dimensão
+            <literal>ycd = dot(yc)</literal> deve ser um vetor de mesma dimensão
             que <literal>yc</literal> se <literal>flag=0</literal> e
-            <literal>ycd=update(yd)</literal> deve ser um vetor com a mesma dimensão
+            <literal>ycd = update(yd)</literal> deve ser um vetor com a mesma dimensão
             que <literal>yd</literal> se <literal>flag=1</literal>.
         </para>
         <para>
@@ -129,7 +137,7 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc é de tempo contínuo: yc(t_k-)=yc(tk
         </para>
         <para>
             <literal>y</literal> é o vetor
-            <literal>y=[y(t(1)),y(t(2)),...]</literal>.
+            <literal>y = [y(t(1)), y(t(2)),...]</literal>.
         </para>
         <para>
             Esta função pode ser chamada
@@ -140,11 +148,8 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc é de tempo contínuo: yc(t_k-)=yc(tk
             Parâmetros opcionais podem ser ajustados pela função
             <literal>odeoptions</literal>.
         </para>
-        <para>Um exemplo para chamada de rotina externa é encontrado em
-            <literal>SCIDIR/default/fydot2.f</literal>
-        </para>
         <para>Rotinas externas podem ser ligadas dinamicamente (ver
-            <literal>link</literal>).
+            <link linkend="link">link</link>).
         </para>
     </refsection>
     <refsection role="examples">
index 882733b..b0670ee 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="odedc" xml:lang="ru">
+<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="odedc" xml:lang="ru">
     <refnamediv>
         <refname>odedc</refname>
         <refpurpose>программа решения дискретно-непрерывных  ОДУ</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Синтаксис</title>
-        <synopsis>yt=odedc(y0,nd,stdel,t0,t,f)</synopsis>
+        <synopsis>yt = odedc(y0, nd, stdel, t0, t, f)</synopsis>
     </refsynopsisdiv>
     <refsection role="parameters">
         <title>Аргументы</title>
@@ -31,7 +34,8 @@
                 <listitem>
                     <para>
                         вещественный вектор-столбец (начальные условия),
-                        <literal>y0=[y0c;y0d]</literal>, где <literal>y0d</literal> имеет <literal>nd</literal> элементов.
+                        <literal>y0=[y0c;y0d]</literal>, где <literal>y0d</literal>
+                        имеет <literal>nd</literal> элементов.
                     </para>
                 </listitem>
             </varlistentry>
@@ -47,7 +51,9 @@
                 <term>stdel</term>
                 <listitem>
                     <para>
-                        вещественный вектор с одним или двумя элементами <literal>stdel=[h, delta]</literal> (с <literal>delta=0</literal> в качестве значения по умолчанию).
+                        вещественный вектор с одним или двумя элементами
+                        <literal>stdel=[h, delta]</literal> (с <literal>delta=0</literal>
+                        в качестве значения по умолчанию).
                     </para>
                 </listitem>
             </varlistentry>
@@ -61,7 +67,8 @@
                 <term>t</term>
                 <listitem>
                     <para>
-                        вещественный вектор-(строка), моменты времени, в которые вычислено <literal>yt</literal>.
+                        вещественный вектор-(строка), моменты времени, в которые вычислено
+                        <literal>yt</literal>.
                     </para>
                 </listitem>
             </varlistentry>
                 <term>f</term>
                 <listitem>
                     <para>
-                        внешняя функция, то есть функция или символьная строка или список с последовательностью вызова: <literal>yp=f(t,yc,yd,flag)</literal>.
+                        внешняя функция, то есть функция или символьная строка или список
+                        с последовательностью вызова: <literal>yp = f(t,yc,yd,flag)</literal>.
                     </para>
+                    <variablelist>
+                        <varlistentry>
+                            <term>a list</term>
+                            <listitem>
+                                <para>
+                                    Эта форма внешней функции используется для передачи параметров в функцию.
+                                    Она должна быть в следующем виде:
+                                </para>
+                                <screen><![CDATA[
+list(f, p1, p2,...)
+]]></screen>
+                                <para>
+                                     где синтаксис функции <literal>f</literal> теперь
+                                </para>
+                                <screen><![CDATA[
+yp = f(t, yc, yd, flag, p1, p2,...)
+]]></screen>
+                                <para>
+                                    <literal>f</literal> по-прежнему возвращает значение функции в
+                                    виде функции <literal>(t, yc, yd, flag, p1, p2,...)</literal>,
+                                    а <literal>p1, p2,...</literal> являются параметрами функции.
+                                </para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>символьная строка</term>
+                            <listitem>
+                                <para>
+                                    она должна ссылаться на имя модуля C или fortran, в
+                                    предположении, что &lt;<literal>f_name</literal>&gt; является указанным именем.
+                                </para>
+                                <itemizedlist>
+                                    <listitem>
+                                        <para>
+                                            Последовательность вызова Fortran должна быть
+                                        </para>
+                                        <para>
+                                            <literal>&lt;f_name&gt;(iflag, nc, nd, t, y, ydp)</literal>
+                                        </para>
+                                        <para>
+                                            <literal>double precision t, y(*), ydp(*)
+                                            </literal>
+                                        </para>
+                                        <para>
+                                            <literal>integer iflag, nc, nd</literal>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>C-синтаксис должен быть</para>
+                                        <para>
+                                            <literal>void &lt;f_name&gt; (int *iflag, int *nc,
+                                                int *nd, double *t, double *y, double *ydp)
+                                            </literal>
+                                        </para>
+                                    </listitem>
+                                </itemizedlist>
+                                <para>Как в случае Fortran, так и в случае C входными аргументами являются:</para>
+                                <itemizedlist>
+                                    <listitem>
+                                        <para>
+                                            <literal>iflag</literal> = <literal>0</literal> или
+                                            <literal>1</literal>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>nc</literal> = число непрерывных состояний
+                                            <literal>yc</literal>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>nd</literal> = число дискретных состояний
+                                            <literal>yd</literal>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>t</literal> = время
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>y</literal> = <literal>[yc; yd; param]</literal>.
+                                            <literal>param</literal> может быть использован для получения дополнительных
+                                            аргументов, которые были указаны при вызове <literal>odedc</literal>
+                                            <literal>(y = odedc([y0c; y0d], nd, stdel, t0, t, list('fexcd', param)))</literal>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            В качестве выходного аргумента <literal>ydp</literal>, процедура должна вычислять
+                                            <literal>ydp[0:nc-1] = d/dt ( yc(t) )</literal>
+                                            для <literal>iflag=0</literal> и
+                                            <literal>ydp[0:nd-1] = yd(t+)</literal>
+                                            для <literal>iflag=1</literal>.
+                                        </para>
+                                    </listitem>
+                                </itemizedlist>
+                            </listitem>
+                        </varlistentry>
+                    </variablelist>
                 </listitem>
             </varlistentry>
         </variablelist>
     <refsection role="description">
         <title>Описание</title>
         <para>
-            <literal>y=odedc([y0c;y0d],nd,[h,delta],t0,t,f)</literal> вычисляет решение смешанной дискретно-непрерывной системы. Состояние дискретной системы <literal>yd_k</literal> вложено в кусочно-постоянную функцию времени <literal>yd(t)</literal> в виде:
+            <literal>y = odedc([y0c;y0d], nd, [h,delta], t0, t, f)</literal> вычисляет решение
+            смешанной дискретно-непрерывной системы.
+            Состояние дискретной системы <literal>yd<subscript>k</subscript></literal>
+            вложено в кусочно-постоянную функцию времени <literal>yd(t)</literal> в виде:
+            <literal>yd(t) = yd<subscript>k</subscript></literal> для <literal>t</literal> в
+            <literal>[t<subscript>k</subscript> = h*(delta+k) ,
+            t<subscript>k+1</subscript> = h*(delta+k+1) )</literal>.
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t) = yd_k для t в
-[t_k=delay+k*h, t_(k+1)=delay+(k+1)*h] (с задержкой delay=h*delta).
- ]]></programlisting>
-        <para>Теперь моделируемые уравнения имеют вид:</para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-dyc/dt = f(t,yc(t),yd(t),0),  для t в [t_k,t_(k+1)]
+        <para>Теперь моделируемые уравнения имеют вид,
+            для t в [ t<subscript>k</subscript> , t<subscript>k+1</subscript> ):
+        </para>
+        <screen>
+dyc/dt = f(t, yc(t), yd(t), 0)
 yc(t0) = y0c
- ]]></programlisting>
+</screen>
         <para>
-            и в моменты времени <literal>t_k</literal> дискретная переменная
-            <literal>yd</literal> обновляется как:
+            и в моменты времени <literal>t<subscript>k</subscript></literal> дискретная переменная
+            <literal>yd</literal> обновляется как
+        </para>
+        <para>
+            <literal>yd(t<subscript>k+</subscript>)
+            = f(yc(t<subscript>k-</subscript>), yd(t<subscript>k-</subscript>), 1)</literal>.
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd(t_k+) = f(yc(t_k-),yd(t_k-),1)
- ]]></programlisting>
         <para>
             Заметьте, что, используя определение <literal>yd(t)</literal>, последнее уравнение даёт
         </para>
-        <programlisting role="no-scilab-exec"><![CDATA[
-yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc непрерывно во времени: yc(t_k-)=yc(tk))
- ]]></programlisting>
+        <para>
+            <literal>yd<subscript>k</subscript>
+            = f(t<subscript>k</subscript>, yc(t<subscript>k-</subscript>), yd(t<subscript>k-1</subscript>), 1)
+            </literal>
+        </para>
+        <para>
+            (<literal>yc</literal> непрерывно во времени :
+            <literal>yc(t<subscript>k-</subscript>) = yc(t<subscript>k</subscript>)</literal>).
+        </para>
         <para>
             Параметры вызова <literal>f</literal> фиксированы:
-            <literal>ycd=f(t,yc,yd,flag)</literal>; эта функция должно возвращать либо производную
+            <literal>ycd = f(t,yc,yd,flag)</literal>; эта функция должно возвращать либо производную
             вектора <literal>yc</literal>, если <literal>flag=0</literal>, либо обновлять
             <literal>yd</literal>, если <literal>flag=1</literal>.
         </para>
         <para>
-            <literal>ycd=dot(yc)</literal> должна быть вектором того же размера, что и
-            <literal>yc</literal>, если <literal>flag=0</literal> и <literal>ycd=update(yd)</literal>
+            <literal>ycd = dot(yc)</literal> должна быть вектором того же размера, что и
+            <literal>yc</literal>, если <literal>flag=0</literal> и <literal>ycd = update(yd)</literal>
             должна быть вектором того же размера, что и <literal>yd</literal>, если
             <literal>flag=1</literal>.
         </para>
@@ -119,22 +240,19 @@ yd_k = f (t_k,yc(t_k-),yd(t_(k-1)),1)  (yc непрерывно во време
             <literal>y</literal>.
         </para>
         <para>
-            <literal>y</literal> -- это вектор <literal>y=[y(t(1)),y(t(2)),...]</literal>.
+            <literal>y</literal> -- это вектор <literal>y = [y(t(1)), y(t(2)),...]</literal>.
         </para>
         <para>
-            Эта функция может быть вызвана с теми же самыми необязательными параметрами, что и функция <literal>ode</literal>
+            Эта функция может быть вызвана с теми же самыми необязательными параметрами,
+            что и функция <literal>ode</literal>
             (указанные <literal>nd</literal> и <literal>stdel</literal> даны в последовательности
             вызова как второй и третий параметры). В частности, могут быть установлены флаги
             интегрирования, допуски. Необязательные параметры могут быть установлены с помощью
             функции <literal>odeoptions</literal>.
         </para>
         <para>
-            Пример вызова внешней процедуры предоставлен в
-            <literal>SCIDIR/default/fydot2.f</literal>
-        </para>
-        <para>
-            Внешние процедуры могут быть динамически скомпонованы (см.
-            <link linkend="link">link</link>).
+            Внешние процедуры могут быть динамически скомпонованы
+            (см. <link linkend="link">link</link>).
         </para>
     </refsection>
     <refsection role="examples">
index f8ae874..9834aad 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="rand" xml:lang="en">
+<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="rand" xml:lang="en">
     <refnamediv>
         <refname>rand</refname>
         <refpurpose>Random numbers</refpurpose>
@@ -77,7 +80,7 @@
                 <term>s</term>
                 <listitem>
                     <para>
-                        a 1-by-1 matrix of doubles, integer value, positive, the seed (default <literal>s=0</literal>).
+                        a positive integer: the seed (default <literal>s=0</literal>).
                     </para>
                 </listitem>
             </varlistentry>
@@ -89,8 +92,8 @@
             The purpose of this function is to return a matrix of doubles with real or complex
             random entries.
             Depending on the input arguments, the function can return a random matrix of doubles,
-            or can get or set the distribution of random numbers, or can get or set the seed of the random number
-            generator.
+            or can get or set the distribution of random numbers, or can get or set the seed of
+            the random number generator.
         </para>
     </refsection>
     <refsection>
                     <para>
                         sets the generator to a uniform random number
                         generator. Random numbers are uniformly distributed in the interval
-                        (0,1).
+                        [0,1).
                     </para>
                 </listitem>
             </varlistentry>
@@ -265,7 +268,7 @@ r=rand(2,2,2)
         <para>
             The "uniform" pseudo random number generator is a deterministic sequence which aims at
             reproducing a independent identically distributed numbers uniform in the
-            interval (0,1).
+            interval [0,1).
         </para>
         <para>
             In order to get reproducible simulations, the initial seed of the generator is
@@ -294,27 +297,19 @@ rand("seed",n);
             It is a linear congruential generator of the form :
         </para>
         <para>
-            <latex>
-                $$
-                x = (a x + c) \textrm{mod} M
-                $$
-            </latex>
+             x = (a x + c) mod M
         </para>
         <para>
             where the constants are
-        </para>
-        <para>
-            <latex><![CDATA[
-         \begin{eqnarray}
-      a &=& 843314861\\
-      c &=& 453816693\\
-      M &=& 2^{31}
-         \end{eqnarray}
- ]]></latex>
-        </para>
+          <table border="0" cellpadding="0">
+             <tr><td>a = 843314861</td></tr>
+             <tr><td>c = 453816693</td></tr>
+             <tr><td>M = 2<superscript>31</superscript></td></tr>
+          </table>
+       </para>
         <para>
             According to the authors, this generator is a full length generator, that is to say, its
-            period is <latex>M=2^{31}=2147483648</latex>.
+            period is M = 2<superscript>31</superscript> = 214748364.
         </para>
         <para>
             The <literal>"normal"</literal> random number generator is based on
index 1159fe2..71163f5 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="rand" xml:lang="fr">
+<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="rand" xml:lang="fr">
     <refnamediv>
         <refname>rand</refname>
         <refpurpose>Générateur de nombres pseudo-aléatoires</refpurpose>
@@ -57,8 +60,9 @@
                 <term>x</term>
                 <listitem>
                     <para>
-                        une matrice, dont uniquement le contenu réel ou complexe et
-                        les dimensions sont prises en compte.
+                        tableau (vecteur, matrice, hypermatrice) de booléens, nombres, ou polynomes,
+                        dont uniquement les dimensions et le caractère réel ou complexes sont pris
+                        en compte.
                     </para>
                 </listitem>
             </varlistentry>
@@ -66,7 +70,8 @@
                 <term>r</term>
                 <listitem>
                     <para>
-                        une matrice de doubles de taille m1-par-m2-par-... avec des valeurs aléatoires.
+                        tableau de nombres décimaux ou complexes, de taille m1-par-m2-par-...
+                        avec des valeurs aléatoires.
                     </para>
                 </listitem>
             </varlistentry>
@@ -83,9 +88,8 @@
     <refsection>
         <title>Description</title>
         <para>
-            Le but de cette fonction est de retourner un tableau
-            de doubles dont les valeurs sont des nombres aléatoires
-            réels ou complexes.
+            Le but de cette fonction est de retourner un tableau de nombres dont les valeurs sont
+            des nombres aléatoires réels ou complexes.
             En fonction des arguments d'entrée, la fonction peut renvoyer une
             matrice de doubles aléatoires or peut configurer ou récupérer la distribution des nombres
             aléatoires ou peut configurer ou récupérer la graine du générateur
@@ -213,7 +217,7 @@ r=rand(2,2,2)
  ]]></programlisting>
         <para>
             Dans l'exemple suivant, nous changeons la distribution des nombres générés par <literal>rand</literal>.
-            Nous produisons d'abord des nombres normaux centrés réduits, puis des nombres uniformes dans [0,1).
+            Nous produisons d'abord des nombres normaux centrés réduits, puis des nombres uniformes dans [0,1[.
         </para>
         <programlisting role="example"><![CDATA[
     // Configure le générateur sur la loi normale
@@ -263,7 +267,7 @@ r=rand(2,2,2)
         <para>
             Le générateur pseudo-aléatoire "uniform" est une séquence déterministe
             dont le but est de reproduire une séquence de nombres aléatoire, indépendents
-            et identiquement distribués dans l'intervalle (0,1).
+            et identiquement distribués dans l'intervalle [0,1[.
         </para>
         <para>
             Dans le but de pouvoir obtenir des simulations reproductibles,
@@ -296,27 +300,19 @@ rand("seed",n);
             C'est un générateur linéaire à congruence de la forme :
         </para>
         <para>
-            <latex>
-                $$
-                x = (a x + c) \textrm{mod} M
-                $$
-            </latex>
+             x = (a x + c) mod M
         </para>
         <para>
             pour lequel les constantes sont :
-        </para>
-        <para>
-            <latex><![CDATA[
-         \begin{eqnarray}
-      a &=& 843314861\\
-      c &=& 453816693\\
-      M &=& 2^{31}
-         \end{eqnarray}
- ]]></latex>
+          <table border="0" cellpadding="0">
+             <tr><td>a = 843314861</td></tr>
+             <tr><td>c = 453816693</td></tr>
+             <tr><td>M = 2<superscript>31</superscript></td></tr>
+          </table>
         </para>
         <para>
             D'après les auteurs, ce générateur est de longueur complète, c'est à dire
-            que sa période est <latex>M=2^{31}=2147483648</latex>.
+            que sa période est M = 2<superscript>31</superscript> = 2147483648.
         </para>
         <para>
             Le générateur de nombres aléatoires <literal>"normal"</literal>
index c834217..05bc931 100644 (file)
  *
  -->
 
-<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="rand" xml:lang="ja">
+<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="rand" xml:lang="ja">
 
     <refnamediv>
 
 
                         乱数生成器が一様分布の乱数生成器に
 
-                        設定されます.乱数は(0,1)の範囲の一様分布となります.
+                        設定されます.乱数は[0,1)の範囲の一様分布となります.
 
                     </para>
 
@@ -469,7 +472,7 @@ r=rand(2,2,2)
 
             "uniform" 擬似乱数生成器は,
 
-            範囲(0,1)において独立して一様分布する
+            範囲[0,1)において独立して一様分布する
 
             数を再現することを目的とする決定論的数列です.
 
@@ -533,42 +536,24 @@ rand("seed",n);
         </para>
 
         <para>
-
-            <latex>
-
-                $$
-
-                x = (a x + c) \textrm{mod} M
-
-                $$
-
-            </latex>
-
+             x = (a x + c) mod M
         </para>
 
         <para>
 
             ただし,定数を以下に示します
-
-        </para>
-
-        <para>
-
-            <latex><![CDATA[
-         \begin{eqnarray}
-      a &=& 843314861\\
-      c &=& 453816693\\
-      M &=& 2^{31}
-         \end{eqnarray}
- ]]></latex>
-
+          <table border="0" cellpadding="0">
+             <tr><td>a = 843314861</td></tr>
+             <tr><td>c = 453816693</td></tr>
+             <tr><td>M = 2<superscript>31</superscript></td></tr>
+          </table>
         </para>
 
         <para>
 
             著者によれば,この生成器はフルレングス生成器であり,
 
-            つまり,周期は<latex>M=2^{31}=2147483648</latex>です.
+            つまり,周期はM=2<superscript>31</superscript>=2147483648です.
 
         </para>
 
index 080aba4..895ad4f 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
  * 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="rand" xml:lang="pt">
+<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="rand" xml:lang="pt">
     <refnamediv>
         <refname>rand</refname>
-        <refpurpose>gerador de números randômico</refpurpose>
+        <refpurpose>gerador de números randômico</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
-        <synopsis>rand(m1,m2,.. [,key])
+        <title>Seqüência de Chamamento</title>
+        <synopsis>
+            rand(m1,m2,.. [,key])
             rand(x [, key])
             rand()
 
@@ -30,7 +34,7 @@
         </synopsis>
     </refsynopsisdiv>
     <refsection>
-        <title>Parâmetros</title>
+        <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
                 <term>mi</term>
             <varlistentry>
                 <term>x</term>
                 <listitem>
-                    <para>uma matriz. Apenas suas dimensões são levadas em conta </para>
+                    <para>uma matriz. Apenas suas dimensões são levadas em conta </para>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Descrição</title>
-        <para>Gerador de matriz randômico. </para>
-        <para>Sem argumento "key", as sintaxes abaixo produzem matrizes randômicas
-            com o gerador randômico corrente (o padrão é "uniform")
+        <title>Descrição</title>
+        <para>Gerador de matriz randômico. </para>
+        <para>Sem argumento "key", as sintaxes abaixo produzem matrizes randômicas
+            com o gerador randômico corrente (o padrão é "uniform")
         </para>
         <variablelist>
             <varlistentry>
                 <term>rand(m1,m2)</term>
                 <listitem>
                     <para>
-                        é uma matriz randômica de dimensão <literal>m1</literal> por
+                        é uma matriz randômica de dimensão <literal>m1</literal> por
                         <literal>m2</literal>.
                     </para>
                 </listitem>
@@ -75,7 +79,7 @@
                 <term>rand(m1,m2,..,mn)</term>
                 <listitem>
                     <para>
-                        é uma matriz randômica de dimensão <literal>m1</literal> por
+                        é uma matriz randômica de dimensão <literal>m1</literal> por
                         <literal>m2</literal>,.. por <literal>mn</literal>.
                     </para>
                 </listitem>
@@ -83,8 +87,8 @@
             <varlistentry>
                 <term>rand(a)</term>
                 <listitem>
-                    <para>é uma matriz randômica com mesmo tamanho que a.
-                        <literal>rand(a)</literal>é de complexos se <literal>a</literal> é
+                    <para>é uma matriz randômica com mesmo tamanho que a.
+                        <literal>rand(a)</literal>é de complexos se <literal>a</literal> é
                         uma matriz de complexos.
                     </para>
                 </listitem>
                     muda
                 </term>
                 <listitem>
-                    <para>a cada vez que é referenciado.</para>
+                    <para>a cada vez que é referenciado.</para>
                 </listitem>
             </varlistentry>
         </variablelist>
         <para>Se presente, o argumento "key" permite especificar uma outra
-            distribuição randômica.
+            distribuição randômica.
         </para>
         <variablelist>
             <varlistentry>
                 <term>rand('uniform')</term>
                 <listitem>
-                    <para>o gerador corrente é acertado como gerador randômico uniforme.
-                        Números aleatórios são distribuidos uniformemente e pertencem ao
-                        intervalo (0,1).
+                    <para>o gerador corrente é acertado como gerador randômico uniforme.
+                        Números aleatórios são distribuidos uniformemente e pertencem ao
+                        intervalo [0,1).
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>rand('normal')</term>
                 <listitem>
-                    <para>o gerador corrente é acertado como gerador de números
-                        randômico gaussiano (com média 0 e variância 1) .
+                    <para>o gerador corrente é acertado como gerador de números
+                        randômico gaussiano (com média 0 e variância 1) .
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>str=rand('info')</term>
                 <listitem>
-                    <para>retorna o tipo do gerado randômico padrão ('uniform' ou
+                    <para>retorna o tipo do gerado randômico padrão ('uniform' ou
                         'normal')
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
-        <para>É possível (re-)inicializar o "seed" do gerador randômico: </para>
+        <para>É possível (re-)inicializar o "seed" do gerador randômico: </para>
         <variablelist>
             <varlistentry>
                 <term>rand('seed')</term>
                 <term>rand('seed',n)</term>
                 <listitem>
                     <para>
-                        define o seed como <literal>n</literal>. (o padrão é
+                        define o seed como <literal>n</literal>. (o padrão é
                         <literal>n=0</literal> numa primeira chamada).
                     </para>
                 </listitem>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Observação</title>
+        <title>Observação</title>
         <para>
-            Use a função mais poderosa <link linkend="grand">grand</link> ao
-            invés.
+            Use a função mais poderosa <link linkend="grand">grand</link> ao
+            invés.
         </para>
     </refsection>
     <refsection>
@@ -165,7 +169,7 @@ x=rand(2,2,2)
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
-        <title>Ver Também</title>
+        <title>Ver Também</title>
         <simplelist type="inline">
             <member>
                 <link linkend="grand">grand</link>
index 04d6a1a..914d890 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="rand" xml:lang="ru">
+<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="rand" xml:lang="ru">
     <refnamediv>
         <refname>rand</refname>
         <refpurpose>Случайные числа</refpurpose>
                 <term>key</term>
                 <listitem>
                     <para>
-                        строка, распределение случайных чисел (по умолчанию <literal>key="uniform"</literal>). Доступными значениями являются <literal>"uniform"</literal> (равновероятный) и <literal>"normal"</literal> (нормальный).
+                        строка, распределение случайных чисел (по умолчанию
+                        <literal>key="uniform"</literal>). Доступными значениями являются
+                        <literal>"uniform"</literal> (равновероятный) и <literal>"normal"</literal>
+                        (нормальный).
                     </para>
                 </listitem>
             </varlistentry>
@@ -58,7 +64,8 @@
                 <term>x</term>
                 <listitem>
                     <para>
-                        вещественная или комплексная матрица. Рассматриваются только её вещественное или комплексное содержимое и её размеры.
+                        вещественная или комплексная матрица. Рассматриваются только её
+                        вещественное или комплексное содержимое и её размеры.
                     </para>
                 </listitem>
             </varlistentry>
@@ -66,7 +73,8 @@
                 <term>r</term>
                 <listitem>
                     <para>
-                        вещественный массив чисел двойной точности (double) размером  m1 на m2 на ... со случайными элементами.
+                        вещественный массив чисел двойной точности (double) размером
+                        m1 на m2 на ... со случайными элементами.
                     </para>
                 </listitem>
             </varlistentry>
@@ -74,7 +82,8 @@
                 <term>s</term>
                 <listitem>
                     <para>
-                        матрица чисел двойной точности размером  1 на 1, целочисленное значение, положительное, семя генератора случайных чисел (по умолчанию <literal>s=0</literal>).
+                        матрица чисел двойной точности размером  1 на 1, целочисленное значение,
+                        положительное, семя генератора случайных чисел (по умолчанию <literal>s=0</literal>).
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Описание</title>
         <para>
-            Назначение данной функции в том, чтобы возвращать матрицу чисел двойной точности со случайными вещественными или комплексными элементами. В зависимости от входных аргументов, функция может возвращать матрицу случайных чисел двойной точности или может получать или устанавливать закон распределения случайных чисел, или может получать или устанавливать семя генератора случайных чисел.
+            Назначение данной функции в том, чтобы возвращать матрицу чисел двойной точности со
+            случайными вещественными или комплексными элементами. В зависимости от входных аргументов,
+            функция может возвращать матрицу случайных чисел двойной точности или может получать
+            или устанавливать закон распределения случайных чисел, или может получать или
+            устанавливать семя генератора случайных чисел.
         </para>
     </refsection>
     <refsection>
                 <term>r=rand()</term>
                 <listitem>
                     <para>
-                        возвращает матрицу чисел двойной точности размером 1 на 1 с одним случайным значением.
+                        возвращает матрицу чисел двойной точности размером 1 на 1 с одним случайным
+                        значением.
                     </para>
                 </listitem>
             </varlistentry>
                 <term>r=rand(m1,m2)</term>
                 <listitem>
                     <para>
-                        это матрица случайных чисел размером <literal>m1</literal> на  <literal>m2</literal>.
+                        это матрица случайных чисел размером <literal>m1</literal> на <literal>m2</literal>.
                     </para>
                 </listitem>
             </varlistentry>
                 <term>r=rand(a)</term>
                 <listitem>
                     <para>
-                        возвращает матрицу случайных чисел того же размера, что и <literal>a</literal>. Матрица <literal>r</literal> является вещественной, если  <literal>a</literal> является вещественной и  <literal>r</literal> является комплексной, если <literal>a</literal> является комплексной матрицей.
+                        возвращает матрицу случайных чисел того же размера, что и <literal>a</literal>.
+                        Матрица <literal>r</literal> является вещественной, если  <literal>a</literal>
+                        является вещественной и  <literal>r</literal> является комплексной,
+                        если <literal>a</literal> является комплексной матрицей.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Смена закона распределения случайных чисел</title>
         <para>
-            Входной аргумент <literal>key</literal> устанавливает закон распределения генерируемых случайных чисел.
+            Входной аргумент <literal>key</literal> устанавливает закон распределения генерируемых
+            случайных чисел.
         </para>
         <variablelist>
             <varlistentry>
                 <term>rand("uniform")</term>
                 <listitem>
                     <para>
-                        устанавливает генератор случайных чисел на генерацию случайных чисел по равновероятному закону. Случайные числа равномерно распределены на интервале
-                        (0,1).
+                        устанавливает генератор случайных чисел на генерацию случайных чисел по
+                        равновероятному закону. Случайные числа равномерно распределены на интервале
+                        [0,1).
                     </para>
                 </listitem>
             </varlistentry>
                 <term>rand("normal")</term>
                 <listitem>
                     <para>
-                        устанавливает генератор случайных чисел на генерацию случайных чисел по нормальному (Гаусс-Лапласовскому) закону распределения, с математическим ожиданием 0 и дисперсией 1.
+                        устанавливает генератор случайных чисел на генерацию случайных чисел по
+                        нормальному (Гаусс-Лапласовскому) закону распределения, с
+                        математическим ожиданием 0 и дисперсией 1.
                     </para>
                 </listitem>
             </varlistentry>
                 <term>key=rand("info")</term>
                 <listitem>
                     <para>
-                        возвращает текущий закон распределения генератора случайных чисел ("uniform" для равновероятного или "normal" для нормального).
+                        возвращает текущий закон распределения генератора случайных чисел
+                        ("uniform" для равновероятного или "normal" для нормального).
                     </para>
                 </listitem>
             </varlistentry>
                 <term>rand("seed",s)</term>
                 <listitem>
                     <para>
-                        устанавливает семя генератора случайных чисел равным <literal>s</literal> (по умолчанию <literal>s=0</literal> при первом вызове).
+                        устанавливает семя генератора случайных чисел равным <literal>s</literal>
+                        (по умолчанию <literal>s=0</literal> при первом вызове).
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Примеры</title>
         <para>
-            В следующем примере мы генерируем случайные числа двойной точности с различными законами распределения.
+            В следующем примере мы генерируем случайные числа двойной точности с различными
+            законами распределения.
         </para>
         <programlisting role="example"><![CDATA[
 // Получим одно случайное число (на основе текущего распределения)
@@ -203,7 +227,9 @@ r=rand(x,"normal")
 r=rand(2,2,2)
  ]]></programlisting>
         <para>
-            В следующем примере мы изменим закон распределения чисел, генерируемых функцией <literal>rand</literal>. Сначала генерируем числа по нормальному закону распределения, а затем числа но равновероятному закону на интервале [0,1).
+            В следующем примере мы изменим закон распределения чисел, генерируемых функцией
+            <literal>rand</literal>. Сначала генерируем числа по нормальному закону распределения,
+            а затем числа но равновероятному закону на интервале [0,1).
         </para>
         <programlisting role="example"><![CDATA[
     // настроим генератор случайных чисел на
@@ -221,7 +247,8 @@ r=rand(2,2,2)
     key=rand("info")
     ]]></programlisting>
         <para>
-            В следующем примере мы сгенерируем матрицу комплексных чисел размером 2 на 3 по нормальному закону распределения.
+            В следующем примере мы сгенерируем матрицу комплексных чисел размером 2 на 3 по
+            нормальному закону распределения.
         </para>
         <programlisting role="example"><![CDATA[
     // формируем матрицу случайных комплексных чисел размером 2 на 3
@@ -231,7 +258,8 @@ r=rand(2,2,2)
     r=rand(x,"normal")
     ]]></programlisting>
         <para>
-            В следующем примере мы построим на графике распределение случайных равновероятных чисел, полученных <literal>rand</literal>.
+            В следующем примере мы построим на графике распределение случайных равновероятных чисел,
+            полученных <literal>rand</literal>.
         </para>
         <programlisting role="example"><![CDATA[
     r=rand(1000,1,"uniform");
@@ -240,7 +268,8 @@ r=rand(2,2,2)
     xtitle("Равновероятные числа из rand","X","Частота")
     ]]></programlisting>
         <para>
-            В следующем примере мы построим на графике распределение случайных чисел, сгенерированных <literal>rand</literal> по нормальному закону распределения.
+            В следующем примере мы построим на графике распределение случайных чисел,
+            сгенерированных <literal>rand</literal> по нормальному закону распределения.
         </para>
         <programlisting role="example"><![CDATA[
     r=rand(1000,1,"normal");
@@ -252,13 +281,21 @@ r=rand(2,2,2)
     <refsection>
         <title>Получение более или менее предсказуемых чисел</title>
         <para>
-            Генератор псевдослучайных "равновероятных" чисел является детерминированной последовательностью, которая предназначена для воспроизводства независимых одинаково распределённых чисел, равновероятных на интервале (0,1).
+            Генератор псевдослучайных "равновероятных" чисел является детерминированной
+            последовательностью, которая предназначена для воспроизводства независимых одинаково
+            распределённых чисел, равновероятных на интервале [0,1).
         </para>
         <para>
-            Для того, чтобы получить повторяемые моделирования, начальное семя генератора случайных чисел равно нулю, так что последовательность будет оставаться одной и той же от одной сессии к другой. Иными словами, начальные числа, производимые <literal>rand()</literal>, всегда: 0.2113249,  0.7560439, ...
+            Для того, чтобы получить повторяемые моделирования, начальное семя генератора случайных
+            чисел равно нулю, так что последовательность будет оставаться одной и той же от одной
+            сессии к другой. Иными словами, начальные числа, производимые <literal>rand()</literal>,
+            всегда: 0.2113249,  0.7560439, ...
         </para>
         <para>
-            В некоторых случаях моделирования мы можем захотеть инициализировать семя генератора случайных чисел для того, чтобы получить менее предсказуемые последовательности. В этом случае мы можем инициализировать семя с помощью выходного значения функции <literal>getdate</literal>:
+            В некоторых случаях моделирования мы можем захотеть инициализировать семя генератора
+            случайных чисел для того, чтобы получить менее предсказуемые последовательности.
+            В этом случае мы можем инициализировать семя с помощью выходного значения функции
+            <literal>getdate</literal>:
         </para>
         <programlisting role="example"><![CDATA[
 n=getdate("s");
@@ -268,41 +305,42 @@ rand("seed",n);
     <refsection>
         <title>Генератор</title>
         <para>
-            Генератор случайных "равновероятных" чисел описан в работе Майкла А. Малькольма, (Michael A. Malcolm), Клива Б. Молера (Cleve B. Moler) "Urand, A Universal Random Number Generator" (Urand, Универсальный Генератор Случайных Чисел), Stan-Cs-73-334, январь 1973, факультет информатики, кафедра гуманитарных и естественных наук Стенфордского университета.
+            Генератор случайных "равновероятных" чисел описан в работе Майкла А. Малькольма,
+            (Michael A. Malcolm), Клива Б. Молера (Cleve B. Moler) "Urand, A Universal Random Number
+            Generator" (Urand, Универсальный Генератор Случайных Чисел), Stan-Cs-73-334, январь 1973,
+            факультет информатики, кафедра гуманитарных и естественных наук Стенфордского университета.
         </para>
         <para>
             Это линейный конгруэнтный генератор вида:
         </para>
         <para>
-            <latex>
-                $$
-                x = (a x + c) \textrm{mod} M
-                $$
-            </latex>
+             x = (a x + c) mod M
         </para>
         <para>
             где константами являются
+          <table border="0" cellpadding="0">
+             <tr><td>a = 843314861</td></tr>
+             <tr><td>c = 453816693</td></tr>
+             <tr><td>M = 2<superscript>31</superscript></td></tr>
+          </table>
         </para>
         <para>
-            <latex><![CDATA[
-         \begin{eqnarray}
-      a &=& 843314861\\
-      c &=& 453816693\\
-      M &=& 2^{31}
-         \end{eqnarray}
- ]]></latex>
+            Согласно авторам, этот генератор является генератором полной длины, иначе говоря,
+            его период равен M = 2<superscript>31</superscript> = 2147483648.
         </para>
         <para>
-            Согласно авторам, этот генератор является генератором полной длины, иначе говоря, его период равен <latex>M=2^{31}=2147483648</latex>.
-        </para>
-        <para>
-            Генератор случайных чисел с нормальным распределением (<literal>"normal"</literal>) основан на методе Бокса-Мюллера, где источником равновероятных случайных чисел является  Urand.
+            Генератор случайных чисел с нормальным распределением (<literal>"normal"</literal>)
+            основан на методе Бокса-Мюллера, где источником равновероятных случайных чисел является  Urand.
         </para>
     </refsection>
     <refsection>
         <title>Статистическое качество генератора</title>
         <para>
-            В функции <link linkend="grand">grand</link> доступны более лучшие генераторы случайных чисел в том смысле, что они имеют как более длинный период, так и более лучшие статистические свойства. В случае, когда качество случайных чисел имеет значение, следует использовать функцию <literal>grand</literal>. Более того, функция <literal>grand</literal> имеет больше возможностей.
+            В функции <link linkend="grand">grand</link> доступны более лучшие генераторы случайных
+            чисел в том смысле, что они имеют как более длинный период, так и более лучшие
+            статистические свойства. В случае, когда качество случайных чисел имеет значение,
+            следует использовать функцию <literal>grand</literal>.
+            Более того, функция <literal>grand</literal> имеет больше возможностей.
         </para>
     </refsection>
     <refsection role="see also">
index c3c631d..937b956 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:ns3="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="deletefile" xml:lang="en">
+<refentry 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"
+          xmlns:scilab="http://www.scilab.org" xml:id="deletefile" xml:lang="en">
     <refnamediv>
         <refname>deletefile</refname>
         <refpurpose>deletes a file</refpurpose>
@@ -45,8 +48,9 @@
     <refsection>
         <title>Description</title>
         <para>
-            This function deletes a file <varname>filename</varname>. If file <varname>filename</varname> has been deleted, it will return <constant>%t</constant> else
-            <constant>%f</constant>.
+            This function deletes a file <varname>filename</varname>.
+            If file <varname>filename</varname> has been deleted,
+            it will return <constant>%t</constant> else <constant>%f</constant>.
         </para>
     </refsection>
     <refsection>
@@ -64,6 +68,17 @@ deletefile(TMPDIR+'/notexistingfile')
 deletefile(TMPDIR+['/notexistingfile' '/notexistingsecondfile'])
     ]]></programlisting>
     </refsection>
+    <refsection role="see also">
+        <title>See Also</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="mdelete">mdelete</link>
+            </member>
+            <member>
+                <link linkend="rmdir">rmdir</link>
+            </member>
+        </simplelist>
+    </refsection>
     <refsection>
         <title>History</title>
         <revhistory>
index 9c82565..e3c8067 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="pathconvert">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="pathconvert">
     <refnamediv>
         <refname>pathconvert</refname>
         <refpurpose>converts a path to an OS path format.</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
+        <synopsis>
+          paths = pathconvert(paths)
+          paths = pathconvert(paths, flagtrail)
+          paths = pathconvert(paths, flagtrail, flagexpand)
+          paths = pathconvert(paths, flagtrail, flagexpand, type)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -56,7 +64,9 @@
                 <term>type</term>
                 <listitem>
                     <para>
-                        optional string, used to specify the target path format: <literal>'u'</literal> for POSIX path format (GNU/Linux,...), and <literal>'w'</literal> for Windows path format.
+                        optional string, used to specify the target path format: <literal>'u'</literal>
+                        for POSIX path format (GNU/Linux,...), and <literal>'w'</literal> for
+                        Windows path format.
                     </para>
                 </listitem>
             </varlistentry>
         <title>Description</title>
         <para>
             <function>pathconvert</function> is used to convert a set of paths,
-            to be compatible with an OS (Operating System) path format. For example Windows path style uses <literal>/</literal> for file separator, while it is <literal>\</literal> on other OS.
+            to be compatible with an OS (Operating System) path format.
+            For example Windows path style uses <literal>/</literal> for file separator,
+            while it is <literal>\</literal> on other OS.
         </para>
         <para>
-            By default, the paths are converted to the current OS path format (but another path format can be specified with argument <varname>type</varname>).
-        </para>
-        <para>
-            <note>
-                Note: Windows paths starting with a drive letter prefix are converted to
-                the POSIX paths using the cygwin convention (with <literal>/cygdrive</literal>).
-                For example: <literal>C:\tmp</literal> will be converted to <literal>/cygdrive/C/tmp</literal>.
-            </note>
+            By default, the paths are converted to the current OS path format (but another path
+            format can be specified with argument <varname>type</varname>).
         </para>
+        <note>
+            When some Windows-like paths starting with a drive letter like "C:" are converted
+            to a non-Windows format, the drive letter is then converted using the
+            cygwin convention,  with the <literal>/cygdrive/</literal> header.
+            For example, <literal>C:\tmp</literal> will be converted to <literal>/cygdrive/C/tmp</literal>.
+        </note>
         <para>
             <varname>flagtrail</varname> is used to add or remove a file
             separator (depending on the target path format) to the end
@@ -138,4 +150,15 @@ pathconvert("/cygdrive/c/tmp", %f, %f, "w")
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.2.0</revnumber>
+                <revdescription>
+                    flagtrail=%f now removes existing trailing "/" or "\" separators.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index c6adfea..64d1887 100644 (file)
  *
  -->
 
-<refentry 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" xmlns:scilab="http://www.scilab.org" xml:id="deletefile" xml:lang="ja">
+<refentry 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"
+          xmlns:scilab="http://www.scilab.org" xml:id="deletefile" xml:lang="ja">
 
     <refnamediv>
 
@@ -102,6 +105,25 @@ deletefile(TMPDIR+'/notexistingfile')
     ]]></programlisting>
 
     </refsection>
-
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="mdelete">mdelete</link>
+            </member>
+            <member>
+                <link linkend="rmdir">rmdir</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>Manage multi-dimensionnal arguments to remove multiple files at once.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
 
index f094071..ee178b0 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="pathconvert">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="pathconvert">
     <refnamediv>
         <refname>pathconvert</refname>
         <refpurpose>POSIXおよびwindowsの間でパス名を変換.  </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>paths=pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
+        <synopsis>
+          paths = pathconvert(paths)
+          paths = pathconvert(paths, flagtrail)
+          paths = pathconvert(paths, flagtrail, flagexpand)
+          paths = pathconvert(paths, flagtrail, flagexpand, type)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>パラメータ</title>
@@ -112,4 +120,15 @@ pathconvert("/cygdrive/c/tmp",%f,%f,"w")
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.2.0</revnumber>
+                <revdescription>
+                    flagtrail=%f now removes existing trailing "/" or "\" separators.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index addbc49..577f647 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:ns3="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="deletefile" xml:lang="ru">
+<refentry 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"
+          xmlns:scilab="http://www.scilab.org" xml:id="deletefile" xml:lang="ru">
     <refnamediv>
         <refname>deletefile</refname>
         <refpurpose>удаляет файл</refpurpose>
@@ -44,7 +47,8 @@
     <refsection>
         <title>Описание</title>
         <para>
-            Эта функция удаляет файл <varname>filename</varname>. Если файл <varname>filename</varname> удалён, то она возвращает
+            Эта функция удаляет файл <varname>filename</varname>.
+            Если файл <varname>filename</varname> удалён, то она возвращает
             <constant>%t</constant>, а иначе <constant>%f</constant>.
         </para>
     </refsection>
@@ -61,5 +65,27 @@ end
 deletefile(TMPDIR+'/notexistingfile')
     ]]></programlisting>
     </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="mdelete">mdelete</link>
+            </member>
+            <member>
+                <link linkend="rmdir">rmdir</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                  Управление многомерными аргументами для удаления множества файлов одновременно.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
 
index 8e0f47d..1f3b24d 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="pathconvert">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ru" xml:id="pathconvert">
     <refnamediv>
         <refname>pathconvert</refname>
         <refpurpose>преобразование имён путей между POSIX и Windows.</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Синтаксис</title>
-        <synopsis>paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
+        <synopsis>
+          paths = pathconvert(paths)
+          paths = pathconvert(paths, flagtrail)
+          paths = pathconvert(paths, flagtrail, flagexpand)
+          paths = pathconvert(paths, flagtrail, flagexpand, type)
+        </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
@@ -149,5 +157,16 @@ pathconvert("/cygdrive/c/tmp", %f, %f, "w")
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.2.0</revnumber>
+                <revdescription>
+                  <literal>flagtrail=%f</literal> теперь удаляет имеющиеся разделители "/" или "\" в конце строк.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
 
index 5e818ef..497a965 100644 (file)
@@ -102,9 +102,6 @@ a = 3;
                 <link linkend="genlib">genlib</link>
             </member>
             <member>
-                <link linkend="quote">quote</link>
-            </member>
-            <member>
                 <link linkend="jdeff">jdeff</link>
             </member>
             <member>
index d7e1dd9..4d871a8 100644 (file)
@@ -106,9 +106,6 @@ a = 3;
                 <link linkend="genlib">genlib</link>
             </member>
             <member>
-                <link linkend="quote">quote</link>
-            </member>
-            <member>
                 <link linkend="jdeff">jdeff</link>
             </member>
             <member>
index 8328b16..6933e93 100644 (file)
@@ -101,9 +101,6 @@ a = 3;
                 <link linkend="genlib">genlib</link>
             </member>
             <member>
-                <link linkend="quote">quote</link>
-            </member>
-            <member>
                 <link linkend="jdeff">jdeff</link>
             </member>
             <member>
index 1a52421..bd38b86 100644 (file)
@@ -102,9 +102,6 @@ a = 3;
                 <link linkend="genlib">genlib</link>
             </member>
             <member>
-                <link linkend="quote">quote</link>
-            </member>
-            <member>
                 <link linkend="jdeff">jdeff</link>
             </member>
             <member>
@@ -120,13 +117,13 @@ a = 3;
                 <revdescription>
                    <itemizedlist>
                      <listitem>
-                       The input option
+                       Входная опция
                        <ulink url="https://help.scilab.org/docs/5.5.2/ru_RU/deff.html">
                          <varname>opt="c"|"p"|"n"</varname>
-                       </ulink> is no longer available.
+                       </ulink> более не доступна.
                      </listitem>
                      <listitem>
-                        The defined <varname>newfunction</varname> is now of type 13 (instead of 11).
+                        Определённая новая функция <varname>newfunction</varname> теперь имеет тип 13 (вместо 11).
                      </listitem>
                   </itemizedlist>
                 </revdescription>
index 260b399..250191a 100644 (file)
@@ -569,7 +569,8 @@ f.children.y_label.font_size = 3;
                 <revnumber>5.4.0</revnumber>
                 <revremark>
                   line_style value 0 is obsolete, use 1 instead (both are equivalent for  SOLID).
-                  Using value 0 will produce an error in Scilab 5.4.1.
+                  Using value 0 will produce an error in Scilab 5.4.1. New line_style values
+                  9 and 10 added.
                 </revremark>
             </revision>
             <revision>
index 3329351..5b0134f 100644 (file)
@@ -589,7 +589,7 @@ f.children.y_label.font_size = 3;
                 <revnumber>5.4.0</revnumber>
                 <revremark>line_style = 0 は廃止予定です.代わりに 1 を使用してください
                     (両者は等価で,共に実線を意味します). Scilab 5.4.1以降,値0を使用すると
-                    エラーを発生します.
+                    エラーを発生します. New line_style values 9 and 10 added.
                 </revremark>
             </revision>
             <revision>
index 9223508..dcfda9f 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="console_properties">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="console_properties">
     <refnamediv>
         <refname>Console properties</refname>
         <refpurpose>Description of console object properties.</refpurpose>
@@ -101,7 +104,16 @@ h=uicontrol() // Full display of properties
                 <link linkend="root_properties">root_properties</link>
             </member>
             <member>
-                <link linkend="get">get</link>
+                <link linkend="usecanvas">usecanvas</link>
+            </member>
+            <member>
+                <link linkend="system_setproperty">system_setproperty</link>
+            </member>
+            <member>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
+            </member>
+            <member>
+                <link linkend="setlookandfeel">setlookandfeel</link>
             </member>
             <member>
                 <link linkend="uicontrol">uicontrol</link>
index 453d47e..7ca5a2b 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="root_properties">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="root_properties">
     <refnamediv>
         <refname>root_properties</refname>
         <refpurpose>description of the root object properties.</refpurpose>
@@ -21,7 +24,9 @@
     <refsection>
         <title>Description</title>
         <para>
-            The root object is a virtual object used to get the computer screen properties. Use <literal>get</literal> function with <emphasis>0</emphasis> as first argument to access its properties.
+            The root object is a virtual object used to get the computer screen properties.
+            Use <literal>get</literal> function with <emphasis>0</emphasis> as first argument
+            to access its properties.
         </para>
         <variablelist>
             <varlistentry>
@@ -86,7 +91,25 @@ get(0, "screendepth")
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="get">get</link>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
+            </member>
+            <member>
+                <link linkend="system_getproperty">system_getproperty</link>
+            </member>
+            <member>
+                <link linkend="console_properties">console_properties</link>
+            </member>
+            <member>
+                <link linkend="usecanvas">usecanvas</link>
+            </member>
+            <member>
+                <link linkend="getlookandfeel">getlookandfeel</link>
+            </member>
+            <member>
+                <link linkend="preferences">preferences</link>
+            </member>
+            <member>
+                <link linkend="printsetupbox">printsetupbox</link>
             </member>
         </simplelist>
     </refsection>
index 0300651..ad7ec0e 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="root_properties">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="fr" xml:id="root_properties">
     <refnamediv>
         <refname>root_properties</refname>
         <refpurpose>Description des propriétés de l'objet root.</refpurpose>
@@ -21,7 +24,9 @@
     <refsection>
         <title>Description</title>
         <para>
-            L'objet root est un objet virtuel utilisé pour obtenir les propriétés de l'écran de l'ordinateur. Utilisez la fonction <literal>get</literal> avec <emphasis>0</emphasis> comme premier paramétre pour accéder à ses propriétés.
+            L'objet root est un objet virtuel utilisé pour obtenir les propriétés de l'écran de
+            l'ordinateur. Utilisez la fonction <literal>get</literal> avec <emphasis>0</emphasis>
+            comme premier paramétre pour accéder à ses propriétés.
         </para>
         <variablelist>
             <varlistentry>
@@ -86,7 +91,25 @@ get(0, "screendepth")
         <title>Voir aussi</title>
         <simplelist type="inline">
             <member>
-                <link linkend="get">get</link>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
+            </member>
+            <member>
+                <link linkend="system_getproperty">system_getproperty</link>
+            </member>
+            <member>
+                <link linkend="console_properties">console_properties</link>
+            </member>
+            <member>
+                <link linkend="usecanvas">usecanvas</link>
+            </member>
+            <member>
+                <link linkend="getlookandfeel">getlookandfeel</link>
+            </member>
+            <member>
+                <link linkend="preferences">preferences</link>
+            </member>
+            <member>
+                <link linkend="printsetupbox">printsetupbox</link>
             </member>
         </simplelist>
     </refsection>
index 812ed74..4eaa436 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="console_properties">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="console_properties">
     <refnamediv>
         <refname>consoleプロパティ</refname>
         <refpurpose>consoleオブジェクトプロパティの説明.</refpurpose>
@@ -115,7 +118,16 @@ h=uicontrol() // Full display of properties
                 <link linkend="root_properties">root_properties</link>
             </member>
             <member>
-                <link linkend="get">get</link>
+                <link linkend="usecanvas">usecanvas</link>
+            </member>
+            <member>
+                <link linkend="system_setproperty">system_setproperty</link>
+            </member>
+            <member>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
+            </member>
+            <member>
+                <link linkend="setlookandfeel">setlookandfeel</link>
             </member>
             <member>
                 <link linkend="uicontrol">uicontrol</link>
index 3cb78a7..b3d050d 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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="root_properties">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="root_properties">
     <refnamediv>
         <refname>root_properties</refname>
         <refpurpose>ルートオブジェクトプロパティの説明.</refpurpose>
@@ -91,8 +94,26 @@ get(0, "screendepth")
         <title>参照</title>
         <simplelist type="inline">
             <member>
-                <link linkend="get">get</link>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
             </member>
-        </simplelist>
+            <member>
+                <link linkend="system_getproperty">system_getproperty</link>
+            </member>
+            <member>
+                <link linkend="console_properties">console_properties</link>
+            </member>
+            <member>
+                <link linkend="usecanvas">usecanvas</link>
+            </member>
+            <member>
+                <link linkend="getlookandfeel">getlookandfeel</link>
+            </member>
+            <member>
+                <link linkend="preferences">preferences</link>
+            </member>
+            <member>
+                <link linkend="printsetupbox">printsetupbox</link>
+            </member>
+      </simplelist>
     </refsection>
 </refentry>
diff --git a/scilab/modules/helptools/images/_LaTeX_rand.xml_1.png b/scilab/modules/helptools/images/_LaTeX_rand.xml_1.png
deleted file mode 100644 (file)
index 031d3e3..0000000
Binary files a/scilab/modules/helptools/images/_LaTeX_rand.xml_1.png and /dev/null differ
diff --git a/scilab/modules/helptools/images/_LaTeX_rand.xml_2.png b/scilab/modules/helptools/images/_LaTeX_rand.xml_2.png
deleted file mode 100644 (file)
index 697e647..0000000
Binary files a/scilab/modules/helptools/images/_LaTeX_rand.xml_2.png and /dev/null differ
diff --git a/scilab/modules/helptools/images/_LaTeX_rand.xml_3.png b/scilab/modules/helptools/images/_LaTeX_rand.xml_3.png
deleted file mode 100644 (file)
index a5e6b0c..0000000
Binary files a/scilab/modules/helptools/images/_LaTeX_rand.xml_3.png and /dev/null differ
index 955ed4d..a3d950f 100644 (file)
@@ -14,7 +14,7 @@
     <refnamediv>
         <refname>csvTextScan</refname>
 
-        <refpurpose>Convert a comma-separated value to a matrix</refpurpose>
+        <refpurpose>Converts into a matrix texts representing separated values</refpurpose>
     </refnamediv>
 
     <refsynopsisdiv>
@@ -37,7 +37,7 @@
                 <term>M</term>
 
                 <listitem>
-                    <para>a m-by-1 or 1-by-m matrix of strings.</para>
+                    <para>vector of strings. UTF-8 strings are supported.</para>
                 </listitem>
             </varlistentry>
 
@@ -45,7 +45,7 @@
                 <term>separator</term>
 
                 <listitem>
-                    <para>a 1-by-1 matrix of strings, the column separator mark.</para>
+                    <para>a string: the column separator mark.</para>
                 </listitem>
             </varlistentry>
 
                 <term>decimal</term>
 
                 <listitem>
-                    <para>a 1-by-1 matrix of strings, the decimal mark. The available
-                        values are "." or ",".
+                    <para>a string: the decimal mark. The available values are "." or ",".
                     </para>
                     <para>
-                        If <literal>decimal</literal> is different of <literal>[]</literal> and <literal>conversion</literal> is set to <literal>string</literal>, the decimal conversion will be done.
+                        If <literal>decimal</literal> is not <literal>[]</literal> and
+                        <literal>conversion</literal> is set to <literal>string</literal>,
+                        the decimal conversion will be done.
                     </para>
                 </listitem>
             </varlistentry>
 
             <varlistentry>
                 <term>conversion</term>
-
                 <listitem>
-                    <para>a 1-by-1 matrix of strings, the type of the output
-                        <literal>A</literal>. Available values are "string" or
-                        "double".
+                    <para>
+                        "string" or "double": type of the expected output <literal>A</literal>.
+                         With "double",
+                        <itemizedlist>
+                            <listitem>
+                                any input that can't be parsed as a literal number is converted to
+                                <literal>%nan</literal>.
+                            </listitem>
+                            <listitem>
+                                literal complex numbers are supported.
+                            </listitem>
+                        </itemizedlist>
                     </para>
                 </listitem>
             </varlistentry>
 
             <varlistentry>
                 <term>range</term>
-
                 <listitem>
-                    <para>a 1-by-4 or 4-by-1 matrix of floating point integers, the
+                    <para>vector of 4 decimal integers: the
                         range of rows and columns which must be read (default range=[],
                         meaning that all the rows and columns). Specify range using the
                         format <literal>[R1 C1 R2 C2]</literal> where (R1,C1) is the upper
 
             <varlistentry>
                 <term>A</term>
-
                 <listitem>
-                    <para>a m-by-n matrix of strings or double.</para>
+                  <para>
+                    matrix of strings or double, with as many rows as <literal>M</literal> has
+                    components: <literal>A(i,:)</literal> is the conversion result of
+                    <literal>M(i)</literal>.
+                  </para>
                 </listitem>
             </varlistentry>
         </variablelist>
 
     <refsection>
         <title>Description</title>
-
-        <para>Given an ascii file with delimited fields, this function returns the
-            corresponding Scilab matrix of strings or doubles.
+        <para>
+            Given a text matrix with delimited fields, this function returns the
+            corresponding Scilab matrix of strings or of decimal or complex numbers.
         </para>
-
         <para>
-            The <literal>csvTextScan</literal> function has the same purpose as
-            <literal>csvRead</literal>, except that <literal>csvTextScan</literal>
-            reads in a string, while <literal>csvRead</literal> reads in a
-            file.
+            To skip an input argument and use its default value, specify [].
         </para>
-
-        <para>The default value of the optional input arguments are defined by the
+        <para>
+            The default values of optional input arguments are defined by the
             <literal>csvDefault</literal> function.
         </para>
-
-        <para>Any optional input argument equal to the empty matrix
-            <literal>[]</literal> is set to its default value.
-        </para>
-
-        <para>When input argument "conversion" is equal to "double", strings are
-            converted as NaN.
-        </para>
+        <note>
+            The <literal>csvTextScan</literal> and <literal>csvRead</literal> functions have the
+            same purpose. <literal>csvTextScan</literal> input are strings,
+            while <literal>csvRead</literal> reads from a file.
+        </note>
     </refsection>
 
     <refsection>
@@ -164,7 +168,9 @@ csvTextScan( Atext , ";" , "," )
             <revision>
                 <revnumber>5.4.1</revnumber>
                 <revremark>
-                    If <literal>decimal</literal> is different of <literal>[]</literal> and <literal>conversion</literal> is set to <literal>string</literal>, the decimal conversion will be done.
+                    If <literal>decimal</literal> is not <literal>[]</literal> and
+                    <literal>conversion</literal> is set to <literal>string</literal>,
+                    the decimal conversion will be done.
                 </revremark>
             </revision>
         </revhistory>
index 186f763..f880da0 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:ns3="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="getsystemmetrics" xml:lang="en">
+<refentry 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"
+          xmlns:scilab="http://www.scilab.org" xml:id="getsystemmetrics" xml:lang="en">
     <refnamediv>
         <refname>getsystemmetrics</refname>
         <refpurpose>Retrieves the specified system metric or system configuration
@@ -643,4 +646,27 @@ getsystemmetrics('SM_SLOWMACHINE')
 getsystemmetrics('SM_REMOTESESSION');
  ]]></programlisting>
     </refsection>
+    <refsection role="see also">
+        <title>See also</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="root_properties">root_properties</link>
+            </member>
+            <member>
+                <link linkend="system_getproperty">system_getproperty</link>
+            </member>
+            <member>
+                <link linkend="getlookandfeel">getlookandfeel</link>
+            </member>
+            <member>
+                <link linkend="printsetupbox">printsetupbox</link>
+            </member>
+            <member>
+                <link linkend="preferences">preferences</link>
+            </member>
+            <member>
+                <link linkend="usecanvas">usecanvas</link>
+            </member>
+        </simplelist>
+    </refsection>
 </refentry>