Add also the examples in core help pages in the russian help page (port of modificati... 01/9501/1
Stanislav KROTER [Tue, 23 Oct 2012 00:22:06 +0000 (06:22 +0600)]
Change-Id: Ie5b4f6579f27f06f166de3eda6e74ddeea20d05a

63 files changed:
scilab/modules/core/help/en_US/configuration/getdebuginfo.xml
scilab/modules/core/help/en_US/configuration/getmemory.xml
scilab/modules/core/help/en_US/configuration/gstacksize.xml
scilab/modules/core/help/en_US/configuration/stacksize.xml
scilab/modules/core/help/en_US/configuration/with_javasci.xml
scilab/modules/core/help/en_US/configuration/with_macros_source.xml
scilab/modules/core/help/en_US/configuration/with_module.xml
scilab/modules/core/help/en_US/configuration/with_texmacs.xml
scilab/modules/core/help/en_US/configuration/with_tk.xml
scilab/modules/core/help/en_US/control_flow/abort.xml
scilab/modules/core/help/en_US/control_flow/pause.xml
scilab/modules/core/help/en_US/control_flow/return.xml
scilab/modules/core/help/en_US/debugging/debug.xml
scilab/modules/core/help/en_US/debugging/dispbpt.xml
scilab/modules/core/help/en_US/debugging/setbpt.xml
scilab/modules/core/help/en_US/debugging/where.xml
scilab/modules/core/help/en_US/error_handling/errcatch.xml
scilab/modules/core/help/en_US/error_handling/error_table.xml
scilab/modules/core/help/en_US/error_handling/iserror.xml
scilab/modules/core/help/en_US/keywords/ans.xml
scilab/modules/core/help/en_US/keywords/end.xml
scilab/modules/core/help/en_US/keywords/slash.xml
scilab/modules/core/help/en_US/keywords/tilda.xml
scilab/modules/core/help/en_US/testmatrix.xml
scilab/modules/core/help/en_US/variables/clear.xml
scilab/modules/core/help/en_US/variables/predef.xml
scilab/modules/core/help/en_US/variables/who.xml
scilab/modules/core/help/ru_RU/configuration/getdebuginfo.xml
scilab/modules/core/help/ru_RU/configuration/getmemory.xml
scilab/modules/core/help/ru_RU/configuration/getmodules.xml
scilab/modules/core/help/ru_RU/configuration/gstacksize.xml
scilab/modules/core/help/ru_RU/configuration/stacksize.xml
scilab/modules/core/help/ru_RU/configuration/with_javasci.xml
scilab/modules/core/help/ru_RU/configuration/with_macros_source.xml
scilab/modules/core/help/ru_RU/configuration/with_module.xml
scilab/modules/core/help/ru_RU/configuration/with_texmacs.xml
scilab/modules/core/help/ru_RU/configuration/with_tk.xml
scilab/modules/core/help/ru_RU/control_flow/CHAPTER
scilab/modules/core/help/ru_RU/control_flow/abort.xml
scilab/modules/core/help/ru_RU/control_flow/pause.xml
scilab/modules/core/help/ru_RU/control_flow/return.xml
scilab/modules/core/help/ru_RU/debugging/CHAPTER
scilab/modules/core/help/ru_RU/debugging/debug.xml
scilab/modules/core/help/ru_RU/debugging/dispbpt.xml
scilab/modules/core/help/ru_RU/debugging/setbpt.xml
scilab/modules/core/help/ru_RU/debugging/where.xml
scilab/modules/core/help/ru_RU/error_handling/CHAPTER
scilab/modules/core/help/ru_RU/error_handling/errcatch.xml
scilab/modules/core/help/ru_RU/error_handling/error_table.xml
scilab/modules/core/help/ru_RU/error_handling/iserror.xml
scilab/modules/core/help/ru_RU/keywords/ans.xml
scilab/modules/core/help/ru_RU/keywords/backslash.xml
scilab/modules/core/help/ru_RU/keywords/end.xml
scilab/modules/core/help/ru_RU/keywords/less.xml
scilab/modules/core/help/ru_RU/keywords/slash.xml
scilab/modules/core/help/ru_RU/keywords/tilda.xml
scilab/modules/core/help/ru_RU/startup.xml
scilab/modules/core/help/ru_RU/testmatrix.xml
scilab/modules/core/help/ru_RU/variables/CHAPTER
scilab/modules/core/help/ru_RU/variables/clear.xml
scilab/modules/core/help/ru_RU/variables/predef.xml
scilab/modules/core/help/ru_RU/variables/predefined/CHAPTER
scilab/modules/core/help/ru_RU/variables/who.xml

index 156e8af..36dec8a 100644 (file)
@@ -8,20 +8,20 @@
         <title>Calling Sequence</title>
         <synopsis>getdebuginfo()
             dynamic_info = getdebuginfo();
-            [dynamic_info,static_info] = getdebuginfo();
+            [dynamic_info, static_info] = getdebuginfo();
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>getdebuginfo</literal> gets information about Scilab to debug.
+            <function>getdebuginfo</function> gets information about Scilab to debug.
         </para>
         <para>
-            <literal>dynamic_info = getdebuginfo();</literal> returns information about your
+            <code>dynamic_info = getdebuginfo();</code> returns information about your
             system.
         </para>
         <para>
-            <literal>[dynamic_info,static_info] = getdebuginfo();</literal> returns information
+            <code>[dynamic_info,static_info] = getdebuginfo();</code> returns information
             about your system and about Scilab.
         </para>
     </refsection>
index 6d50a26..4a4c2c0 100644 (file)
     <refsection>
         <title>Description</title>
         <para>
-            <literal>getmemory()</literal> returns free system memory  (kilo-octets).
+            <code>getmemory()</code> returns free system memory  (kilo-octets).
         </para>
         <para>
-            <literal>[free, total]=getmemory()</literal> returns free and total system memory  (kilo-octets).
+            <code>[free, total] = getmemory()</code> returns free and total system memory  (kilo-octets).
         </para>
         <para>
-            <note>Do not rely too much on this function. Due to various level of caching, free memory detection is a tricky thing under most modern operating systems.
+            <note>
+                Do not rely too much on this function. Due to various level of caching,
+                free memory detection is a tricky thing under most modern operating
+                systems.
             </note>
         </para>
     </refsection>
index e0c3e29..7b10308 100644 (file)
@@ -2,7 +2,7 @@
 <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="gstacksize">
     <refnamediv>
         <refname>gstacksize</refname>
-        <refpurpose>et/get scilab global stack size</refpurpose>
+        <refpurpose>set/get scilab global stack size</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
             Scilab stores global variables in a stack.
         </para>
         <para>
-            <literal>gstacksize(n)</literal> allows the user to increase or decrease the size of
+            <code>gstacksize(n)</code> allows the user to increase or decrease the size of
             this stack. The maximum allowed size depends on the amount of
             free memory and swap space available at the time. Note that Scilab can
             increase automatically the global stacksize when needed.
         </para>
         <para>
-            <literal>sz=gstacksize()</literal> returns a 2-vector which contains  the current
+            <code>sz=gstacksize()</code> returns a 2-vector which contains  the current
             total and used global stack size.
         </para>
         <para>
-            <literal>gstacksize('max')</literal> allows the user to increase the size of
+            <code>gstacksize('max')</code> allows the user to increase the size of
             this global stack to the maximum.
         </para>
         <para>
-            <literal>gstacksize('min')</literal> allows the user to decrease the size of
+            <code>gstacksize('min')</code> allows the user to decrease the size of
             this global stack to the minimum.
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[ 
-currentStackSize=gstacksize();
+currentStackSize = gstacksize();
 disp("Maximum stacksize: " + string(currentStackSize(1)))
 disp("Current usage: "+ string(currentStackSize(2)))
 
index f12244a..4f38fd7 100644 (file)
@@ -9,7 +9,7 @@
         <synopsis>stacksize(n)
             stacksize('max')
             stacksize('min')
-            sz=stacksize()
+            sz = stacksize()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             Scilab stores "usual" variables in a stack <literal>stk</literal> (for global variables see  <link linkend="gstacksize">gstacksize</link>).
         </para>
         <para>
-            <literal>stacksize(n)</literal> allows the user to increase or decrease the size of
+            <code>stacksize(n)</code> allows the user to increase or decrease the size of
             this stack. The maximum allowed size depends on the amount of
             free memory and swap space available at the time.
         </para>
         <para>
-            <literal>stacksize('max')</literal> allows the user to increase the size of
+            <code>stacksize('max')</code> allows the user to increase the size of
             this stack to the maximum.
         </para>
         <para>
-            <literal>stacksize('min')</literal> allows the user to decrease the size of
+            <code>stacksize('min')</code> allows the user to decrease the size of
             this stack to the minimum.
         </para>
         <para>
-            This function with the <literal>n</literal> argument can now be used everywhere.
+            This function with the <code>n</code> argument can now be used everywhere.
         </para>
         <para>
-            <literal>sz=stacksize()</literal> returns a 2-vector which contains  the current
+            <code>sz = stacksize()</code> returns a 2-vector which contains  the current
             total and used stack size.
         </para>
         <para>By default, the size of the stack is 100 000 000.</para>
@@ -60,7 +60,7 @@
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[ 
-currentStackSize=stacksize();
+currentStackSize = stacksize();
 disp("Maximum stacksize: " + string(currentStackSize(1)))
 disp("Current usage: "+ string(currentStackSize(2)))
 
index 45111f2..7417e14 100644 (file)
@@ -36,6 +36,8 @@
         <programlisting role="example"><![CDATA[ 
 if with_javasci() == %t then
    disp("javasci is available");
+else
+   disp("javasci is not available");
 end
  ]]></programlisting>
     </refsection>
index 6ab1e0b..96cfcd3 100644 (file)
@@ -6,7 +6,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>r=with_macros_source()</synopsis>
+        <synopsis>r = with_macros_source()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
index 66dba48..8245aa4 100644 (file)
@@ -8,7 +8,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>r=with_module(module_name)</synopsis>
+        <synopsis>r = with_module(module_name)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -22,7 +22,7 @@
             <varlistentry>
                 <term>module_name</term>
                 <listitem>
-                    <para>a string, for example : 'core'</para>
+                    <para>a string, for example : <literal>'core'</literal></para>
                 </listitem>
             </varlistentry>
         </variablelist>
@@ -30,7 +30,7 @@
     <refsection>
         <title>Description</title>
         <para>
-            Returns <literal>%t</literal> if a Scilab module <literal>module_name</literal> is installed or <literal>%f</literal> if not.
+            Returns <constant>%t</constant> if a Scilab module <literal>module_name</literal> is installed or <constant>%f</constant> if not.
         </para>
     </refsection>
     <refsection>
@@ -39,6 +39,8 @@
 withXML = with_module("xml");
 if withXML == %t then
    disp("XML module enabled");
+else
+   disp("XML module disabled");
 end
  ]]></programlisting>
     </refsection>
index d6d8551..d81a42c 100644 (file)
@@ -2,7 +2,7 @@
 <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="with_texmacs" xml:lang="en">
     <refnamediv>
         <refname>with_texmacs</refname>
-        <refpurpose>Checks if Scilab has been called by texmacs</refpurpose>
+        <refpurpose>Checks if Scilab has been called by texmacs. <emphasize role="bold">This function is obsolete.</emphasize> </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
@@ -23,7 +23,7 @@
         <title>Description</title>
         <para>
             Returns <literal>%t</literal> if Scilab has been called by TeXmacs
-            (required to install ATOMS module: atomsInstall('texmacs'))
+            (required to install ATOMS module: <code>atomsInstall('texmacs')</code>)
         </para>
     </refsection>
     <refsection>
@@ -40,6 +40,8 @@
         <programlisting role="example"><![CDATA[ 
 if with_texmacs() == %t then
    disp("Texmacs is available");
+else
+   disp("Texmacs is not available");
 end
  ]]></programlisting>
     </refsection>
index 5966db4..4e9d892 100644 (file)
@@ -8,7 +8,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>r=with_tk()</synopsis>
+        <synopsis>r = with_tk()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -24,8 +24,8 @@
     <refsection>
         <title>Description</title>
         <para>
-            Returns <literal>%t</literal> if Scilab has been built  with TCL/TK
-            interface or <literal>%f</literal> if not.
+            Returns <constant>%t</constant> if Scilab has been built  with TCL/TK
+            interface or <constant>%f</constant> if not.
         </para>
     </refsection>
     <refsection>
@@ -33,6 +33,8 @@
         <programlisting role="example"><![CDATA[ 
 if with_tk() == %t then
    disp("Tk is available");
+else
+   disp("Tk is not available");
 end
  ]]></programlisting>
     </refsection>
index 6514cf0..5dc3401 100644 (file)
@@ -7,8 +7,8 @@
     <refsection>
         <title>Description</title>
         <para>
-            <literal>abort</literal> interrupts current evaluation and gives the prompt. Within
-            a <literal>pause</literal> level  <literal>abort</literal> return to level 0 prompt.
+            <code>abort</code> interrupts current evaluation and gives the prompt. Within
+            a <code>pause</code> level  <code>abort</code> return to level 0 prompt.
         </para>
     </refsection>
     <refsection>
index 21ec6a2..f105f12 100644 (file)
@@ -7,32 +7,30 @@
     <refsection>
         <title>Description</title>
         <para>
-            Switch to the <literal>pause</literal> mode;
-            inserted in the code of a function, <literal>pause</literal> interrupts the execution
+            Switch to the <code>pause</code> mode;
+            inserted in the code of a function, <code>pause</code> interrupts the execution
             of the function: one receives a prompt symbol which indicates
-            the level of the <literal>pause</literal> (e.g. <literal>-1-&gt;</literal>). The user is
+            the level of the <code>pause</code> (e.g. <literal>-1-&gt;</literal>). The user is
             then in a new workspace in which all the lower-level variables
             (and in particular all the variable of the function) are available.
-            To return to the calling workspace enter <literal>"return"</literal>.
+            To return to the calling workspace enter <code>return</code>.
         </para>
         <para>
             In this mode, <literal>[...]=return(...) </literal>
             returns the variables of the argument <literal>(...)</literal> to the calling workspace with 
-            names in the output <literal> [...]</literal>. Otherwise, the lower-level variables
+            names in the output <literal>[...]</literal>. Otherwise, the lower-level variables
             are protected and cannot be modified.
         </para>
         <para>
             The <literal>pause</literal> is extremely useful for debugging purposes.
         </para>
         <para>
-            This mode is killed by the command <literal>"abort"</literal>.
+            This mode is killed by the command <code>abort</code>.
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[ 
- ]]></programlisting>
-    </refsection>
     function c=foo(b)
     a=42+b
     disp("Thanks to the pause, you can investigate if ''a'' has the right value");
