[doc] load() page updated for Scilab 6 + overhauled 81/20281/4
Samuel GOUGEON [Mon, 16 Jul 2018 21:44:30 +0000 (23:44 +0200)]
 New proposed page (PDF):
 https://codereview.scilab.org/cat/20282%2C1%2Cscilab/modules/io/help/en_US/load.pdf

Change-Id: Id9bd47898ccb625b95abbc56566ceef545c51f43

scilab/CHANGES.md
scilab/modules/io/help/en_US/load.xml
scilab/modules/io/help/ja_JP/load.xml [deleted file]
scilab/modules/io/help/pt_BR/load.xml [deleted file]

index 7b70fe2..7fddd7f 100644 (file)
@@ -254,7 +254,8 @@ Help pages:
  `and`, `&,&&`, `format`, `type`, `typeof`, `brackets`, `setlanguage`, `sleep`, `isinf`, `unique`,
  `bitor`, `bitxor`, `bitand`, `macr2tree`, `geomean`, `clf`, `getPreferencesValue`, `gcd`, `isglobal`,
  `whereis`, `mode`, `%onprompt`, `toeplitz`, `param3d`, `param3d1`, `argn`,
- `mtlb_int8`, `mtlb_int16`, `mtlb_int32`, `mtlb_int64`, `mtlb_uint8`, `mtlb_uint16`, `mtlb_uint32`, `mtlb_uint64`, `intersect`
+ `mtlb_int8`, `mtlb_int16`, `mtlb_int32`, `mtlb_int64`, `mtlb_uint8`, `mtlb_uint16`, `mtlb_uint32`, `mtlb_uint64`, `intersect`,
+ `load`
 * reorganized:
   - `else`, `elseif`, `end`, `try`, `sciargs`, `global`, `halt`, `empty`, `power`, `numderivative`
   - `pixel_drawing_mode`, `show_window`, `twinkle`, `uigetcolor`, `winsid`, `xdel`, `xgrid`, `xname`, `xnumb`
index bff072e..a70870d 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
- *
  * 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: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="load" 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="load" xml:lang="en">
     <refnamediv>
         <refname>load</refname>
-        <refpurpose>Load a saved variable or a serie of variables</refpurpose>
+        <refpurpose>
+            Loads some archived variables, a saved graphic figure, a library of functions
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
         <synopsis>
-            load(filename [,x1,...,xn])
-            load(fd [,x1,...,xn])
+            load(filename)
+            load(filename, x1,...,xn)
+            load("path/myfigure.scg")
+            load("libdir/lib")
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>filename</term>
                 <listitem>
-                    <para>character string containing the path of the file</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>fd</term>
-                <listitem>
-                    <para>a file descriptor given by a call to mopen</para>
+                    <para>path and name of the single file where archived variables are stored.
+                        Any prepended "SCI", "TMPDIR", "SCIHOME" or "home" word being a predefined
+                        Scilab variable is expanded into its value.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>xi</term>
                 <listitem>
-                    <para>arbitrary Scilab variable name(s) given as strings.</para>
+                    <para>
+                        name(s) -- given as strings -- of Scilab variable(s) to be recovered.
+                    </para>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
         <title>Description</title>