@@ -42,6 +40,8 @@
     endfunction
     
     foo(2)
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
index 6e808e3..ca2bbcd 100644 (file)
     <refsection>
         <title>Description</title>
         <para>
-            In a function <literal>return</literal> stops the execution of the function,
+            In a function <code>return</code> stops the execution of the function,
             <literal>[x1,..,xn]=return(a1,..,an)</literal> stops the execution of the function and put 
-            the local variables <literal>ai</literal> in calling environment under names
-            <literal>xi</literal>.
+            the local variables <varname>ai</varname> in calling environment under names
+            <varname>xi</varname>.
         </para>
         <para>
-            In <literal>pause</literal> mode, it allows to return to upper level.
+            In <code>pause</code> mode, it allows to return to upper level.
             <literal>[x1,..,xn]=return(a1,..,an)</literal> returns to upper level and put the local 
-            variables <literal>ai</literal> in calling environment under names <literal>xi</literal>.
+            variables <varname>ai</varname> in calling environment under names <varname>xi</varname>.
         </para>
         <para>
-            In an <literal>execstr</literal> called by a function 
+            In an <code>execstr</code> called by a function
             <literal>[x1,..,xn]=return(a1,..,an)</literal> stops the execution of the function and put 
-            the local variables <literal>ai</literal> in calling environment under names 
-            <literal>xi</literal>.
+            the local variables <varname>ai</varname> in calling environment under names
+            <varname>xi</varname>.
         </para>
         <para>
-            The statement <literal>resume</literal> is equivalent to <literal>return</literal>.
+            The statement <code>resume</code> is equivalent to <code>return</code>.
         </para>
         <para>
             <note>
@@ -65,7 +65,7 @@ function foo(a)
 endfunction
 
 foo(42);
-assert_checkequal(b,43);
+assert_checkequal(b,43)
 // c does not exist
 
  ]]></programlisting>
index a6c38ca..a530910 100644 (file)
@@ -6,15 +6,15 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>debug(level-int)
-            level-int=debug()
+        <synopsis>debug(level_int)
+            level_int = debug()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
         <variablelist>
             <varlistentry>
-                <term>level-int</term>
+                <term>level_int</term>
                 <listitem>
                     <para>integer (-1 to 4)</para>
                 </listitem>
     <refsection>
         <title>Description</title>
         <para>
-            For the values 0,1,2,3,4 of <literal>level-int</literal> , <literal>debug</literal>
+            For the values 0,1,2,3,4 of <varname>level_int</varname>, <code>debug</code>
             defines various levels of debugging. This is targeted to the parser, not
             to Scilab scripts, and is for Scilab experts only.
         </para>
         <para>
-            <note>The output of this function will change with Scilab 6.0.0.
+            <note>
+                The output of this function will change with Scilab 6.0.0.
             </note>
         </para>
     </refsection>
index 6aa77f2..0dd79e6 100644 (file)
     <refsection>
         <title>Description</title>
         <para>
-            <literal>dispbpt()</literal> displays all active breakpoints
+            <code>dispbpt()</code> displays all active breakpoints
             currently inserted in functions.
         </para>
         <para>
-            The line numbers displayed by <literal>dispbpt()</literal> are
+            The line numbers displayed by <code>dispbpt()</code> are
             <emphasis>physical</emphasis> line numbers in the mentioned functions.
             Note that Scilab versions before 5.0 showed <emphasis>logical</emphasis>
             line numbers. The difference between physical and logical line numbers is
index 70786f1..315ff69 100644 (file)
     <refsection>
         <title>Description</title>
         <para>
-            <literal>setbpt</literal> interactively inserts a breakpoint in the
-            line number <literal>linenumb</literal> (default value is 1) of the
-            function <literal>macroname</literal>.
+            <function>setbpt</literal> interactively inserts a breakpoint in the
+            line number <varname>linenumb</varname> (default value is 1) of the
+            function <varname>macroname</varname>.
         </para>
         <para>
-            <literal>linenumb</literal> can be a line or column vector of line
+            <varname>linenumb</varname> can be a line or column vector of line
             numbers, or a single scalar line number.
         </para>
         <para>
-            Line numbers in <literal>linenumb</literal> are
+            Line numbers in <varname>linenumb</varname> are
             <emphasis>physical</emphasis> line numbers in function
-            <literal>macroname</literal>. Note that Scilab versions before 5.0 used
+            <varname>macroname</varname>. Note that Scilab versions before 5.0 used
             <emphasis>logical</emphasis> line numbers. The difference between physical
             and logical line numbers is the number of <emphasis>continued
                 lines
index d4e11bf..033bef7 100644 (file)
@@ -6,7 +6,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>[linenum,callername]=where()</synopsis>
+        <synopsis>[linenum, callername] = where()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>[linenum,callername]=where()</literal> returns <literal>linenum</literal> and 
-            <literal>callername</literal> such as current instruction has been
-            called by the <literal>linenum(1)</literal> line of function 
-            <literal>callername(1)</literal>, <literal>callername(1)</literal> has been called by the 
-            <literal>linenum(2)</literal> line of function <literal>callername(2)</literal>
+            <code>[linenum, callername] = where()</code> returns <varname>linenum</varname> and
+            <varname>callername</varname> such as current instruction has been
+            called by the <code>linenum(1)</code> line of function
+            <code>callername(1)</code>, <code>callername(1)</code> has been called by the
+            <code>linenum(2)</code> line of function <code>callername(2)</code>
             and so on.
         </para>
         <para>
-            <literal>callername(i)</literal> is in general the name of a function but it may also be
+            <code>callername(i)</code> is in general the name of a function but it may also be
             <literal>"exec"</literal> or <literal>"execstr"</literal> if instruction lies in an
             exec file or an execstr instruction.
         </para>
@@ -45,7 +45,7 @@
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
 function foo()
-         [a,b]=where()
+         [a,b] = where()
          disp("Line:")
          disp(a);
          disp("Function:")
index f8173ff..1e0db56 100644 (file)
     <refsection>
         <title>Description</title>
         <para>
-            <literal>errcatch</literal> gives an "action" (error-handler)  to be 
-            performed when an error of type <literal>n</literal> occurs.
+            <function>errcatch</function> gives an "action" (error-handler)  to be
+            performed when an error of type <varname>n</varname> occurs.
         </para>
         <para>
-            <literal>n</literal> has the following meanings:
+            <varname>n</varname> has the following meanings:
         </para>
         <para>
-            if <literal>n&gt;0</literal>, <literal>n</literal> is the error number to trap;
+            if <varname>n</varname><literal>&gt;0</literal>, <varname>n</varname> is the error number to trap;
         </para>
         <para>
-            if <literal>n&lt;0</literal>  all errors are to be trapped.
+            if <varname>n</varname><literal>&lt;0</literal> all errors are to be trapped.
         </para>
         <para>
-            <literal>action</literal> is one of the following character strings:
+            <varname>action</varname> is one of the following character strings:
         </para>
         <variablelist>
             <varlistentry>
                 <term>"pause"</term>
                 <listitem>
                     <para>a pause is executed when trapping the error. This option is
-                        useful for debugging purposes. Use <literal>whereami()</literal> to get information
+                        useful for debugging purposes. Use <code>whereami()</code> to get information
                         on the current context.
                     </para>
                 </listitem>
@@ -72,7 +72,7 @@
             <varlistentry>
                 <term>"kill"</term>
                 <listitem>
-                    <para>default mode, all intermediate functions are killed, scilab goes
+                    <para>default mode, all intermediate functions are killed, Scilab goes
                         back to the level 0 prompt.
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
         <para>
-            <literal>option</literal> is the character string <literal>'nomessage'</literal> for killing
+            <varname>option</varname> is the character string <literal>'nomessage'</literal> for killing
             error message.
         </para>
         <para>
-            To set back default mode, enter <literal>errcatch(-1,"kill")</literal> or similarly
-            <literal>errcatch(-1)</literal>. <literal>errcatch()</literal> is an obsolete equivalent of <literal>errcatch(-1)</literal>. 
+            To set back default mode, enter <code>errcatch(-1,"kill")</code> or similarly
+            <code>errcatch(-1)</code>. <code>errcatch()</code> is an obsolete equivalent of <code>errcatch(-1)</code>.
         </para>
         <para/>
         <para>
-            The <literal>errcatch</literal> actions apply to the current evaluation
-            context (<literal>function</literal>, <literal>exec</literal>, <literal>pause</literal>) and all the sub-levels. A  second <literal>errcatch</literal> call in a sub-level hides the initial one for this sub-level. If a second <literal>errcatch</literal> call is made at the
+            The <function>errcatch</function> actions apply to the current evaluation
+            context (<literal>function</literal>, <literal>exec</literal>, <literal>pause</literal>) and all the sub-levels. A  second <function>errcatch</function> call in a sub-level hides the initial one for this sub-level. If a second <function>errcatch</function> call is made at the
             same level, the effect of the first one is removed.
         </para>
         <para>
-            When called in the context of  a Scilab function or exec the <literal>errcatch</literal> is automatically reset  when the function returns.
+            When called in the context of  a Scilab function or exec the <function>errcatch</function> is automatically reset  when the function returns.
         </para>
     </refsection>
     <refsection>
index f78d6f5..7af76e7 100644 (file)
             name."
         </para>
         <para>
-            <note>Please avoid using this list since it might change in a future release</note>
+            <note>Please avoid using this list since it might change in a future release.</note>
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
- ]]></programlisting>
-    </refsection>
     error(43);
+    // Display "Not implemented in scilab..."
     error(42);
+    // Display "Incompatible input argument."
     lasterror()
-    // Display "Not implemented in scilab..."
+ ]]></programlisting>
+    </refsection>
     
     <refsection role="see also">
         <title>See Also</title>
index a04184b..f9f66c7 100644 (file)
     <refsection>
         <title>Description</title>
         <para>
-            Tests if error number <literal>n</literal> has occurred (after a call to
-            <literal>errcatch</literal>). <literal>iserror</literal> returns <literal>1</literal> 
+            Tests if error number <varname>n</varname> has occurred (after a call to
+            <function>errcatch</function>). <function>iserror</function> returns <literal>1</literal>
             if the error occurred and <literal>0</literal> otherwise.
         </para>
         <para>
-            <literal>n&gt;0</literal> is the error number ; all errors are tested with <literal>n&lt;0</literal>.
+            <varname>n</varname><literal>&gt;0</literal> is the error number ; all errors are tested with <varname>n</varname><literal>&lt;0</literal>.
         </para>
     </refsection>
     <refsection>
index e67ae0f..1e5912b 100644 (file)
@@ -12,7 +12,7 @@
             are not assigned. <literal>ans</literal> contains the last unassigned evaluated expression.
         </para>
         <para>
-            Variable <literal>ans</literal> is not protected by <literal>predef</literal>.
+            Variable <literal>ans</literal> is not protected by <function>predef</function>.
         </para>
     </refsection>
     <refsection>
index c9059e1..d7ba687 100644 (file)
@@ -8,7 +8,7 @@
         <title>Description</title>
         <para>
             Used at end of loops or conditionals.
-            <literal>for, while, if, select</literal> must be terminated by <literal>end</literal>.
+            <literal>for</literal>, <literal>while</literal>, <literal>if</literal>, <literal>select</literal> must be terminated by <literal>end</literal>.
         </para>
     </refsection>
     <refsection>
index 6cb3490..7cd3096 100644 (file)
@@ -7,33 +7,37 @@
     <refsection>
         <title>Description</title>
         <para>
-            Right division.  <literal>x=A / b</literal> is the solution of <literal>x*b=A</literal>.
+            Right division.  <code>x = A / b</code> is the solution of <code>x * b = A</code>.
         </para>
         <para>
-            <literal>b/a = (a' \ b')'</literal>.
+            <code>b/a = (a' \ b')'</code>.
         </para>
         <para>
-            <literal>a./  b</literal> is the matrix with entries <literal>a(i,j)/ b(i,j)</literal>.
+            <code>a ./ b</code> is the matrix with entries <literal>a(i,j)/ b(i,j)</literal>.
             If <literal>b</literal> is scalar (1x1 matrix) this operation is the same
-            as <literal> a./b*ones(a)</literal>. (Same convention if <literal>a</literal> is a scalar).
+            as <code> a ./ b * ones(a)</code>. (Same convention if <literal>a</literal> is a scalar).
         </para>
         <para>
-            Remark that <literal>123./b</literal> is interpreted as <literal>(123.)/b</literal>. In this
-            cases dot is part of the  number not of the operator.
+            <note>
+                Remark that <code>123./b</code> is interpreted as <code>(123.)/b</code>. In this
+                cases dot is part of the  number not of the operator.
+            </note>
         </para>
         <para>
             Backslash stands for left division.
         </para>
         <para>
-            System feed back.  <literal>S=G/.K</literal> evaluates  
-            <literal>S=G*(eye()+K*G)^(-1)</literal> this operator avoid simplification problem.
+            System feed back.  <code>S = G/.K</code> evaluates
+            <code>S = G*(eye() + K*G)^(-1)</code> this operator avoid simplification problem.
         </para>
         <para>
-            Remark that <literal>G/.5</literal> is interpreted as <literal>G/(.5)</literal>. In such 
-            cases dot is part of the number, not of the operator.
+            <note>
+                Remark that <code>G/.5</code> is interpreted as <code>G/(.5)</code>. In such
+                cases dot is part of the number, not of the operator.
+            </note>
         </para>
         <para>
-            Comment <literal>//</literal> comments a line i.e. lines which begin by <literal>//</literal>
+            Comment <code>//</code> comments a line i.e. lines which begin by <code>//</code>
             are ignored by the interpreter.
         </para>
     </refsection>