+        <refsect3>
+            <title>Archived variables</title>
+            <para>
+                The <literal>load</literal> command can be used to reload in the Scilab session
+                variables previously saved in a file with the
+                <literal>
+                    <link linkend="save">save</link>
+                </literal>
+                command.
+            </para>
+            <para>
+                <literal>load(filename,'x','y')</literal> loads only variables <literal>x, y</literal>.
+                <itemizedlist>
+                    <listitem>
+                        <para>
+                        The list of variables stored in a file can be retrieved with the
+                        <link linkend="listvarinfile">listvarinfile</link> function.
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para>
+                        <literal>load()</literal> loads restores variables in the current scope
+                        (not on the global one).
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para>
+                            If a variable to be loaded is not in the file, an error is generated.
+                        </para>
+                    </listitem>
+                    <listitem>
+                            If a restored variable has the same name as an existing variable of
+                            the current scope, the current variable is silently overwritten.
+                    </listitem>
+                    <listitem>
+                        <para>
+                            When a variable to be restored is a graphic handle/identifier, the
+                            corresponding <link linkend="graphics_entities">graphic entity</link>
+                            is drawn with the current graphic driver.
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para>
+                            The SOD binary format used by Scilab 6 to save (and load) variables is
+                            based on the HDF5 format. It is fully documented and easy to read
+                            through HDF5 libraries or applications.
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para>
+                            Data files written with Scilab from other operating systems and
+                            architectures (little and big endian) are portable and accepted.
+                        </para>
+                    </listitem>
+                </itemizedlist>
+            </para>
+        </refsect3>
+        <refsect3>
+            <title>Graphic figures *.scg</title>
+            <para>
+                Any graphic figure can be saved in its whole either with <literal>save()</literal>
+                through its identifier as a variable (as decribed hereabove), or with
+                <literal>xsave()</literal> or the <emphasis>File => Save</emphasis> figure's Menu,
+                that do the same. The preferred (but not mandatory) file extension is
+                <emphasis role="bold">.scg</emphasis> (for SCilab Graphics).
+                Then, <literal>load(..)</literal> or <literal>xload()</literal>
+                may be used to restore saved figures. When using <literal>save(..)</literal>,
+                several figures may be saved in the same file.
+            </para>
+            <para>
+                Each restored figure gets a new incremented #id, so usually not the original one.
+            </para>
+            <para>
+                Figures including some interactive (uicontrol) components are fully restored.
+            </para>
+        </refsect3>
+        <refsect3>
+            <title>lib files: libraries of functions in Scilab language</title>
+            <para>
+                <literal>genlib(..)</literal> allows to compile a set of *.sci files and bundle
+                compiled binaries into a library described in a file always named
+                <literal>lib</literal>.
+            </para>
+            <para>
+                Then, <literal>load("/path/to/lib")</literal> allows to load the library in the
+                session. All its functions become available at the level where
+                <literal>load(..)</literal> is called.
+            </para>
+            <para>
+                When loading a library, <literal>load(..)</literal> silently creates a variable
+                representing it. Its name is registered in the lib file (that is XML formatted),
+                in the <literal>&lt;scilablib name="..."></literal> tag.
+            </para>
+            <para>
+                The library's name can be retrieved with
+                <literal>getPreferencesValue("/scilablib", "name", "/path/to/lib")</literal>,
+                where "/path/to/lib" is replaced with the actual pathname of the lib file.
+            </para>
+        </refsect3>
+    </refsection>
+    <refsection>
+        <title>Examples</title>
         <para>
-            The <literal>load</literal> command can be used to reload in the
-            Scilab session variables previously saved in a file with the
-            <literal>
-                <link linkend="save">save</link>
-            </literal>
-            command. If the file contains graphic handle
-            variables, the corresponding <link linkend="graphics_entities">graphics_entities</link> are drawn.
-        </para>
-        <para>
-            <literal>load(filename)</literal> loads the variables saved in file
-            given by its path <literal>filename</literal>.
-        </para>
-        <para>
-            <literal>load(fd)</literal> loads the variables saved in file given
-            by its descriptor <literal>fd</literal>. <emphasis role="bold">This prototype is obsolete and will be removed in Scilab 6.</emphasis>
+            With arrays of regular data types:
         </para>
+        <programlisting role="example"><![CDATA[
+d = rand(3,4,2);
+b = d < 0.5;
+i = int8((d-0.5)*100);
+t = string(i);
+p = (1-%z).^0:2;
+r = p./%z;
+s = sprand(3,5, 0.3);
+save("TMPDIR/val.dat", "b", "i", "d", "t", "s", "p", "r");
+clear d i b t s p r
+load("TMPDIR/val.dat");
+d, i, b, t, s, p, r
+     ]]></programlisting>
         <para>
-            <literal>load(filename,'x','y')</literal> loads only variables <literal>x,y</literal>.
+            Overwriting permanent variables is forbidden when loading:
         </para>
+        <programlisting role="example"><![CDATA[
+save("TMPDIR/val.dat", "%e");
+load("TMPDIR/val.dat");
+     ]]></programlisting>
+    <screen><![CDATA[
+--> load("TMPDIR/val.dat");
+Redefining permanent variable.
+]]></screen>
         <para>
-            <literal>load(fd,'x','y')</literal> loads only variables <literal>x,y</literal>. <emphasis role="bold">This prototype is obsolete and will be removed in Scilab 6.</emphasis>.
+            With graphic handles:
         </para>