index 3cb4374..1e8411d 100644 (file)
@@ -22,8 +22,8 @@
     <refsection>
         <title>Description</title>
         <para>
-            <literal>~m</literal> gives the element-wise negation of the
-            elements of the boolean matrix <literal>m</literal>.
+            <code>~m</code> gives the element-wise negation of the
+            elements of the boolean matrix <code>m</code>.
         </para>
     </refsection>
     <refsection>
index 2b33900..ea30c97 100644 (file)
@@ -6,7 +6,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>[y]=testmatrix(name,n)</synopsis>
+        <synopsis>[y] = testmatrix(name, n)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -27,7 +27,7 @@
                 <term>y</term>
                 <listitem>
                     <para>
-                        <literal>n</literal> x <literal>n</literal> matrix
+                        <varname>n</varname> x <varname>n</varname> matrix
                     </para>
                 </listitem>
             </varlistentry>
@@ -43,7 +43,7 @@
                 <term>testmatrix('magi',n)</term>
                 <listitem>
                     <para>
-                        returns a magic square of size <literal>n</literal> x <literal>n</literal>.
+                        returns a magic square of size <varname>n</varname> x <varname>n</varname>.
                     </para>
                 </listitem>
             </varlistentry>
@@ -57,7 +57,7 @@
                 <term>testmatrix('hilb',n)</term>
                 <listitem>
                     <para>
-                        is the inverse of the <literal>n</literal> x <literal>n</literal> Hilbert matrix  <literal>(Hij= 1/(i+j-1))</literal>.
+                        is the inverse of the <varname>n</varname> x <varname>n</varname> Hilbert matrix  <literal>(Hij= 1/(i+j-1))</literal>.
                     </para>
                 </listitem>
             </varlistentry>
index 2d3512e..2d01795 100644 (file)
@@ -15,7 +15,7 @@
         <title>Arguments</title>
         <variablelist>
             <varlistentry>
-                <term>a,b,c...</term>
+                <term>a, b, c...</term>
                 <listitem>
                     <para>variables of any type and size, but not protected</para>
                 </listitem>
@@ -27,8 +27,8 @@
         <para>
             This command kills variables which are not protected.
             It removes the named variables from the environment.
-            By itself <literal>clear</literal> kills all the variables except the variables
-            protected by <literal>predef</literal>. Thus the two commands <literal>predef(0)</literal> and <literal>clear</literal>
+            By itself <code>clear</code> kills all the variables except the variables
+            protected by <code>predef</code>. Thus the two commands <code>predef(0)</code> and <code>clear</code>
             remove all the variables.
         </para>
         <para>
             the percent prefix.
         </para>
         <para>
-            Note the particular syntax <literal>clear a</literal> and <literal>clear('a')</literal>  
-            and not <literal>clear(a)</literal>. Note also that <literal>a=[]</literal> does not kill 
-            <literal>a</literal> but sets <literal>a</literal> to an empty matrix.
+            <note>
+                Note the particular syntax <code>clear a</code> and <code>clear('a')</code>
+                and not <code>clear(a)</code>. Note also that <code>a=[]</code> does not kill
+                <varname>a</varname> but sets <varname>a</varname> to an empty matrix.
+            </note>
         </para>
         <para>
-            The command <literal>clear</literal> can kill nonexistent variables, i. e. 
-            <literal>clear</literal> kills nonexistent variables as if they exist.
+            The command <code>clear</code> can kill nonexistent variables, i. e.
+            <code>clear</code> kills nonexistent variables as if they exist.
         </para>
     </refsection>
     <refsection>
index d102d33..71842c9 100644 (file)
         <para>
             Utility function used for defining "oldest" variables as "protected".
             Protected variables cannot be killed. They are not saved 
-            by the <literal>'save'</literal> command. The "oldest" are those appearing last in
-            the <literal>who('get')</literal>.
+            by the <function>save</function> command. The "oldest" are those appearing last in
+            the <code>who('get')</code>.
         </para>
         <para>
-            <literal>predef()</literal> gets the number of protected variables.
+            <code>predef()</code> gets the number of protected variables.
         </para>
         <para>
-            <literal>predef('a[ll]')</literal> sets all the variables protected, it also return
+            <code>predef('a[ll]')</code> sets all the variables protected, it also return
             the old and new value of protected variables number.
         </para>
         <para>
-            <literal>predef('c[lear]')</literal> unprotect all but the last 7 variables, it also return
+            <code>predef('c[lear]')</code> unprotect all but the last 7 variables, it also return
             the old and new value of protected variables number.
         </para>
         <para>
-            <literal>predef(n)</literal> sets the <literal>max(n,7)</literal> last defined variables as protected, it also return
+            <code>predef(n)</code> sets the <code>max(n,7)</code> last defined variables as protected, it also return
             the old and new value of protected variables number.
         </para>
         <para>
-            <literal>predef('names')</literal> returns a vector of strings with the name of protected variables.
+            <code>predef('names')</code> returns a vector of strings with the name of protected variables.
         </para>
         <para>
-            <literal>predef('clear')</literal> removes the predefined variables from the list.
+            <code>predef('clear')</code> removes the predefined variables from the list.
         </para>
     </refsection>
     <refsection>
         <title>Remarks</title>
         <para>
-            Variable <literal>ans</literal> created automatically when expressions are not assigned is never protected by <literal>predef('all')</literal>.
+            Variable <literal>ans</literal> created automatically when expressions are not assigned is never protected by <code>predef('all')</code>.
         </para>
         <para>
             A number of protected variables are set in the start-up file <literal>SCI/etc/scilab.start</literal>.
index 855cffd..2bed873 100644 (file)
@@ -8,32 +8,32 @@
         <title>Calling Sequence</title>
         <synopsis>who
             who()
-            names=who('local')
-            [names,mem]=who('local')
-            names=who('global')
-            [names,mem]=who('global')
+            names = who('local')
+            [names, mem] = who('local')
+            names = who('global')
+            [names, mem] = who('global')
             who('sorted')
-            names=who('local','sorted')
-            [names,mem]=who('local','sorted')
-            names=who('global','sorted')
-            [names,mem]=who('global','sorted')
+            names = who('local','sorted')
+            [names, mem] = who('local','sorted')
+            names = who('global','sorted')
+            [names, mem] = who('global','sorted')
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>who</literal> displays current variable names.
+            <code>who()</code> displays current variable names.
         </para>
         <para>
-            <literal>who('local')</literal> or <literal>who('get')</literal> returns current
+            <code>who('local')</code> or <code>who('get')</code> returns current
             variable names and memory used in double precision words.
         </para>
         <para>
-            <literal>who('global')</literal> returns global variable names and memory
+            <code>who('global')</code> returns global variable names and memory
             used in double precision words.
         </para>
         <para>
-            <literal>who('sorted')</literal> displays in alphabetical order all variables.
+            <code>who('sorted')</code> displays in alphabetical order all variables.
         </para>
     </refsection>
     <refsection>
index 5926fb2..7460c0d 100644 (file)
@@ -2,29 +2,35 @@
 <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="getdebuginfo" xml:lang="ru">
     <refnamediv>
         <refname>getdebuginfo</refname>
-        <refpurpose>получение информации о Scilab для отладки</refpurpose>
+        <refpurpose>получение информации о Scilab'e для отладки</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
         <synopsis>
             getdebuginfo()
             dynamic_info = getdebuginfo();
-            [dynamic_info,static_info] = getdebuginfo();
+            [dynamic_info, static_info] = getdebuginfo();
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>getdebuginfo</literal> получает информацию о Scilab'е для отладки.
+            <function>getdebuginfo</function> получает информацию о Scilab'е для отладки.
         </para>
         <para>
-            <literal>dynamic_info = getdebuginfo();</literal> возвращает информацию о вашей системе.
+            <code>dynamic_info = getdebuginfo();</code> возвращает информацию о вашей системе.
         </para>
         <para>
-            <literal>[dynamic_info,static_info] = getdebuginfo();</literal> возвращает информацию о 
+            <code>[dynamic_info,static_info] = getdebuginfo();</code> возвращает информацию о
             вашей системе и о Scilab'е.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+[a,b]=getdebuginfo()
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 85e84ce..c9f52b7 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>getmemory()</literal> возвращает свободную память системы (килобайты).
+            <code>getmemory()</code> возвращает свободную память системы (килобайты).
         </para>
         <para>
-            <literal>[free, total]=getmemory()</literal> возвращает свободную и общую системную память
+            <code>[free, total] = getmemory()</code> возвращает свободную и общую системную память
             (килобайты).
         </para>
+        <para>
+            <note>
+                Не слишком полагайтесь на эту функцию. Из-за различных уровней кэширования
+                обнаружение свободной памяти является непростой вещью в большинстве
+                современных операционных систем.
+            </note>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+[a,b]=getmemory()
+ ]]></programlisting>
     </refsection>
 </refentry>
index e9f9be3..27239c3 100644 (file)
@@ -3,12 +3,12 @@
     <refnamediv>
         <refname>getmodules</refname>
         <refpurpose>
-            возвращает список модулей, установленных в Scilab
+            возвращает список модулей, установленных в Scilab'е
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>res=getmodules()</synopsis>
+        <synopsis>res = getmodules()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
     </refsection>
     <refsection>
         <title>Описание</title>
-        <para>Возвращает список модулей, установленных в Scilab.</para>
+        <para>Возвращает список модулей, установленных в Scilab'е.</para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+modules=getmodules();
+find(modules=="core");
+with_module("core");
+ ]]></programlisting>
     </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
index 64b9d41..e6391eb 100644 (file)
             Scilab хранит глобальные переменные в стеке.
         </para>
         <para>
-            <literal>gstacksize(n)</literal> позволяет пользователю увеличить или уменьшить размер этого стека. Максимально разрешённый размер зависит от количества свободной памяти и размера подкачки, доступной в данный момент. Заметьте, что Scilab может автоматически увеличивать размер стека глобальных переменных в случае необходимости.
+            <code>gstacksize(n)</code> позволяет пользователю увеличить или уменьшить размер этого стека. Максимально разрешённый размер зависит от количества свободной памяти и размера подкачки, доступной в данный момент. Заметьте, что Scilab может автоматически увеличивать размер стека глобальных переменных в случае необходимости.
         </para>
         <para>
-            <literal>sz=gstacksize()</literal> возвращает двухэлементный вектор, который содержит общий и используемый размер стека глобальных переменных.
+            <code>sz=gstacksize()</code> возвращает двухэлементный вектор, который содержит общий и используемый размер стека глобальных переменных.
         </para>
         <para>
-            <literal>gstacksize('max')</literal> позволяет увеличить размер стека глобальных переменных до максимума.
+            <code>gstacksize('max')</code> позволяет увеличить размер стека глобальных переменных до максимума.
         </para>
         <para>
-            <literal>gstacksize('min')</literal> позволяет увеличить размер стека глобальных переменных до  минимума.
+            <code>gstacksize('min')</code> позволяет увеличить размер стека глобальных переменных до  минимума.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+currentStackSize = gstacksize();
+disp("Максимальный размер стека: " + string(currentStackSize(1)))
+disp("В настоящий момент используется: "+ string(currentStackSize(2)))
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index bd97376..45b25e9 100644 (file)
@@ -10,7 +10,7 @@
             stacksize(n)
             stacksize('max')
             stacksize('min')
-            sz=stacksize()
+            sz = stacksize()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             Scilab хранит "обычные" переменные в стеке <literal>stk</literal> (для глобальных переменных см.  <link linkend="gstacksize">gstacksize</link>).
         </para>
         <para>
-            <literal>stacksize(n)</literal> позволяет пользователю увеличить или уменьшить размер стека. 
+            <code>stacksize(n)</code> позволяет пользователю увеличить или уменьшить размер стека.
             Максимально допустимый размер зависит от количества свободной памяти и пространства подкачки, 
             доступных в данный момент.
         </para>
         <para>
-            <literal>stacksize('max')</literal> позволяет пользователю увеличить размер стека до 
+            <code>stacksize('max')</code> позволяет пользователю увеличить размер стека до
             максимума.
         </para>
         <para>
-            <literal>stacksize('min')</literal> позволяет пользователю уменьшить размер стека до минимума
+            <code>stacksize('min')</code> позволяет пользователю уменьшить размер стека до минимума
         </para>
         <para>
-            Эта функция с аргументом <literal>n</literal> может теперь использоваться где угодно.
+            Эта функция с аргументом <code>n</code> может теперь использоваться где угодно.
         </para>
         <para>
-            <literal>sz=stacksize()</literal> возвращает двухэлементный вектор, который содержит текущие общий размер и использованный размер стека.
+            <code>sz = stacksize()</code> возвращает двухэлементный вектор, который содержит текущие общий размер и использованный размер стека.
         </para>
         <para>
             По умолчанию размер стека равен 100 000 000.
             На 64-битных платформах максимальный размер стека имеет предел в 268 435 454.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+currentStackSize = stacksize();
+disp("Максимальный размер стека: " + string(currentStackSize(1)))
+disp("В настоящий момент используется: "+ string(currentStackSize(2)))
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index c961f6a..1d38a69 100644 (file)
             Возвращает <constant>%t</constant>, если Scilab собран с Java-интерфейсом, и
             <constant>%f</constant>, если нет.
         </para>
+        <para>
+            <note>
+                Заметьте, что эта функция всегда будет возвращать <constant>%t</constant> в GNU/Linux или Mac OS X.
+            </note>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+if with_javasci() == %t then
+   disp("javasci доступен");
+else
+   disp("javasci не доступен");
+end
+ ]]></programlisting>
     </refsection>
 </refentry>
index 2513f59..20fb0c8 100644 (file)
@@ -6,7 +6,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>r=with_macros_source()</synopsis>
+        <synopsis>r = with_macros_source()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
             <literal>%f</literal>, если нет.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+if with_macros_source() == %t then
+   disp("Исходные коды макросов Scilab''а установлены");
+end
+ ]]></programlisting>
+    </refsection>
 </refentry>
index 2f540ae..44b1e26 100644 (file)
@@ -8,7 +8,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>r=with_module(module_name)</synopsis>
+        <synopsis>r = with_module(module_name)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
@@ -22,7 +22,7 @@
             <varlistentry>
                 <term>module_name</term>
                 <listitem>
-                    <para>строковое значение, например: 'core'</para>
+                    <para>строковое значение, например: <literal>'core'</literal></para>
                 </listitem>
             </varlistentry>
         </variablelist>
     <refsection>
         <title>Описание</title>
         <para>
-            Возвращает <literal>%t</literal>, если установлен модуль Scilab'а <literal>module_name</literal>, и <literal>%f</literal>, если нет.
+            Возвращает <constant>%t</constant>, если установлен модуль Scilab'а <literal>module_name</literal>, и <constant>%f</constant>, если нет.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+withXML = with_module("xml");
+if withXML == %t then
+   disp("XML-модуль доступен");
+else
+   disp("XML-модуль не доступен");
+end
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 12d8a6a..790a976 100644 (file)
@@ -2,7 +2,7 @@
 <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="with_texmacs" xml:lang="ru">
     <refnamediv>
         <refname>with_texmacs</refname>
-        <refpurpose>проверка: вызван ли Scilab TeXmacs'ом</refpurpose>
+        <refpurpose>проверка: вызван ли Scilab TeXmacs'ом. <emphasize role="bold">Эта функция устарела.</emphasize> </refpurpose></refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
@@ -23,7 +23,7 @@
         <title>Описание</title>
         <para>
             Возвращает <literal>%t</literal>, если Scilab вызван TeXmacs'ом
-            (необходимо установить ATOMS-модуль: atomsInstall('texmacs'))
+                (необходимо установить ATOMS-модуль: <code>atomsInstall('texmacs')</code>)
         </para>
     </refsection>
     <refsection>
             </revision>
         </revhistory>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+if with_texmacs() == %t then
+   disp("Texmacs доступен");
+else
+   disp("Texmacs не доступен");
+end
+ ]]></programlisting>
+    </refsection>
 </refentry>
index e1079a8..fd6c131 100644 (file)
@@ -6,7 +6,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>r=with_tk()</synopsis>
+        <synopsis>r = with_tk()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
     <refsection>
         <title>Описание</title>
         <para>
-            Возвращает <literal>%t</literal>, если Scilab собран с TCL/TK-интерфейсом, и  
-            <literal>%f</literal>, если нет.
+            Возвращает <constant>%t</constant>, если Scilab собран с TCL/TK-интерфейсом, и
+            <constant>%f</constant>, если нет.
         </para>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+if with_tk() == %t then
+   disp("Tk доступен");
+else
+   disp("Tk не доступен");
+end
+ ]]></programlisting>
     </refsection>
 </refentry>
index 208dbe8..7c0271d 100644 (file)
@@ -1,2 +1,2 @@
-title = Control flow
+title = Управляющая логика
 xml_id = control_flow
index afd520e..d73ea29 100644 (file)
@@ -2,15 +2,24 @@
 <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="abort">
     <refnamediv>
         <refname>abort</refname>
-        <refpurpose>прерывание исполнения.  </refpurpose>
+        <refpurpose>прерывание исполнения</refpurpose>
     </refnamediv>
     <refsection>
         <title>Описание</title>
         <para>
-            Инструкция <literal>abort</literal> прерывает текущее исполнение и даёт подсказку. 
-            С того уровня, на котором вызвана <literal>pause</literal>, инструкция <literal>abort</literal> возвращает на уровень 0.
+            Инструкция <code>abort</code> прерывает текущее исполнение и даёт приглашение к вводу.
+            С того уровня, на котором вызвана <code>pause</code>, инструкция <code>abort</code> возвращает на уровень 0.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+a=2
+b=3
+abort // Здесь исполнение будет остановлено.
+c=4   // c не будет определено
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 87f3a12..2d147ac 100644 (file)
@@ -7,28 +7,42 @@
     <refsection>
         <title>Описание</title>
         <para>
-            Переключение в режим <literal>pause</literal>. Внесение функции <literal>pause</literal> в 
+            Переключение в режим <code>pause</code>. Внесение функции <code>pause</code> в
             код функции прерывает исполнение функции: появляется символ командной строки, который 
-            указывает уровень  <literal>pause</literal> (например, <literal>-1-&gt;</literal>).
+            указывает уровень  <code>pause</code> (например, <literal>-1-&gt;</literal>).
             Пользователь затем оказывается в новом рабочем окружении, в котором доступны все переменные 
             более низкого уровня (и, особенно, все переменные функции). Чтобы вернуться в вызывающее 
-            рабочее окружение, введите команду <literal>return</literal>.
+            рабочее окружение, введите команду <code>return</code>.
         </para>
         <para>
             В этом режиме<literal>[...]=return(...)</literal> возвращает переменные аргумента 
             <literal>(...)</literal> в вызывающее рабочее окружение с именами на выходе <literal> 
                 [...]