+        <programlisting role="example"><![CDATA[
+clf reset
+subplot(1,3,1), plot2d(), a1 = gca();
+subplot(1,3,2), hist3d()
+subplot(1,3,3), plot3d(), a3 = gca();
+save(TMPDIR+"/test.scg", "a3", "a1")
+clf reset
+load(TMPDIR+"/test.scg")
+     ]]></programlisting>
+    <screen><![CDATA[
+--> load("TMPDIR/val.dat");
+Redefining permanent variable.
+]]></screen>
         <para>
-            The change of format between the family 5 and 6 of Scilab has been decided because the 5 format is undocumented, not specified and hard to read. SOD (Scilab 6 default format) is fully documented and easy to read through HDF5 libraries or applications.
+            Loading a library of functions compiled in Scilab language:
         </para>
-        <para>Note that the written file is portable to other operating systems
-            and architectures (little and big endian).
-        </para>
-    </refsection>
-    <refsection>
-        <title>Examples</title>
         <programlisting role="example"><![CDATA[
-// Binary format readable up to Scilab 5 family
-a=eye(2,2);b=ones(a);
-save('vals.dat',a,b);
-clear a
-clear b
-load('vals.dat','a','b');
-
-// Binary format readable by Scilab 5.4.X and Scilab 6 family
-a=eye(2,2);b=ones(a);
-save("val.sod", "a", "b");
-clear a
-clear b
-load("val.sod", "a", "b");
+path = "SCI/modules/scicos_blocks/macros/Threshold/lib";
+load(path)
+getPreferencesValue("/scilablib", "name", path)
+Thresholdlib
+     ]]></programlisting>
+    <screen><![CDATA[
+--> getPreferencesValue("/scilablib", "name", path)
+ ans  =
+ Thresholdlib
 
- ]]></programlisting>
+ --> Thresholdlib
+ Thresholdlib  =
+Functions files location : SCI\modules\scicos_blocks\macros\Threshold\.
+GENERAL_f  ZCROSS_f  NEGTOPOS_f  POSTONEG_f
+]]></screen>
     </refsection>
+        <para>
+            <literal>xcos()</literal> must be used to load a simulation diagram:
+        </para>
+        <programlisting role="example"><![CDATA[
+path = "SCI/modules/xcos/examples/derivative.zcos";
+load(path)  // => error
+xcos(path)
+     ]]></programlisting>
     <refsection role="see also">
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="save">save</link>
+                <link linkend="listvarinfile">listvarinfile</link>
             </member>
             <member>
-                <link linkend="read">read</link>
+                <link linkend="loadGui">loadGui</link>
             </member>
             <member>
-                <link linkend="listvarinfile">listvarinfile</link>
+                <link linkend="xload">xload</link>
             </member>
             <member>
-                <link linkend="save_format">save_format</link>
+                <link linkend="lib">lib</link>
             </member>
             <member>
-                <link linkend="exec">exec</link>
+                <link linkend="xcos">xcos</link>
+            </member>
+            <member>
+                <link linkend="loadmatfile">loadmatfile</link>
+            </member>
+            <member>
+                <link linkend="save">save</link>
             </member>
             <member>
-                <link linkend="mopen">mopen</link>
+                <link linkend="save_format">save_format</link>
+            </member>
+            <member>
+                <link linkend="exec">exec</link>
             </member>
         </simplelist>
     </refsection>
@@ -128,20 +267,42 @@ load("val.sod", "a", "b");
             <revision>
                 <revnumber>5.0.0</revnumber>
                 <revremark>
-                    All <link linkend="uimenu">uimenu</link> or <link linkend="uicontrol">uicontrol</link> handles are also loaded by this function.
+                    All <link linkend="uimenu">uimenu</link> or
+                    <link linkend="uicontrol">uicontrol</link> handles are also loaded by this
+                    function.
                 </revremark>
             </revision>
             <revision>
                 <revnumber>5.4.0</revnumber>
-                <revdescription>
+                <revremark>
                     <itemizedlist>
                         <listitem>
-                            The load function is able to handle both Scilab 5 and SOD (Scilab 6 format) by default.
+                            The load function is able to handle both Scilab 5 and SOD (Scilab 6
+                            format) by default.
+                        </listitem>
+                        <listitem>
+                            The Scilab 5.X format is deprecated.
+                        </listitem>
+                        <listitem>
+                            Using load with a file descriptor as first input argument is deprecated.
                         </listitem>
-                        <listitem>The Scilab 5.X format is deprecated and will be removed with Scilab 6.</listitem>
-                        <listitem>Using load with a file descriptor as first input argument is deprecated and will be removed with Scilab 6.</listitem>
                     </itemizedlist>