-            </literal>
-            .Таким образом, переменные более низкого уровня защищены и не могут быть 
+            </literal>.
+            Таким образом, переменные более низкого уровня защищены и не могут быть
             изменены.
         </para>
         <para>
-            Команда <literal>pause</literal> чрезвычайно полезна в процессе отладки.
+            Команда <code>pause</code> чрезвычайно полезна в процессе отладки.
         </para>
         <para>
-            Это режим прекращается командой <literal>abort</literal>.
+            Это режим прекращается командой <code>abort</code>.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+    function c=foo(b)
+    a=42+b
+    disp("Благодаря инструкции pause, вы можете исследовать - имеет ли ''a'' верное значение");
+    disp("Значение может быть, если нужно, изменено.");
+    pause
+    c=a+2
+    endfunction
+
+    foo(2)
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 1b96a5f..d52e7e5 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            В функции <literal>return</literal> прекращает исполнение функции; 
+            В функции <code>return</code> прекращает исполнение функции;
             <literal>[x1,..,xn]=return(a1,..,an)</literal> прекращает исполнение 
-            функции и выдаёт локальные переменные <literal>ai</literal> в 
-            вызывающее окружение под именами <literal>xi</literal>.
+            функции и выдаёт локальные переменные <varname>ai</varname> в
+            вызывающее окружение под именами <varname>xi</varname>.
         </para>
         <para>
-            В режиме <literal>pause</literal>, можно вернуться на более высокий уровень.
+            В режиме <code>pause</code>, можно вернуться на более высокий уровень.
             <literal>[x1,..,xn]=return(a1,..,an)</literal> возвращает на верхний уровень 
-            и передаёт локальные переменные <literal>ai</literal> под именами <literal>xi</literal>.
+            и передаёт локальные переменные <varname>ai</varname> под именами <varname>xi</varname>.
         </para>
         <para>
-            В <literal>execstr</literal>, вызванной функцией 
+            В <code>execstr</code>, вызванной функцией
             <literal>[x1,..,xn]=return(a1,..,an)</literal> 
-            прекращает исполнение функции и выдаёт локальные переменные <literal>ai</literal> 
-            в вызывающее окружение под именами <literal>xi</literal>.
+            прекращает исполнение функции и выдаёт локальные переменные <varname>ai</varname>
+            в вызывающее окружение под именами <varname>xi</varname>.
         </para>
         <para>
-            Инструкция <literal>resume</literal> эквивалентна инструкции <literal>return</literal>.
+            Инструкция <code>resume</code> эквивалентна инструкции <code>return</code>.
         </para>
+        <para>
+            <note>
+                Примечание: использование этой возможности может усложнить код. Вместо
+                этого рекомендуется использовать синтаксис <code>function b = foo()</code>.
+            </note>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+function foo(a)
+         a=a+1
+         b=resume(a)
+         c=52
+endfunction
+
+foo(42);
+assert_checkequal(b,43)
+// c не существует
+
+ ]]></programlisting>
     </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
index 0c22a9b..772755f 100644 (file)
@@ -7,15 +7,15 @@
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
         <synopsis>
-            debug(level-int)
-            level-int=debug()
+            debug(level_int)
+            level_int = debug()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
         <variablelist>
             <varlistentry>
-                <term>level-int</term>
+                <term>level_int</term>
                 <listitem>
                     <para>целое число (от -1 до 4)</para>
                 </listitem>
     <refsection>
         <title>Описание</title>
         <para>
-            Для значений <literal>level-int</literal> 0, 1, 2, 3, 4  <literal>debug</literal> 
+            Для значений <varname>level_int</varname> 0, 1, 2, 3, 4  <code>debug</code>
             определяет различные уровни отладки. Это предназначено для анализатора синтаксиса, не для 
-            файлов-сценариев Scilab, и только для экспертов Scilab.
+            файлов-сценариев Scilab'а, и только для экспертов Scilab'а.
         </para>
+        <para>
+            <note>
+                Выходное значение этой функции будет изменено в Scilab 6.0.0.
+            </note>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+debug(3);
+2+2
+//  0.200E+01
+//+
+//  0.200E+01
+// eol
+ ]]></programlisting>
+    </refsection>
+
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>
+                    Предыдущее значение возвращается в качестве выходного аргумента при установке нового значения.
+                </revremark>
+            </revision>
+        </revhistory>
     </refsection>
 </refentry>
index 3b556aa..f97d8d8 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>dispbpt()</literal> выводит на экран все активные точки останова, введённые на 
+            <code>dispbpt()</code> выводит на экран все активные точки останова, введённые на
             данный момент в функции.
         </para>
         <para>
-            Номера строк, выводимые <literal>dispbpt()</literal>, являются 
+            Номера строк, выводимые <code>dispbpt()</code>, являются
             номерами <emphasis>физических</emphasis> строк в упомянутых функциях. 
             Заметьте, что версии Scilab до 5.0 показывали номера <emphasis>логических</emphasis> 
             строк. Разность между количеством физических и логических строк равна количеству <emphasis>продолженных</emphasis> строк (см. <link linkend="dot">точка</link>).
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+setbpt('foo')
+setbpt('foo',10)
+dispbpt()
+delbpt()
+setbpt('foo',[1,2,5,6])
+dispbpt()
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index a160c44..268da45 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>setbpt</literal> интерактивно вставляет точку останова в строку с номером  
-            <literal>linenumb</literal> (по умолчанию номер 1) функции с именем 
-            <literal>macroname</literal>.
+            <function>setbpt</function> интерактивно вставляет точку останова в строку с номером
+            <varname>linenumb</varname> (по умолчанию номер 1) функции с именем
+            <varname>macroname</varname>.
         </para>
         <para>
-            <literal>linenumb</literal> может быть вектор-строкой или вектор-столбцом или скаляром, указывающим номер строки.
+            <varname>linenumb</varname> может быть вектор-строкой или вектор-столбцом или скаляром, указывающим номер строки.
         </para>
         <para>
-            Номера строк в <literal>linenumb</literal> являются номерами
-            <emphasis>физических</emphasis> строк в функции с именем <literal>macroname</literal>. 
+            Номера строк в <varname>linenumb</varname> являются номерами
+            <emphasis>физических</emphasis> строк в функции с именем <varname>macroname</varname>.
             Заметьте, что Scilab до версии 5.0 использовал номера <emphasis>логических</emphasis> строк. Разница между номерами физических и логических строк равна количеству  <emphasis>продолженных
                 строк
             </emphasis>
@@ -48,7 +48,7 @@
         <para>
             Когда достигается точка останова, Scilab выполняет определённую физическую строку и 
             останавливает ход выполнения. Если функция не компилированная (см.
-            <link linkend="comp">comp</link>), то строка выводится на экра. Затем Scilab переходит в 
+            <link linkend="comp">comp</link>), то строка выводится на экран. Затем Scilab переходит в 
             режим <link linkend="pause">pause</link>, в котором пользователь может проверить текущие 
             значения. Из режима  <link linkend="pause">pause</link> можно выйти с помощью <link linkend="resume">resume</link> или <link linkend="abort">abort</link>.
         </para>
     <refsection>
         <title>Примеры</title>
         <programlisting role="example"><![CDATA[ 
-setbpt('foo'),setbpt('foo',10),dispbpt()
+setbpt('foo')
+setbpt('foo',10)
+dispbpt()
 delbpt()
-setbpt('foo',[1,2,5,6]),dispbpt()
+setbpt('foo',[1,2,5,6])
+dispbpt()
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
index 33eb5ba..975d2fb 100644 (file)
@@ -6,7 +6,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>[linenum,mac]=where()</synopsis>
+        <synopsis>[linenum, callername] = where()</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
@@ -18,7 +18,7 @@
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>mac</term>
+                <term>callername</term>
                 <listitem>
                     <para>вектор-столбец строк</para>
                 </listitem>
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>[linenum,mac]=where()</literal> возвращает номер строки 
-            <literal>linenum</literal> и имя <literal>mac</literal> такие, что текущая инструкция 
-            была вызвана в строке <literal>linenum(1)</literal> функции
-            <literal>mac(1)</literal>, а <literal>mac(1)</literal> была вызвана в строке
-            <literal>linenum(2)</literal> функции <literal>mac(2)</literal> и так далее.
+            <code>[linenum, callername] = where()</code> возвращает такие номер строки
+            <varname>linenum</varname> и имя <varname>callername</varname>, что текущая инструкция
+            была вызвана в строке <code>linenum(1)</code> функции
+            <code>callername(1)</code>, а <code>callername(1)</code> была вызвана в строке
+            <code>linenum(2)</code> функции <code>callername(2)</code> и так далее.
         </para>
         <para>
-            <literal>mac(i)</literal> -- это, в общем, имя функции, но это может быть также 
+            <code>callername(i)</code> - это, в общем, имя функции, но это может быть также
             <literal>"exec"</literal> или <literal>"execstr"</literal>, если инструкция лежит в  
-            сценарии, исполняемом функцией <literal>exec</literal>, или строковом аргументе функции <literal>execstr</literal>.
+            сценарии, исполняемом функцией <function>exec</function>, или строковом аргументе функции <function>execstr</function>.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+function foo()
+         [a,b] = where()
+         disp("Строка:")
+         disp(a);
+         disp("Функция:")
+         disp(b);
+endfunction
+
+function bar()
+         function beer()
+                  foo()
+         endfunction
+         beer()
+endfunction
+
+bar()
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index a1d5e2a..f326634 100644 (file)
@@ -1,2 +1,2 @@
-title = Error handling
+title = Управление ошибками
 xml_id = error_handling
index 9ab5294..f0c1e6b 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>errcatch</literal> указывает действие <literal>"action"</literal> 
+            <function>errcatch</function> указывает действие <literal>"action"</literal>
             (реакцию на ошибку), которое будет выполнено в случае возникновения ошибки типа  
-            <literal>n</literal>.      
+            <varname>n</varname>.      
         </para>
         <para>
-            <literal>n</literal> имеет следующие значения: 
+            <varname>n</varname> имеет следующие значения:
         </para>
         <para>
-            если <literal>n&gt;0</literal>, то <literal>n</literal> является номером ошибки, которую 
+            если <varname>n</varname><literal>&gt;0</literal>, то <varname>n</varname> является номером ошибки, которую
             требуется перехватить;
         </para>
         <para>
-            если <literal>n&lt;0</literal>, то будут перехватываться все ошибки.
+            если <varname>n</varname><literal>&lt;0</literal>, то будут перехватываться все ошибки.
         </para>
         <para>
-            <literal>action</literal> может быть одной из следующих символьных строк:
+            <varname>action</varname> может быть одной из следующих символьных строк:
         </para>
         <variablelist>
             <varlistentry>
                 <term>"pause"</term>
                 <listitem>
                     <para>
-                        пауза, выполняемая во время перехвата ошибки. Эта опция полезна в целях отладки. Используйте <literal>whereami()</literal> для получения информации о текущем контексте.
+                        пауза, выполняемая во время перехвата ошибки. Эта опция полезна в целях отладки. Используйте <code>whereami()</code> для получения информации о текущем контексте.
                     </para>
                 </listitem>
             </varlistentry>
             </varlistentry>
         </variablelist>
         <para>
-            <literal>option</literal> символьная строка <literal>'nomessage'</literal> для уничтожения 
+            <varname>option</varname> символьная строка <literal>'nomessage'</literal> для уничтожения
             сообщения об ошибке.
         </para>
         <para>
-            Для возврата в режим по умолчанию введите  <literal>errcatch(-1,"kill")</literal> или, аналогичное, <literal>errcatch(-1)</literal>. <literal>errcatch()</literal> является устаревшим эквивалентом для <literal>errcatch(-1)</literal>. 
+            Для возврата в режим по умолчанию введите  <code>errcatch(-1,"kill")</code> или, аналогичное, <code>errcatch(-1)</code>. <code>errcatch()</code> является устаревшим эквивалентом для <code>errcatch(-1)</code>.
         </para>
         <para>
-            Действия <literal>errcatch</literal> применимы в контексте текущего выполнения 
+            Действия <function>errcatch</function> применимы в контексте текущего выполнения
             (<literal>function</literal>, <literal>exec</literal>, <literal>pause</literal>) и всех 
-            подуровней. Второй вызов <literal>errcatch</literal> на подуровнях скрывает исходный вызов 
-            для этого подуровня. Если второй вызов <literal>errcatch</literal> сделан на том же самом 
+            подуровней. Второй вызов <function>errcatch</function> на подуровнях скрывает исходный вызов
+            для этого подуровня. Если второй вызов <function>errcatch</function> сделан на том же самом
             уровне, то действие первого вызова удаляется.
         </para>
         <para>
-            При вызове в контексте функции Scilab или <literal>exec</literal> 
-            <literal>errcatch</literal> автоматически сбрасывается при выходе из функции.
+            При вызове в контексте функции Scilab или <function>exec</function>
+            <function>errcatch</function> автоматически сбрасывается при выходе из функции.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+errcatch(144,"continue")
+2/"foo"
+disp(a) // Без перехвата ошибки эта строка не будет выполнена
+
+errcatch(-1,"kill") // Возвращение обратно в нормальный режим
+errcatch(144,"pause")
+2/"foo" // Вход в режим "пауза"
+
+errcatch(27,'continue','nomessage')
+b=2/0 // Сообщения об ошибке нет, но b не будет существовать
+ ]]></programlisting>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index eba456e..79078e2 100644 (file)
         <para>278 "%s: Входные параметры должны иметь одинаковое имя формальной переменной." или "Входные параметры должны иметь одинаковое имя формальной переменной."
         </para>
         <para>279, 280: Нет сообщений</para>
+        <para>
+            <note>
+                Пожалуйста, избегайте использование этого списка, поскольку он может измениться в будущем релизе.
+            </note>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+    error(43);
+    // Вывод на экран "Не реализовано в scilab..."
+    error(42);
+    // Вывод на экран "Несовместимый входной параметр."
+    lasterror()
+ ]]></programlisting>
     </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
index 03d5ddc..0e773f3 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            Проверяет возникла ли ошибка с номером <literal>n</literal> (после вызова
-            <literal>errcatch</literal>). <literal>iserror</literal> возвращает <literal>1</literal>, 
-            если ошибка возникла, в противном случае -- <literal>0</literal>.
+            Проверяет - возникла ли ошибка с номером <varname>n</varname> (после вызова
+            <function>errcatch</function>). <function>iserror</function> возвращает <literal>1</literal>,
+            если ошибка возникла, в противном случае - <literal>0</literal>.
         </para>
         <para>
-            <literal>n&gt;0</literal> -- это номер ошибки; все ошибки проверяются с помощью <literal>n&lt;0</literal>.
+            <varname>n</varname><literal>&gt;0</literal> - это номер ошибки; все ошибки проверяются с помощью <varname>n</varname><literal>&lt;0</literal>.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+errcatch(4,'continue') // отлавливание неопределённой переменной
+unknown
+iserror() // 1
+errclear()
+iserror() // 0
+        ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 0917dd8..027b021 100644 (file)
             <literal>ans</literal> содержит результат последнего вычисленного неприсвоенного выражения.
         </para>
         <para>
-            Переменная <literal>ans</literal> не защищается с помощью <literal>predef</literal>.
+            Переменная <literal>ans</literal> не защищается с помощью <function>predef</function>.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+2+2
+ans // 4
+ans=10 // 10
+clear ans
+a=2+2;
+isdef("ans") // F
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 92b7b8e..572747f 100644 (file)
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <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="backslash">
     <refnamediv>
-        <refname>backslash (\)</refname>
+        <refname>обратный слэш (\)</refname>
         <refpurpose>(\) левое матричное деление.</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
index 3a5b93d..b8455e3 100644 (file)
@@ -8,10 +8,33 @@
         <title>Описание</title>
         <para>
             Используется в конце конструкций циклов или условий.
-            Конструкции <literal>for, while, if, select</literal> 
+            Конструкции <literal>for</literal>, <literal>while</literal>, <literal>if</literal>, <literal>select</literal> 
             должны заканчиваться ключевым словом <literal>end</literal>.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+a=42
+if a==42 then
+   disp("Ответ на все вопросы.")
+end
+
+i = 0
+while i<5
+   disp("i");
+   i = i + 1;
+end
+
+n=5;
+for i = 1:n
+    for j = 1:n
+        a(i,j) = 1/(i+j-1);
+    end;
+end
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 02d0a31..a5a2764 100644 (file)
             </varlistentry>
         </variablelist>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+(1:5)==3
+(1:5)<=4
+(1:5)<=[1 4 2 3 0]
+1<[]
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 222704a..7ac650f 100644 (file)
@@ -1,41 +1,53 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <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="slash">
     <refnamediv>
-        <refname>слэш</refname>
-        <refpurpose>(/) правое деление и обратная связь</refpurpose>
+        <refname>слэш (косая черта)</refname>
+        <refpurpose>(/) правое деление и обратная связь (комментарий)</refpurpose>
     </refnamediv>
     <refsection>
         <title>Описание</title>
         <para>
-            Правое деление.  <literal>x=A / b</literal> является решением <literal>x*b=A</literal>.
+            Правое деление.  <code>x = A / b</code> является решением <code>x * b = A</code>.
         </para>
         <para>
-            <literal>b/a = (a' \ b')'</literal>.
+            <code>b/a = (a' \ b')'</code>.
         </para>
         <para>
-            <literal>a./  b</literal> является матрицей с элементами <literal>a(i,j)/ b(i,j)</literal>.
-            Если <literal>b</literal> -- скаляр (матрица размером <literal>1x1</literal>), то эта операция то же самое, что и <literal> a./b*ones(a)</literal>. Аналогично, если скаляром является <literal>a</literal>.
+            <code>a ./ b</code> является матрицей с элементами <literal>a(i,j)/ b(i,j)</literal>.
+            Если <literal>b</literal> -- скаляр (матрица размером <literal>1x1</literal>), то эта операция то же самое, что и <code>a ./ b * ones(a)</code>. Аналогично, если скаляром является <literal>a</literal>.
         </para>
         <para>
-            Заметьте, что <literal>123./b</literal> интерпретируется как <literal>(123.)/b</literal>. 
-            В таких случаях точка является частью числа, а не оператора.
+            <note>
+                Заметьте, что <code>123./b</code> интерпретируется как <code>(123.)/b</code>.
+                В таких случаях точка является частью числа, а не оператора.
+            </note>
         </para>
         <para>
             Обратный слэш ставят для левого деления.
         </para>
         <para>
-            Обратная связь системы.  <literal>S=G/.K</literal> вычисляет 
-            <literal>S=G*(eye()+K*G)^(-1)</literal> и этот оператор избегает проблему упрощения.
+            Обратная связь системы.  <code>S = G /. K</code> вычисляет
+            <code>S = G*(eye() + K*G)^(-1)</code> и этот оператор избегает проблему упрощения.
         </para>
         <para>