-                </revdescription>
+                </revremark>
+            </revision>
+            <revision>
+                <revnumber>6.0</revnumber>
+                <revremark>
+                    <itemizedlist>
+                        <listitem>
+                            load() is no longer able to handle data files saved with the Scilab
+                            &lt; 5.4 format.
+                        </listitem>
+                        <listitem>
+                            The syntaxes load(fid) and load(fid, x1,..) with a file id are no
+                            longer supported.
+                        </listitem>
+                    </itemizedlist>
+                </revremark>
             </revision>
         </revhistory>
     </refsection>
diff --git a/scilab/modules/io/help/ja_JP/load.xml b/scilab/modules/io/help/ja_JP/load.xml
deleted file mode 100644 (file)
index dd1312e..0000000
+++ /dev/null
@@ -1,155 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) XXXX-2008 - INRIA
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * 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.
- * This file was originally licensed under the terms of the CeCILL v2.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: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="load" xml:lang="ja">
-    <refnamediv>
-        <refname>load</refname>
-        <refpurpose>保存した1個または複数の変数を読み込む</refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>呼び出し手順</title>
-        <synopsis>
-            load(filename [,x1,...,xn])
-            load(fd [,x1,...,xn])
-        </synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>引数</title>
-        <variablelist>
-            <varlistentry>
-                <term>filename</term>
-                <listitem>
-                    <para>ファイルのパスを含む文字列</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>fd</term>
-                <listitem>
-                    <para>mopenのコールにより得られたファイル記述子</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>xi</term>
-                <listitem>
-                    <para>文字列で指定した任意のScilab変数名.</para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>説明</title>
-        <para>
-            <literal>load</literal> コマンドは
-            <literal>
-                <link linkend="save">save</link>
-            </literal>
-            コマンドにより
-            ファイルに保存されたScilabセッション変数を再度読み込む際に使用されます.
-            ファイルがグラフィックハンドル変数を含む場合,
-            対応する <link linkend="graphics_entities">graphics_entities</link> が描画されます.
-        </para>
-        <para>
-            <literal>load(filename)</literal> はパス <literal>filename</literal>で指定されたファイル
-            に保存された変数を読み込みます.
-        </para>
-        <para>
-            <literal>load(fd)</literal> は記述子 <literal>fd</literal>で指定された
-            ファイルに保存された変数を読み込みます.
-            <emphasis role="bold">このプロトタイプは廃止予定であり,Scilab 6では削除されます.</emphasis>
-        </para>
-        <para>
-            <literal>load(filename,'x','y')</literal> は,変数 <literal>x,y</literal>のみを読み込ます.
-        </para>
-        <para>
-            <literal>load(fd,'x','y')</literal> は,変数 <literal>x,y</literal>のみを読み込みます.
-            <emphasis role="bold">このプロトタイプは廃止予定であり,Scilab 6では削除されます.</emphasis>.
-        </para>
-        <para>
-            Scilab 5シリーズと6シリーズの間でフォーマットの変更が決められました.
-            これは,5形式は文書化されておらず,仕様が既定されておらず,読み込むことが困難であったためです.
-            SOD (Scilab 6 のデフォルト形式)は完全に文書化され,HDF5ライブラリまたはアプリケーションにより
-            容易に読み込むことができます.
-        </para>
-        <para>
-            書き込まれたファイルは他のオペレーティングシステムやアーキテクチャ
-            (リトルおよびビッグインディアン)に対する可搬性があります.
-        </para>
-    </refsection>
-    <refsection>
-        <title>例</title>
-        <programlisting role="example"><![CDATA[
-// Scilab 5 ファミリーまでで可読なバイナリ形式
-a=eye(2,2);b=ones(a);
-save('vals.dat',a,b);
-clear a
-clear b
-load('vals.dat','a','b');
-// Scilab 5.4.X および Scilab 6 ファミリーの両方で可読なバイナリ形式
-a=eye(2,2);b=ones(a);
-save("val.sod", "a", "b");
-clear a
-clear b
-load("val.sod", "a", "b");
- ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>参照</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="save">save</link>
-            </member>
-            <member>
-                <link linkend="read">read</link>
-            </member>
-            <member>
-                <link linkend="listvarinfile">listvarinfile</link>
-            </member>
-            <member>
-                <link linkend="save_format">save_format</link>
-            </member>
-            <member>
-                <link linkend="exec">exec</link>
-            </member>
-            <member>
-                <link linkend="mopen">mopen</link>
-            </member>
-        </simplelist>
-    </refsection>
-    <refsection>
-        <title>履歴</title>
-        <revhistory>
-            <revision>
-                <revnumber>5.0.0</revnumber>
-                <revremark>
-                    <link linkend="uimenu">uimenu</link> または <link linkend="uicontrol">uicontrol</link> ハンドルもこの関数で読み込まれます.
-                </revremark>
-            </revision>
-            <revision>
-                <revnumber>5.4.0</revnumber>
-                <revdescription>
-                    <itemizedlist>
-                        <listitem>
-                            この関数は,デフォルトでScilab 6 および SOD (Scilab 6形式)を共に
-                            読み込むことができます.
-                        </listitem>
-                        <listitem>Scilab 5.X 形式は廃止予定であり,Scilab 6で削除されます.</listitem>
-                        <listitem>ファイル記述子を最初の引数とするloadは廃止予定であり,Scilabで削除されます.
-                        </listitem>
-                    </itemizedlist>
-                </revdescription>
-            </revision>
-        </revhistory>
-    </refsection>
-</refentry>
diff --git a/scilab/modules/io/help/pt_BR/load.xml b/scilab/modules/io/help/pt_BR/load.xml
deleted file mode 100644 (file)
index bd9b801..0000000
+++ /dev/null
@@ -1,111 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) XXXX-2008 - INRIA
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * 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.
- * This file was originally licensed under the terms of the CeCILL v2.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: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="load" xml:lang="pt">
-    <refnamediv>
-        <refname>load</refname>
-        <refpurpose>carrega variável salva</refpurpose>
-    </refnamediv>
-    <refsynopsisdiv>
-        <title>Seqüência de Chamamento</title>
-        <synopsis>load(filename [,x1,...,xn])
-            load(fd [,x1,...,xn])
-        </synopsis>
-    </refsynopsisdiv>
-    <refsection>
-        <title>Parâmetros</title>
-        <variablelist>
-            <varlistentry>
-                <term>filename</term>
-                <listitem>
-                    <para>string contendo o endereço do arquivo</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>fd</term>
-                <listitem>
-                    <para>descritor de arquivo fornecido por uma chamada a mopen</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>xi</term>
-                <listitem>
-                    <para>nome(s) de variáveis Scilab arbitrárias fornecidos como
-                        strings
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>Descrição</title>
-        <para>
-            O comando <literal>load</literal> pode ser utilizado para recarregar
-            no Scilab variáveis de sessão previamente gravadas com o comando
-            <literal>save</literal>. Se o arquivo contém variáveis correspondentes a
-            manipuladores gráficos, as <link linkend="graphics_entities">graphics_entities</link> (entidades gráficas)
-            correspondentes são desenhados.
-        </para>
-        <para>
-            Desde o Scilab 5.0, todos os manipuladores <link linkend="uimenu">uimenu</link> ou <link linkend="uicontrol">uicontrol</link> também são desenhados.
-        </para>
-        <para>
-            <literal>load(filename)</literal> carrega variáveis no arquivo dado
-            pelo endereço <literal>filename</literal>.
-        </para>
-        <para>
-            <literal>load(fd)</literal> carrega variáveis no arquivo fornecido
-            pelo seu descritor <literal>fd</literal>.
-        </para>
-        <para>
-            <literal>load(filename,'x','y')</literal> ou
-            <literal>load(fd,'x','y')</literal> carrega apenas as variáveis
-            <literal>x,y</literal>.
-        </para>
-        <para>Mesmo que o formato de arquivo binário tenha mudado na versão 2.5,
-            <literal>load(filename,...)</literal> é capaz de ler formatos antigos.
-        </para>
-    </refsection>
-    <refsection>
-        <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[
-a=eye(2,2);b=ones(a);
-save('vals.dat',a,b);
-clear a
-clear b
-load('vals.dat','a','b');
- ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>Ver Também</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="save">save</link>
-            </member>
-            <member>
-                <link linkend="listvarinfile">listvarinfile</link>
-            </member>
-            <member>
-                <link linkend="save_format">save_format</link>
-            </member>
-            <member>
-                <link linkend="exec">exec</link>
-            </member>
-            <member>
-                <link linkend="mopen">mopen</link>
-            </member>
-        </simplelist>
-    </refsection>
-</refentry>