-            Заметьте, что <literal>G/.5</literal> интерпретируется как <literal>G/(.5)</literal>. 
-            В таких случаях точка интерпретируется как часть числа, а не оператора.
+            <note>
+                Заметьте, что <code>G/.5</code> интерпретируется как <code>G/(.5)</code>.
+                В таких случаях точка интерпретируется как часть числа, а не оператора.
+            </note>
         </para>
         <para>
-            Комментарий <literal>//</literal> комментирует строку, т. е. строки, которые начинаются с 
-            <literal>//</literal>, игнорируются интерпретатором.
+            Комментарий <code>//</code> комментирует строку, т. е. строки, которые начинаются с
+            <code>//</code>, игнорируются интерпретатором.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+a=4 / 2; // Должно быть 2
+a=2 ./ [2,4]; //     1.    0.5
+// Комментарии - это хорошо. Они помогают понять код
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 1eb4bc9..0096abd 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>~m</literal> даёт поэлементное отрицание элементов матрицы логических значений <literal>m</literal>.
+            <code>~m</code> даёт поэлементное отрицание элементов матрицы логических значений <code>m</code>.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+a = %T
+~a == %F
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index ebd3d18..ad16999 100644 (file)
             Для того, чтобы последняя строка файла начального запуска была учтена, необходимо, чтобы файл заканчивался новой пустой строкой.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+ls(SCIHOME)
+if ls(SCIHOME+"/scilab.ini") == [] & ls(SCIHOME+"/.scilab") == []
+   disp("Ни один из файлов начального запуска не определён");
+end
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 987f5d0..a8a2299 100644 (file)
@@ -8,7 +8,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>[y]=testmatrix(name,n)</synopsis>
+        <synopsis>[y] = testmatrix(name, n)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
@@ -29,7 +29,7 @@
                 <term>y</term>
                 <listitem>
                     <para>
-                        матрица размером <literal>n</literal> x <literal>n</literal>
+                        матрица размером <varname>n</varname> на <varname>n</varname>
                     </para>
                 </listitem>
             </varlistentry>
                 <term>testmatrix('magi',n)</term>
                 <listitem>
                     <para>
-                        возвращает магический квадрат размером <literal>n</literal> x <literal>n</literal>.
+                        возвращает магический квадрат размером <varname>n</varname> на <varname>n</varname>.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>testmatrix('frk',n)</term>
                 <listitem>
-                    <para>возвращает матрицу Франка:</para>
+                    <para>возвращает матрицу Франка.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>testmatrix('hilb',n)</term>
                 <listitem>
                     <para>
-                        инверсия матрицы Гильберта размером <literal>n</literal> x <literal>n</literal>. Элементы матрицы Гильберта равны <literal>Hij= 1/(i+j-1)</literal>.
+                        инверсия матрицы Гильберта размером <varname>n</varname> на <varname>n</varname>. Элементы матрицы Гильберта равны <literal>Hij= 1/(i+j-1)</literal>.
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+testmatrix('magi',3)
+testmatrix('frk',10)
+testmatrix('hilb',4)
+ ]]></programlisting>
+    </refsection>
 </refentry>
index 099363a..03602ed 100644 (file)
         <title>Описание</title>
         <para>
             Эта команда уничтожает переменные, которые не защищены. Она удаляет
-            перечисленные переменные из окружения. Само по себе, без аргументов, <literal>clear</literal> 
+            перечисленные переменные из окружения. Само по себе, без аргументов, <code>clear</code>
             уничтожает все переменные за исключением переменных, защищённых с помощью 
-            <literal>predef</literal>. Таким образом, две команды <literal>predef(0)</literal> и 
-            <literal>clear</literal> уничтожают все переменные.
+            <code>predef</code>. Таким образом, две команды <code>predef(0)</code> и
+            <code>clear</code> уничтожают все переменные.
         </para>
         <para>
             Обычно защищёнными переменными являются стандартные библиотеки и переменные с префиксом процента.
         </para>
         <para>
-            Обратите внимание на особый синтаксис <literal>clear a b c</literal> и 
-            <literal>clear('a','b','c')</literal>, а не <literal>clear(a,b,c)</literal>. Обратите 
-            также внимание на то, что <literal>b=[]</literal> не уничтожает <literal>b</literal>, а
-            устанавливает <literal>b</literal> пустой матрицей.
+            <note>
+                Обратите внимание на особый синтаксис <code>clear a b c</code> и
+                <code>clear('a','b','c')</code>, а не <code>clear(a,b,c)</code>. Обратите
+                также внимание на то, что <code>a=[]</code> не уничтожает <varname>a</varname>, а
+                устанавливает <varname>a</varname> пустой матрицей.
+            </note>
         </para>
         <para>
-            Команда <literal>clear</literal> может работать с несуществующими переменными, т. е. 
-            <literal>clear</literal> уничтожает несуществующие переменные как если бы они существовали.
+            Команда <code>clear</code> может работать с несуществующими переменными, т. е.
+            <code>clear</code> уничтожает несуществующие переменные как если бы они существовали.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+a=2;
+b=3;
+c=4;
+clear a
+isdef("a") // F
+isdef("b") // T
+clear("b");
+isdef("b") // F
+        ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 13d9abf..89fd8e0 100644 (file)
         <para>
             Специальная функция, используемая для определения "самых старых" переменных в качестве 
             "защищённых". Защищённые переменные нельзя уничтожить. Они не сохраняются командой  
-            <literal>'save'</literal>. "Самые старые" -- это те, которые появляются в конце перечисления 
-            <literal>who('get')</literal>.
+            <function>save</function>. "Самые старые" -- это те, которые появляются в конце перечисления
+            <code>who('get')</code>.
         </para>
         <para>
-            <literal>predef()</literal> получает количество защищённых переменных.
+            <code>predef()</code> получает количество защищённых переменных.
         </para>
         <para>
-            <literal>predef('a[ll]')</literal> устанавливает все переменные защищёнными, она также 
+            <code>predef('a[ll]')</code> устанавливает все переменные защищёнными, она также
             возвращает старое и новое значение количества защищённых переменных.
         </para>
         <para>
-            <literal>predef('c[lear]')</literal> снимает защиту со всех, кроме последних 7 переменных. 
+            <code>predef('c[lear]')</code> снимает защиту со всех, кроме последних 7 переменных.
             Она также возвращает старое и новое значение количества защищённых переменных.
         </para>
         <para>
-            <literal>predef(n)</literal> устанавливает <literal>max(n,7)</literal> последних переменных в 
+            <code>predef(n)</code> устанавливает <code>max(n,7)</code> последних переменных в
             качестве защищённых. Она также возвращает старое и новое значение количества защищённых 
             переменных.
         </para>
         <para>
-            <literal>predef('names')</literal> возвращает вектор строк с именами защищённых переменных.
+            <code>predef('names')</code> возвращает вектор строк с именами защищённых переменных.
+        </para>
+        <para>
+            <code>predef('clear')</code> удаляет защищённые переменные из списка.
         </para>
     </refsection>
     <refsection>
         <title>Примечания</title>
         <para>
             Переменная <literal>ans</literal>, создаваемая автоматически, когда выражение не 
-            присваивается, никогда не защищается командой <literal>predef('all')</literal>.
+            присваивается, никогда не защищается командой <code>predef('all')</code>.
         </para>
         <para>
             Количество защищённых переменных устанавливается в файле запуска 
             <literal>SCIHOME/.scilab</literal> и <literal>SCIHOME/scilab.ini</literal>
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+errcatch(13, "continue") // Гарантируем, что мы продолжим даже когда "clear a" не сработает
+a = 1;
+predef("all");
+clear a // не работает
+predef("clear")
+clear a // работает
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 784a8f6..f0a924b 100644 (file)
@@ -9,35 +9,46 @@
         <synopsis>
             who
             who()
-            names=who('local')
-            [names,mem]=who('local')
-            names=who('global')
-            [names,mem]=who('global')
+            names = who('local')
+            [names, mem] = who('local')
+            names = who('global')
+            [names, mem] = who('global')
             who('sorted')
-            names=who('local','sorted')
-            [names,mem]=who('local','sorted')
-            names=who('global','sorted')
-            [names,mem]=who('global','sorted')
+            names = who('local','sorted')
+            [names, mem] = who('local','sorted')
+            names = who('global','sorted')
+            [names, mem] = who('global','sorted')
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>who</literal> выводит на экран имена текущих переменных.
+            <code>who()</code> выводит на экран имена текущих переменных.
         </para>
         <para>
-            <literal>who('local')</literal> или <literal>who('get')</literal> возвращает имена 
+            <code>who('local')</code> или <code>who('get')</code> возвращает имена
             текущих переменных и величину используемой памяти в количестве слов удвоенной точности.
         </para>
         <para>
-            <literal>who('global')</literal> возвращает имена глобальных переменных и величину 
+            <code>who('global')</code> возвращает имена глобальных переменных и величину
             используемой памяти в количестве слов удвоенной точности.
         </para>
         <para>
-            <literal>who('sorted')</literal> выводит на экран все переменные в алфавитном 
+            <code>who('sorted')</code> выводит на экран все переменные в алфавитном
             порядке.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+a=1;
+b=2;
+[name, mem]=who("local");
+position=find(name=="a")
+mem(position) // Размер, используемый a
+position=find(name=="d") // []
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">