Revision of help pages for module "fileio" (en_US and ru_RU). 72/8672/1
Stanislav KROTER [Sun, 12 Aug 2012 12:29:04 +0000 (18:29 +0600)]
Change-Id: I62505fe92a0491556696da7360abeff187d851ca

78 files changed:
scilab/modules/fileio/help/en_US/basename.xml
scilab/modules/fileio/help/en_US/chdir.xml
scilab/modules/fileio/help/en_US/copyfile.xml
scilab/modules/fileio/help/en_US/deletefile.xml
scilab/modules/fileio/help/en_US/dir.xml
scilab/modules/fileio/help/en_US/dirname.xml
scilab/modules/fileio/help/en_US/fileext.xml
scilab/modules/fileio/help/en_US/fileinfo.xml
scilab/modules/fileio/help/en_US/fileparts.xml
scilab/modules/fileio/help/en_US/filesep.xml
scilab/modules/fileio/help/en_US/findfiles.xml
scilab/modules/fileio/help/en_US/fprintf.xml
scilab/modules/fileio/help/en_US/fscanf.xml
scilab/modules/fileio/help/en_US/fscanfMat.xml
scilab/modules/fileio/help/en_US/fullfile.xml
scilab/modules/fileio/help/en_US/fullpath.xml
scilab/modules/fileio/help/en_US/getdrives.xml
scilab/modules/fileio/help/en_US/getlongpathname.xml
scilab/modules/fileio/help/en_US/getmd5.xml
scilab/modules/fileio/help/en_US/getrelativefilename.xml
scilab/modules/fileio/help/en_US/getshortpathname.xml
scilab/modules/fileio/help/en_US/isdir.xml
scilab/modules/fileio/help/en_US/listfiles.xml
scilab/modules/fileio/help/en_US/listvarinfile.xml
scilab/modules/fileio/help/en_US/ls.xml
scilab/modules/fileio/help/en_US/mclose.xml
scilab/modules/fileio/help/en_US/mdelete.xml
scilab/modules/fileio/help/en_US/meof.xml
scilab/modules/fileio/help/en_US/mfprintf.xml
scilab/modules/fileio/help/en_US/mget.xml
scilab/modules/fileio/help/en_US/mkdir.xml
scilab/modules/fileio/help/en_US/movefile.xml
scilab/modules/fileio/help/en_US/pathconvert.xml
scilab/modules/fileio/help/en_US/pwd.xml
scilab/modules/fileio/help/en_US/save_format.xml
scilab/modules/fileio/help/en_US/scanf.xml
scilab/modules/fileio/help/en_US/scanf_conversion.xml
scilab/modules/fileio/help/en_US/sscanf.xml
scilab/modules/fileio/help/en_US/tempname.xml
scilab/modules/fileio/help/ru_RU/basename.xml
scilab/modules/fileio/help/ru_RU/chdir.xml
scilab/modules/fileio/help/ru_RU/copyfile.xml
scilab/modules/fileio/help/ru_RU/deletefile.xml
scilab/modules/fileio/help/ru_RU/dir.xml
scilab/modules/fileio/help/ru_RU/dirname.xml
scilab/modules/fileio/help/ru_RU/dispfiles.xml
scilab/modules/fileio/help/ru_RU/fileext.xml
scilab/modules/fileio/help/ru_RU/fileinfo.xml
scilab/modules/fileio/help/ru_RU/fileparts.xml
scilab/modules/fileio/help/ru_RU/filesep.xml
scilab/modules/fileio/help/ru_RU/findfiles.xml
scilab/modules/fileio/help/ru_RU/fprintf.xml
scilab/modules/fileio/help/ru_RU/fprintfMat.xml
scilab/modules/fileio/help/ru_RU/fscanf.xml
scilab/modules/fileio/help/ru_RU/fscanfMat.xml
scilab/modules/fileio/help/ru_RU/fullfile.xml
scilab/modules/fileio/help/ru_RU/fullpath.xml
scilab/modules/fileio/help/ru_RU/getdrives.xml
scilab/modules/fileio/help/ru_RU/getlongpathname.xml
scilab/modules/fileio/help/ru_RU/getmd5.xml
scilab/modules/fileio/help/ru_RU/getrelativefilename.xml
scilab/modules/fileio/help/ru_RU/getshortpathname.xml
scilab/modules/fileio/help/ru_RU/isdir.xml
scilab/modules/fileio/help/ru_RU/listfiles.xml
scilab/modules/fileio/help/ru_RU/listvarinfile.xml
scilab/modules/fileio/help/ru_RU/ls.xml
scilab/modules/fileio/help/ru_RU/maxfiles.xml
scilab/modules/fileio/help/ru_RU/mclose.xml
scilab/modules/fileio/help/ru_RU/mdelete.xml
scilab/modules/fileio/help/ru_RU/meof.xml
scilab/modules/fileio/help/ru_RU/mfprintf.xml
scilab/modules/fileio/help/ru_RU/mget.xml
scilab/modules/fileio/help/ru_RU/mkdir.xml
scilab/modules/fileio/help/ru_RU/movefile.xml
scilab/modules/fileio/help/ru_RU/pathconvert.xml
scilab/modules/fileio/help/ru_RU/pwd.xml
scilab/modules/fileio/help/ru_RU/removedir.xml
scilab/modules/fileio/help/ru_RU/rmdir.xml

index 9462348..aeaec18 100644 (file)
@@ -55,7 +55,7 @@
       If <varname>flag</varname> is true the files are first converted to
       the target type given by the <code>getos() == 'Windows'</code> variable. Moreover,
       if <varname>flagexpand</varname> is true leading strings like
-      <varname>SCIHOME</varname>, <varname>SCI</varname> or <literal>~</literal>
+      <literal>SCIHOME</literal>, <literal>SCI</literal> or <literal>~</literal>
       are expanded using environment variables.
     </para>
   </refsection>
index 7df0216..95b8d0b 100644 (file)
@@ -1,4 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * ...
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ *
+ -->
 <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" version="5.0-subset Scilab" xml:lang="en" xml:id="chdir">
   <refnamediv>
     <refname>chdir</refname>
@@ -10,8 +22,8 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>b=chdir(path)
-      realpath=cd(path)
+    <synopsis>b = chdir(path)
+      realpath = cd(path)
       cd path
     </synopsis>
   </refsynopsisdiv>
@@ -21,7 +33,7 @@
       <varlistentry>
         <term>b</term>
         <listitem>
-          <para>a boolean  <constant>%t</constant> if <code>chdir</code> operation is ok</para>
+          <para>a boolean  <constant>%t</constant> if <function>chdir</function> operation is ok</para>
         </listitem>
       </varlistentry>
       <varlistentry>
index abd9084..1c2a645 100644 (file)
@@ -18,8 +18,8 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>copyfile(source,destination)
-      [status,message] = copyfile(source,destination)
+    <synopsis>copyfile(source, destination)
+      [status, message] = copyfile(source, destination)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
       directory <varname>source</varname> (and subdirectories) to the file or
       directory <varname>destination</varname>.
     </para>
-    <para>If source is a directory, destination can not be a file. 
-    <code>copyfile</code> replaces existing files without warning.
+    <para>If <varname>source</varname> is a directory, <varname>destination</varname> can not be a file. 
+      <warning>
+       <code>copyfile</code> replaces existing files without warning.
+      </warning>
     </para>
     <para>
-      <code>[status, message] = copyfile('source','destination')</code>
-      copies source to destination, returning the status and a message. 
+      <code>[status, message] = copyfile(source, destination)</code>
+      copies <varname>source</varname> to <varname>destination</varname>, returning the <varname>status</varname> and a <varname>message</varname>. 
     </para>
     <para>
-      Whatever the operating system, if the copy succeeds, the status is 1
-      and the message is empty; if the copy fails, the status is 0 and the
-      message is not empty.
+      Whatever the operating system, if the copy succeeds, the <varname>status</varname> is 1
+      and the <varname>message</varname> is empty; if the copy fails, the <varname>status</varname> is 0 and the
+      <varname>message</varname> is not empty.
     </para>
     <para>
       The timestamp given to the destination file is identical to that
index ceb113d..2c510ac 100644 (file)
       <varlistentry>
         <term>filename</term>
         <listitem>
-          <para>a string: a file name existing or not</para>
+          <para>a string: a file name existing or not.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>f</term>
         <listitem>
-          <para>a boolean: <constant>%t</constant> or <constant>%f</constant></para>
+          <para>a boolean: <constant>%t</constant> or <constant>%f</constant>.</para>
         </listitem>
       </varlistentry>
     </variablelist>
   </refsection>
   <refsection>
     <title>Description</title>
-    <para>This function deletes a file. If file has been deleted, it will return <constant>%t</constant> else
+    <para>This function deletes a file <varname>filename</varname>. If file <varname>filename</varname> has been deleted, it will return <constant>%t</constant> else
       <constant>%f</constant>.
     </para>
   </refsection>
index 52a0f12..fc184f6 100644 (file)
@@ -30,7 +30,7 @@
         <listitem>
           <para>a string matrix giving a directory pathname (eventually  ended
             by a pattern built with <literal>*</literal>). Default
-            value is <literal>.</literal> (a dot) 
+            value is <literal>.</literal> (a dot).
           </para>
         </listitem>
       </varlistentry>
@@ -39,7 +39,7 @@
         <listitem>
           <para>
             a <literal>tlist</literal> of type <literal>dir</literal> with fields :
-            <varname>name</varname>, <varname>date</varname>, <varname>bytes</varname> and <varname>isdir</varname>
+            <literal>name</literal>, <literal>date</literal>, <literal>bytes</literal> and <literal>isdir</literal>.
           </para>
         </listitem>
       </varlistentry>
@@ -49,7 +49,7 @@
     <title>Description</title>
     <para>
       <function>dir</function> can be used to get the files which match 
-      the patterns given by the path argument. 
+      the patterns given by the <varname>path</varname> argument. 
       Patterns are given to the Unix <command>ls</command> or to the Windows
       <command>dir</command> commands in order to get information about files. 
       Thus in order to write portable Scilab script valid wildcard patterns 
          is a valid pattern for both Unix and Windows.
     </para>
     <para>
-      The <varname>name</varname> field of the returned variable is the column vector
+      The <literal>name</literal> field of the returned variable is the column vector
       of the file names.
     </para>
     <para>
-      The <varname>date</varname> field of the returned variable is the column vector
+      The <literal>date</literal> field of the returned variable is the column vector
       of integers containing a last modification date coded in second from 1 Jan 1970.
     </para>
     <para>
-      The <varname>bytes</varname> field of the returned variable is the column vector
+      The <literal>bytes</literal> field of the returned variable is the column vector
       of integers containing the size of the files in bytes.
     </para>
     <para>
-      The <varname>isdir</varname> field of the returned variable is the column vector
+      The <literal>isdir</literal> field of the returned variable is the column vector
       of boolean true if the corresponding name is a directory.
     </para>
     <para>
index 5122b06..060616b 100644 (file)
@@ -18,7 +18,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>dirs = dirname(files[,flag [,flagexpand]])</synopsis>
+    <synopsis>dirs = dirname(files[, flag [,flagexpand]])</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Arguments</title>
@@ -54,7 +54,7 @@
       If <varname>flag</varname> is true the files are first converted to the target 
       type given by the <code>getos() == 'Windows'</code> variable. 
       Moreover, if <varname>flagexpand</varname> is true leading strings like
-      <varname>SCIHOME</varname>, <varname>SCI</varname> or <literal>~</literal> are expanded using environment
+      <literal>SCIHOME</literal>, <literal>SCI</literal> or <literal>~</literal> are expanded using environment
       variables.
     </para>
     <para>
index d833c46..6615141 100644 (file)
       <varlistentry>
         <term>fullpath</term>
         <listitem>
-          <para>a string matrix, the given file path</para>
+          <para>a string matrix, the given file path.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>extension</term>
         <listitem>
-          <para>a string matrix, the extension part is any or ''</para>
+         <para>a string matrix, the extension part is any or <literal>''</literal>.</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -40,7 +40,7 @@
   <refsection>
     <title>Description</title>
     <para>
-      <code>extension=fileext(fullpath)</code> splits the fullpath character string in the extension part including the dot.
+      <code>extension = fileext(fullpath)</code> splits the fullpath character string in the extension part including the dot.
     </para>
   </refsection>
   <refsection>
index f81b200..e0335ea 100644 (file)
@@ -17,7 +17,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>[x,ierr] = fileinfo(files)</synopsis>
+    <synopsis>[x, ierr] = fileinfo(files)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Arguments</title>
@@ -26,7 +26,7 @@
         <term>files</term>
         <listitem>
           <para>a character string or a string column vector, file
-            pathname
+            pathname.
           </para>
         </listitem>
       </varlistentry>
@@ -50,7 +50,7 @@
       <varlistentry>
         <term>ierr</term>
         <listitem>
-          <para>error indicator, 0, if no error has occurred</para>
+         <para>error indicator, 0, if no error has occurred.</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -58,7 +58,7 @@
   <refsection>
     <title>Description</title>
     <para>
-      <code>x = fileinfo(file)</code> returns
+      <code>x = fileinfo(file)</code> returns:
     </para>
     <variablelist>
       <varlistentry>
   </refsection>
   <refsection>
     <title>References</title>
-    <para>This function is an interface to the C function stat.</para>
+    <para>This function is an interface to the C function <function>stat</function>.</para>
     <para>
       Permissions are typically specified as octal numbers: <code>dec2oct(x(2))</code> to convert.
     </para>
index a2eddb1..6410cd2 100644 (file)
@@ -18,8 +18,8 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>[path,fname,extension]=fileparts(fullpath)
-      value=fileparts(fullpath,sel)
+    <synopsis>[path, fname, extension] = fileparts(fullpath)
+      value = fileparts(fullpath, sel)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
@@ -68,7 +68,7 @@
   <refsection>
     <title>Description</title>
     <para>
-      <code>[path,fname,extension]=fileparts(fullpath)</code> splits the
+      <code>[path, fname, extension] = fileparts(fullpath)</code> splits the
       <varname>fullpath</varname> character string in its three parts: the path of the
       directory pointed to, the filename part, the extension part
       including the dot.
index cf86341..65ff664 100644 (file)
@@ -33,7 +33,7 @@
   </refsection>
   <refsection>
     <title>Description</title>
-    <para>The <function>filesep</function> returns directory separator (<literal>'/'</literal> on GNU/Linux or <literal>'\'</literal> on Windows).</para>
+    <para>The <function>filesep</function> returns directory separator  (<literal>'/'</literal> on GNU/Linux or <literal>'\'</literal> on Windows).</para>
   </refsection>
   <refsection>
     <title>Examples</title>
index 68bdb82..75a4cb7 100644 (file)
@@ -21,8 +21,8 @@
   <refsynopsisdiv>
     <title>Calling Sequence</title>
     <synopsis>f = findfiles()
-      f=findfiles(path)
-      f=findfiles(path,filespec)
+      f = findfiles(path)
+      f = findfiles(path, filespec)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
index 5a084f1..9f886c9 100644 (file)
@@ -20,7 +20,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>fprintf(file,format,value_1,..,value_n)</synopsis>
+        <synopsis>fprintf(file, format, value_1, ..., value_n)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
index db98815..29024cd 100644 (file)
     <refnamediv>
         <refname>fscanf</refname>
         <refpurpose>
-            converts formatted input read on a file (<emphasis role="bold">This function is obsolete</emphasis>)
+           converts formatted input read on a file.<emphasis role="bold">This function is obsolete</emphasis>.
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>[v_1, ..., v_n]=fscanf (file, format)</synopsis>
+        <synopsis>[v_1, ..., v_n] = fscanf(file, format)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
index dc521a3..a6698cb 100644 (file)
                 <link linkend="mfscanf">mfscanf</link>
             </member>
             <member>
-                <link linkend="fscanfMat">fscanfMat</link>
-            </member>
-            <member>
                 <link linkend="mget">mget</link>
             </member>
             <member>
                 <link linkend="mputstr">mputstr</link>
             </member>
             <member>
-                <link linkend="mscanf">mscanf</link>
-            </member>
-            <member>
                 <link linkend="mseek">mseek</link>
             </member>
             <member>
index d8678a6..52c6ce6 100644 (file)
@@ -46,7 +46,7 @@
   <refsection>
     <title>Description</title>
     <para>
-      <code>f= fullfile(varargin)</code> builds a full filename taking care of platform on which it is run
+      <code>f = fullfile(varargin)</code> builds a full filename taking care of platform on which it is run
       and handling the cases when the directories begin or end with a directory separator.
     </para>
   </refsection>
index 468aeb8..3aa446f 100644 (file)
@@ -26,7 +26,7 @@
       <varlistentry>
         <term>res</term>
         <listitem>
-          <para>a string or matrix of string</para>
+          <para>a string or matrix of string.</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -34,7 +34,7 @@
       <varlistentry>
         <term>relative_path</term>
         <listitem>
-          <para>a string or a matrix of string</para>
+         <para>a string or a matrix of string.</para>
         </listitem>
       </varlistentry>
     </variablelist>
index 11074b5..71107ec 100644 (file)
@@ -26,7 +26,7 @@
       <varlistentry>
         <term>drives</term>
         <listitem>
-          <para>a matrix of strings</para>
+          <para>a matrix of strings.</para>
         </listitem>
       </varlistentry>
     </variablelist>
index f2f0dac..20919f5 100644 (file)
@@ -19,8 +19,8 @@
     <refsynopsisdiv>
         <title>Calling Sequence</title>
         <synopsis>
-            longpath=getlongpathname(shortpath)
-            [longpath,bOK]=getlongpathname(shortpath)
+            longpath = getlongpathname(shortpath)
+            [longpath, bOK] = getlongpathname(shortpath)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
@@ -42,8 +42,8 @@
                 <term>bOK</term>
                 <listitem>
                     <para>
-                        a boolean or a matrix of boolean: <literal>%T</literal> if
-                        path has been converted else <literal>%F</literal>.
+                        a boolean or a matrix of boolean: <constant>%T</constant> if
+                        path has been converted else <constant>%F</constant>.
                     </para>
                 </listitem>
             </varlistentry>
             primitive returns the specified name.
         </para>
         <para>
-            Note: If the path cannot be converted (bOK = %F) and in particular if the
+         <note>
+           Note: If the path cannot be converted (<varname>bOK</varname> is <constant>%F</constant>) and in particular if the
             operating system is not Windows, the returned long path is identical to the
             input short path.
+         </note>
         </para>
     </refsection>
     <refsection>
index 454aa11..ec2b7e5 100644 (file)
@@ -1,4 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * ...
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ *
+ -->
 <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" version="5.0-subset Scilab" xml:lang="en" xml:id="getmd5">
   <refnamediv>
     <refname>getmd5</refname>
@@ -6,8 +18,8 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>res=getmd5(filename)
-      res=getmd5(ParamString,'string')
+    <synopsis>res = getmd5(filename)
+      res = getmd5(ParamString,'string')
     </synopsis>
   </refsynopsisdiv>
   <refsection>
       <varlistentry>
         <term>res</term>
         <listitem>
-          <para>md5 result (string)</para>
+          <para>md5 result (a string)</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>filename</term>
         <listitem>
-          <para>filename (string or matrix of strings)</para>
+          <para>filename (a string or a matrix of strings)</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>ParamString</term>
         <listitem>
-          <para>string or matrix of strings</para>
+          <para>a string or a matrix of strings</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -36,7 +48,7 @@
   <refsection>
     <title>Description</title>
     <para>
-      <literal>getmd5(...)</literal> get md5 checksum of a file or a string.
+      <function>getmd5</function> get md5 checksum of a file <varname>filename</varname> or a string <varname>ParamString</varname>.
     </para>
   </refsection>
   <refsection>
index 65a7312..a53e0cf 100644 (file)
@@ -17,7 +17,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>rel_file = getrelativefilename(abs_dir,abs_file)</synopsis>
+    <synopsis>rel_file = getrelativefilename(abs_dir, abs_file)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Arguments</title>
index 4318eab..c420270 100644 (file)
@@ -19,8 +19,8 @@
     <refsynopsisdiv>
         <title>Calling Sequence</title>
         <synopsis>
-            shortpath=getshortgpathname(longpath)
-            [shortpath,bOK]=getshortpathname(longpath)
+            shortpath = getshortgpathname(longpath)
+            [shortpath, bOK] = getshortpathname(longpath)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
@@ -44,8 +44,8 @@
                 <term>bOK</term>
                 <listitem>
                     <para>
-                        a boolean or a matrix of boolean: <literal>%T</literal> if
-                        path has been converted else <literal>%F</literal>.
+                        a boolean or a matrix of boolean: <constant>%T</constant> if
+                        path has been converted else <constant>%F</constant>.
                     </para>
                 </listitem>
             </varlistentry>
             specified path <varname>longpath</varname> to its short form.
         </para>
         <para>
-            Note: If the path cannot be converted (bOK = %F) and in particular if the
+         <note>
+           Note: If the path cannot be converted (<varname>bOK</varname> is <constant>%F</constant>) and in particular if the
             operating system is not Windows, the returned short path is identical to the
             input long path.
+         </note>
         </para>
     </refsection>
     <refsection>
index a2a2035..ad3c87d 100644 (file)
@@ -18,7 +18,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>r=isdir(path)</synopsis>
+    <synopsis>r = isdir(path)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Arguments</title>
@@ -33,7 +33,7 @@
         <term>r</term>
         <listitem>
           <para>
-            a boolean: <literal>%t</literal> if <varname>path</varname> is a path to a directory.
+            a boolean: <constant>%t</constant> if <varname>path</varname> is a path to a directory.
           </para>
         </listitem>
       </varlistentry>
   <refsection>
     <title>Description</title>
     <para>
-      <code>r=isdir(path)</code> checks if <varname>path</varname> is a path to a directory.
+      <code>r = isdir(path)</code> checks if <varname>path</varname> is a path to a directory.
     </para>
   </refsection>
   <refsection>
     <title>Reference</title>
     <para>
       This function is based on the C function 
-      <function>stat</function>
-      .The <varname>SCI</varname> and <literal>~</literal> shortcuts for Scilab directory and home directory are handled.
+      <function>stat</function>. The <literal>SCI</literal> and <literal>~</literal> shortcuts for Scilab directory and home directory are handled.
     </para>
   </refsection>
   <refsection>
index 828603e..2d21d08 100644 (file)
@@ -63,7 +63,7 @@
             <varname>paths</varname> are converted according to the <code>getos() == 'Windows'</code>
             value (see also <link linkend="pathconvert">pathconvert</link>).
             Moreover, if <varname>flagexpand</varname> is true leading strings like
-            <varname>SCIHOME</varname>, <varname>SCI</varname> or
+            <literal>SCIHOME</literal>, <literal>SCI</literal> or
             <literal>~</literal> are expanded using environment variables.
         </para>
         <para>
index 1314b1f..541408c 100644 (file)
@@ -7,7 +7,7 @@
   <refsynopsisdiv>
     <title>Calling Sequence</title>
     <synopsis>listvarinfile(filename)
-      [names,typs,dims,vols]=listvarinfile(filename)
+      [names, typs, dims, vols] = listvarinfile(filename)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
index f0db681..16b0c31 100644 (file)
@@ -19,8 +19,8 @@
     <refsynopsisdiv>
         <title>Calling Sequence</title>
         <synopsis>
-            files=ls [path]
-            files=ls( [path] )
+            files = ls [path]
+            files = ls( [path] )
         </synopsis>
     </refsynopsisdiv>
     <refsection>
index b6bdc2f..f043a36 100644 (file)
@@ -19,7 +19,7 @@
   <refsynopsisdiv>
     <title>Calling Sequence</title>
     <synopsis>
-      err=mclose([fd])
+      err = mclose([fd])
       mclose('all')
     </synopsis>
   </refsynopsisdiv>
     <para>
       <code>mclose('all')</code> closes all files opened by 
       <code>file('open',..)</code> or <function>mopen</function>. 
-      <warning>
+      <caution>
         Be careful with this use of <function>mclose</function> because when 
         it is used inside a Scilab script file, it also closes the script and 
         Scilab will not execute commands written after 
         <code>mclose('all')</code>.
-      </warning>
+      </caution>
     </para>
   </refsection>
   <refsection role="see also">
index 5944fc2..869bea1 100644 (file)
  *
  -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="mdelete">
-  <refnamediv>
-    <refname>mdelete</refname>
-    <refpurpose>deletes file(s)</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <title>Calling Sequence</title>
-    <synopsis>mdelete(filename)</synopsis>
-  </refsynopsisdiv>
-  <refsection>
-    <title>Arguments</title>
-    <variablelist>
-      <varlistentry>
-        <term>filename</term>
-        <listitem>
-          <para>
-            a character string: the pathname of the file(s) to delete.
-          </para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </refsection>
-  <refsection>
-    <title>Description</title>
-    <para>
-      <function>mdelete</function> may be used to delete a file or a set of files if
-      <varname>filename</varname> contains meta-charaters.
-    </para>
-    <para>
-      <warning>
-        Note that <function>mdelete</function> does not ask for confirmation 
-        when you enter the delete command.
-        To avoid accidentally losing files, make sure that you have 
-        accurately specified the items you want deleted.
-      </warning>
-    </para>
-  </refsection>
-  <refsection role="see also">
-    <title>See Also</title>
-    <simplelist type="inline">
-      <member>
-        <link linkend="mopen">mopen</link>
-      </member>
-      <member>
-        <link linkend="mclose">mclose</link>
-      </member>
-      <member>
-        <link linkend="meof">meof</link>
-      </member>
-      <member>
-        <link linkend="mfprintf">mfprintf</link>
-      </member>
-      <member>
-        <link linkend="fprintfMat">fprintfMat</link>
-      </member>
-      <member>
-        <link linkend="mfscanf">mfscanf</link>
-      </member>
-      <member>
-        <link linkend="fscanfMat">fscanfMat</link>
-      </member>
-      <member>
-        <link linkend="mget">mget</link>
-      </member>
-      <member>
-        <link linkend="mgetstr">mgetstr</link>
-      </member>
-      <member>
-        <link linkend="mopen">mopen</link>
-      </member>
-      <member>
-        <link linkend="mprintf">mprintf</link>
-      </member>
-      <member>
-        <link linkend="mput">mput</link>
-      </member>
-      <member>
-        <link linkend="mputstr">mputstr</link>
-      </member>
-      <member>
-        <link linkend="mscanf">mscanf</link>
-      </member>
-      <member>
-        <link linkend="mseek">mseek</link>
-      </member>
-      <member>
-        <link linkend="mtell">mtell</link>
-      </member>
-    </simplelist>
-  </refsection>
+    <refnamediv>
+        <refname>mdelete</refname>
+        <refpurpose>deletes file(s)</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Calling Sequence</title>
+        <synopsis>mdelete(filename)</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Arguments</title>
+        <variablelist>
+            <varlistentry>
+                <term>filename</term>
+                <listitem>
+                    <para>
+                        a character string: the pathname of the file(s) to delete.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Description</title>
+        <para>
+            <function>mdelete</function> may be used to delete a file or a set of files if
+            <varname>filename</varname> contains meta-charaters.
+        </para>
+        <para>
+            <caution>
+                Note that <function>mdelete</function> does not ask for confirmation
+                when you enter the delete command.
+                To avoid accidentally losing files, make sure that you have
+                accurately specified the items you want deleted.
+            </caution>
+        </para>
+    </refsection>
+    <refsection role="see also">
+        <title>See Also</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="mopen">mopen</link>
+            </member>
+            <member>
+                <link linkend="mclose">mclose</link>
+            </member>
+            <member>
+                <link linkend="meof">meof</link>
+            </member>
+            <member>
+                <link linkend="mfprintf">mfprintf</link>
+            </member>
+            <member>
+                <link linkend="fprintfMat">fprintfMat</link>
+            </member>
+            <member>
+                <link linkend="mfscanf">mfscanf</link>
+            </member>
+            <member>
+                <link linkend="fscanfMat">fscanfMat</link>
+            </member>
+            <member>
+                <link linkend="mget">mget</link>
+            </member>
+            <member>
+                <link linkend="mgetstr">mgetstr</link>
+            </member>
+            <member>
+                <link linkend="mprintf">mprintf</link>
+            </member>
+            <member>
+                <link linkend="mput">mput</link>
+            </member>
+            <member>
+                <link linkend="mputstr">mputstr</link>
+            </member>
+            <member>
+                <link linkend="mscanf">mscanf</link>
+            </member>
+            <member>
+                <link linkend="mseek">mseek</link>
+            </member>
+            <member>
+                <link linkend="mtell">mtell</link>
+            </member>
+        </simplelist>
+    </refsection>
 </refentry>
index 4d988ce..f4853c9 100644 (file)
@@ -14,7 +14,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" version="5.0-subset Scilab" xml:lang="en" xml:id="meof">
   <refnamediv>
     <refname>meof</refname>
-    <refpurpose> check if end of file has been reached</refpurpose>
+    <refpurpose>checks if end of file has been reached</refpurpose>
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
@@ -56,9 +56,6 @@
         <link linkend="mclose">mclose</link>
       </member>
       <member>
-        <link linkend="meof">meof</link>
-      </member>
-      <member>
         <link linkend="mfprintf">mfprintf</link>
       </member>
       <member>
index d6c394d..0ac7702 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="windows-1251"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
@@ -18,7 +18,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-    <synopsis>mfprintf(fd,format,a1,...,an);</synopsis>
+    <synopsis>mfprintf(fd, format, a1, ..., an);</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Arguments</title>
@@ -68,7 +68,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>a1,...,an</term>
+        <term>a1, ..., an</term>
         <listitem>
           <para>
             the data to be converted and printed according to
index ff55a84..9ed5583 100644 (file)
         </para>
         <para>
             <note>
-                On Windows, default behavior is to skip byte 13 (0x0D). 
+               On Windows, default behavior is to skip byte 13 (<literal>0x0D</literal>). 
                 <function>mopen</function> should be called with the 
                 <literal>'b'</literal> option, e.g. 
-                <code>fd1=mopen(file1,'rb')</code>, so that all bytes will be read 
+                <code>fd1 = mopen(file1,'rb')</code>, so that all bytes will be read 
                 without exception.
             </note>
         </para>
index ddcc463..dc32716 100644 (file)
                     </td>
                     
                     <td>
-                        Success
                     </td>
                 </tr>
                 <tr>
                         
                     </td>
                 </tr>
-            </informaltable>
-               
+            </informaltable>                   
+        </para>
+       <para>
+            Whatever the operating system, if the creating of directory
+            succeeds, the <varname>status</varname> is 1 and the message
+            <varname>msg</varname> is empty.
         </para>
     </refsection>
     <refsection>
@@ -146,7 +150,7 @@ cd TMPDIR;
         <title>See Also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="cd">cd</link>
+                <link linkend="chdir">chdir</link>
             </member>
             <member>
                 <link linkend="dir">dir</link>
index 0ff2c71..dd0e4ed 100644 (file)
@@ -17,8 +17,8 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>movefile(source,destination)
-            [status,message] = movefile(source,destination)
+        <synopsis>movefile(source, destination)
+            [status, message] = movefile(source, destination)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
index 5cc64c0..6d2decb 100644 (file)
@@ -18,7 +18,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>paths=pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
+        <synopsis>paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
index 123a65b..72058f8 100644 (file)
@@ -7,14 +7,14 @@
     <refsynopsisdiv>
         <title>Calling Sequence</title>
         <synopsis>pwd
-            x=pwd()
+            x = pwd()
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Description</title>
         <para>
             <code>pwd</code> returns in <varname>ans</varname> the Scilab current directory.
-            <code>x=pwd()</code> returns in <varname>x</varname> the Scilab current
+            <code>x = pwd()</code> returns in <varname>x</varname> the Scilab current
             directory.
         </para>
     </refsection>
@@ -31,9 +31,6 @@ x=pwd()
             <member>
                 <link linkend="chdir">chdir</link>
             </member>
-            <member>
-                <link linkend="cd">cd</link>
-            </member>
         </simplelist>
     </refsection>
 </refentry>
index 842a222..00bb915 100644 (file)
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * ...
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ *
+ -->
 <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" version="5.0-subset Scilab" xml:id="save_format" xml:lang="en">
-    <refnamediv>
-        <refname>save_format</refname>
-        <refpurpose>format of files produced by "save"</refpurpose>
-    </refnamediv>
-    <refsection>
-        <title>Description</title>
-        <para>
-            Variables are saved by Scilab with the <link linkend="save">save</link> function in the following format:
-        </para>
-        <para>
-            each variable record is appended consecutively to the file. The variable record begins with 6 <literal>long integer</literal> holding the variable name in encoded format (see the Remarks section below), after that comes the variable type (<literal>long integer</literal>), then, depending on it, for:
-        </para>
-        <variablelist>
-            <varlistentry>
-                <term>Floating matrices (type 1)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        real/complex flag <varname>it</varname> (a <literal>long integer</literal> in {0,1}),
-                    </para>
-                    <para>
-                        data (n*m*(it+1) <literal>double</literal>s)
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Polynomials (type 2) and Size implicit indices (type 129)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        real/complex flag <varname>it</varname> (long integer in {0,1}),
-                    </para>
-                    <para>
-                        formal variable name (16 bytes),
-                    </para>
-                    <para>
-                        <varname>index_table</varname> (m*n+1 <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        data ((N-1)*(it+1) <literal>double</literal>s), where <varname>N</varname> is the 
-                        value of the last entry of the <varname>index_table</varname>.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Booleans (type 4)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        data (n*m <literal>long integer</literal>s).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Floating sparse matrices (type 5)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        real/complex_flag <varname>it</varname> (a <literal>long integer</literal> in {0,1}),
-                    </para>
-                    <para>
-                        <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>number_of_non_zero_elements_per_row</varname> (m <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        <varname>column_index_non_zero_elements</varname> (nel <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        <varname>non_zero_values</varname> (nel*(it+1) <literal>double</literal>s).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Boolean sparse matrices (type 6)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        unused <varname>it</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>number_of_non_zero_elements_per_row</varname> (m <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        <varname>column_index_non_zero_elements</varname> (nel <literal>long integer</literal>s).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Matlab sparse matrix (type 7)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        real/complex_flag <varname>it</varname> (a <literal>long integer</literal> in {0,1}),
-                    </para>
-                    <para>
-                        <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>number_of_non_zero_elements_per_column</varname> (n <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        <varname>row_index_non_zero_elements</varname> (nel <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        <varname>non_zero_values</varname> (nel*(it+1) <literal>double</literal>s).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Integer matrices (type 8)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>integer_type</varname> (a <literal>long integer</literal>): 1,2,4, or 11,12,14 for signed and unsigned 1,2,4 bytes integers,
-                    </para>
-                    <para>
-                        data (n*m bytes for <varname>integer_type</varname> 1 or 11, n*m <literal>short integer</literal>s for <varname>integer_type</varname> 2 or 12, n*m <literal>long integer</literal>s for <varname>integer_type</varname> 4 or
-                        14).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>handles (type 9)</term>
-                <listitem>
-                    <para>version (4 bytes)</para>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a byte),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a byte),
-                    </para>
-                    <para>
-                        data (m*n <varname>serialization_record</varname>s)
-                    </para>
-                    <para>
-                        A <varname>serialization_record</varname> is a flat 
-                        representation of the C data structure associated with the 
-                        corresponding graphic object. Each graphic object is defined by 
-                        a (recursive) set of properties (see the <link linkend="get">get</link> function).
-                    </para>
-                    <para>
-                        The saved <varname>serialization_record</varname> of a graphic object is structured as follow.
-                    </para>
-                    <variablelist>
-                        <varlistentry>
-                            <term>serialization_record</term>
-                            <listitem>
-                                <para>
-                                    <varname>type_length</varname> <varname>n</varname> (a byte),
-                                </para>
-                                <para>
-                                    type (n bytes, the ascii codes of the type name),
-                                </para>
-                                <para>
-                                    <varname>property_values</varname> record (variable length).
-                                </para>
-                            </listitem>
-                        </varlistentry>
-                    </variablelist>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Strings (type 10)</term>
-                <listitem>
-                    <para>
-                        <varname>row_size</varname> <varname>m</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>column_size</varname> <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>index_table</varname> (n*m+1 <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        data (N <literal>long integer</literal>s, the Scilab encoding of the characters (see <link linkend="code2str">code2str</link>), where <varname>N</varname> is the value of the last entry of the <varname>index_table</varname>.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Uncompiled functions (type 11)</term>
-                <listitem>
-                    <para>
-                        <varname>nout</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>lhs_names</varname> (6*nout <literal>long integer</literal>s, see the Remarks section below),
-                    </para>
-                    <para>
-                        <varname>nin</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>rhs_names</varname> (6*nin <literal>long integer</literal>s, see the Remarks section below),
-                    </para>
-                    <para>
-                        <varname>code_length</varname> <varname>N</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>code</varname> (N <literal>long integer</literal>s).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Compiled functions (type 13)</term>
-                <listitem>
-                    <para>
-                        <varname>nout</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>lhs_names</varname> (6*nout <literal>long integer</literal>s, see the Remarks section below),
-                    </para>
-                    <para>
-                        <varname>nin</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>rhs_names</varname> (6*nin <literal>long integer</literal>s, see the Remarks section below),
-                    </para>
-                    <para>
-                        <varname>pseudo_code_length</varname> <varname>N</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>pseudo_code</varname> (N <literal>long integer</literal>s).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Libraries (type 14)</term>
-                <listitem>
-                    <para>
-                        <varname>path_length</varname> np (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        <varname>path_name</varname> (np <literal>long integer</literal>s: the path character codes sequence, (see <link linkend="code2str">code2str</link>)),
-                    </para>
-                    <para>
-                        number of names nn (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        names (6*nn <literal>long integer</literal>s, see the Remarks section
-                        below).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Lists (type 15), tlists (type 16), mlists (type 17)</term>
-                <listitem>
-                    <para>
-                        number of fields <varname>n</varname> (a <literal>long integer</literal>),
-                    </para>
-                    <para>
-                        index (n+1 <literal>long integer</literal>s),
-                    </para>
-                    <para>
-                        <varname>variables_sequence</varname> (n variables, each one written according to its format).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Pointers (type 128)</term>
-                <listitem>
-                    <para>Not handled</para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-        <variablelist>
-            <varlistentry>
-                <term>Function pointers (type 130)</term>
-                <listitem>
-                    <para>
-                        <varname>function_ptr</varname> (a <literal>long integer</literal>, (see <link linkend="funptr">funptr</link>)),
-                    </para>
-                    <para>
-                        <varname>function_name_code</varname> (6 <literal>long integer</literal>s, see the 
-                        Remarks section below).
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>Remarks</title>
-        <para>
-            Numbers (a <literal>long interger</literal>, <literal>short integer</literal>s,  <literal>double</literal>) are stored using the 
-            little endian convention.
-        </para>
-        <para>
-            The variable names are stored as a sequence of 6 <literal>long integer</literal>s, with 
-            a specific encoding. See the <literal>cvname.f</literal> file for
-            details.
-        </para>
-    </refsection>
-    <refsection role="see also">
-        <title>See Also</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="save">save</link>
-            </member>
-            <member>
-                <link linkend="load">load</link>
-            </member>
-            <member>
-                <link linkend="listvarinfile">listvarinfile</link>
-            </member>
-            <member>
-                <link linkend="type">type</link>
-            </member>
-            <member>
-                <link linkend="typeof">typeof</link>
-            </member>
-        </simplelist>
-    </refsection>
+  <refnamediv>
+    <refname>save_format</refname>
+    <refpurpose>format of files produced by "save"</refpurpose>
+  </refnamediv>
+  <refsection>
+    <title>Description</title>
+    <para>
+      Variables are saved by Scilab with the <link linkend="save">save</link> function in the following format:
+    </para>
+    <para>
+      each variable record is appended consecutively to the file. The variable record begins with 6 long integer holding the variable name in encoded format (see the Remarks section below), after that comes the variable type (long integer), then, depending on it, for:
+    </para>
+    <variablelist>
+      <varlistentry>
+       <term>Floating matrices (type 1)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>real/complex flag <varname>it</varname> (a long integer in <literal>{0,1}</literal>),
+         </para>
+         <para>
+           data (<literal>n*m*(it+1)</literal> doubles)
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Polynomials (type 2) and Size implicit polynomial used for indexing (type 129)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           real/complex flag <varname>it</varname> (a long integer in <literal>{0,1}</literal>),
+         </para>
+         <para>
+           formal variable name (16 bytes),
+         </para>
+         <para>
+           <varname>index_table</varname> (<literal>m*n+1</literal> long integers),
+         </para>
+         <para>
+           data (<literal>(N-1)*(it+1)</literal> doubles), where <varname>N</varname> is the 
+           value of the last entry of the <varname>index_table</varname>.
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Booleans (type 4)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           data (<literal>n*m</literal> long integers).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Floating sparse matrices (type 5)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           real/complex_flag <varname>it</varname> (a long integer in <literal>{0,1}</literal>),
+         </para>
+         <para>
+           <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (a long integer),
+         </para>
+         <para>
+           <varname>number_of_non_zero_elements_per_row</varname> (<literal>m</literal> long integers),
+         </para>
+         <para>
+           <varname>column_index_non_zero_elements</varname> (<literal>nel</literal> long integers),
+         </para>
+         <para>
+           <varname>non_zero_values</varname> (<literal>nel*(it+1)</literal> doubles).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Boolean sparse matrices (type 6)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           unused <varname>it</varname> (a long integer),
+         </para>
+         <para>
+           <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (a long integer),
+           </para>
+         <para>
+           <varname>number_of_non_zero_elements_per_row</varname> (<literal>m</literal> long integers),
+         </para>
+         <para>
+           <varname>column_index_non_zero_elements</varname> (<literal>nel</literal> long integers).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Matlab sparse matrix (type 7)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           real/complex_flag <varname>it</varname> (a long integer in <literal>{0,1}</literal>),
+         </para>
+         <para>
+           <varname>total_number_of_non_zero_elements</varname> <varname>nel</varname> (a long integer),
+         </para>
+         <para>
+           <varname>number_of_non_zero_elements_per_column</varname> (<literal>n</literal> long integers),
+         </para>
+         <para>
+           <varname>row_index_non_zero_elements</varname> (<literal>nel</literal> long integers),
+         </para>
+         <para>
+           <varname>non_zero_values</varname> (<literal>nel*(it+1)</literal> doubles).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Integer matrices (type 8)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           <varname>integer_type</varname> (a long integer): 1,2,4, or 11,12,14 for signed and unsigned 1,2,4 bytes integers,
+         </para>
+         <para>
+           data (<literal>n*m</literal> bytes for <varname>integer_type</varname> 1 or 11, <literal>n*m</literal> short integers for <varname>integer_type</varname> 2 or 12, <literal>n*m</literal> long integers for <varname>integer_type</varname> 4 or
+           14).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>handles (type 9)</term>
+       <listitem>
+         <para>version (4 bytes)</para>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a byte),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a byte),
+         </para>
+         <para>data (<literal>m*n</literal> <varname>serialization_record</varname>s)</para>
+         <para>
+           A <varname>serialization_record</varname> is a flat 
+           representation of the C data structure associated with the 
+           corresponding graphic object. Each graphic object is defined by 
+           a (recursive) set of properties (see the <link linkend="get">get</link> function).
+         </para>
+         <para>
+           The saved <varname>serialization_record</varname> of a graphic object is structured as follow.
+         </para>
+         <variablelist>
+           <varlistentry>
+             <term>serialization_record</term>
+             <listitem>
+               <para>
+                 <varname>type_length</varname> <varname>n</varname> (a byte),
+               </para>
+               <para>
+                 <varname>type</varname> (<literal>n</literal> bytes, the ascii codes of the type name),
+               </para>
+               <para>
+                 <varname>property_values</varname> record (variable length).
+               </para>
+             </listitem>
+           </varlistentry>
+         </variablelist>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Strings (type 10)</term>
+       <listitem>
+         <para>
+           <varname>row_size</varname> <varname>m</varname> (a long integer),
+         </para>
+         <para>
+           <varname>column_size</varname> <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           <varname>index_table</varname> (<literal>n*m+1</literal> long integers),
+         </para>
+         <para>
+           data (<literal>N</literal> long integers, the Scilab encoding of the characters (see <link linkend="code2str">code2str</link>), where <literal>N</literal> is the value of the last entry of the <varname>index_table</varname>.
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Uncompiled functions (type 11)</term>
+       <listitem>
+         <para>
+           <varname>nout</varname> (a long integer),
+         </para>
+         <para>
+           <varname>lhs_names</varname> (<literal>6*nout</literal> long integers, see the Remarks section below),
+         </para>
+         <para>
+           <varname>nin</varname> (a long integer),
+         </para>
+         <para>
+           <varname>rhs_names</varname> (<literal>6*nin</literal> long integers, see the Remarks section below),
+         </para>
+         <para>
+           <varname>code_length</varname> <varname>N</varname> (a long integer),
+         </para>
+         <para>
+           <varname>code</varname> (<literal>N</literal> long integers).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Compiled functions (type 13)</term>
+       <listitem>
+         <para>
+           <varname>nout</varname> (a long integer),
+         </para>
+         <para>
+           <varname>lhs_names</varname> (<literal>6*nout</literal> long integers, see the Remarks section below),
+         </para>
+         <para>
+           <varname>nin</varname> (a long integer),
+         </para>
+         <para>
+           <varname>rhs_names</varname> (<literal>6*nin</literal> long integers, see the Remarks section below),
+         </para>
+         <para>
+           <varname>pseudo_code_length</varname> <varname>N</varname> (a long integer),
+         </para>
+         <para>
+           <varname>pseudo_code</varname> (<literal>N</literal> long integers).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Libraries (type 14)</term>
+       <listitem>
+         <para>
+           <varname>path_length</varname> <varname>np</varname> (a long integer),
+         </para>
+         <para>
+           <varname>path_name</varname> (<literal>np</literal> long integers: the path character codes sequence, (see <link linkend="code2str">code2str</link>)),
+         </para>
+         <para>
+           number of names <varname>nn</varname> (a long integer),
+         </para>
+         <para>
+           names (<literal>6*nn</literal> long integers, see the Remarks section
+           below).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Lists (type 15), tlists (type 16), mlists (type 17)</term>
+       <listitem>
+         <para>
+           number of fields <varname>n</varname> (a long integer),
+         </para>
+         <para>
+           index (<literal>n+1</literal> long integers),
+         </para>
+         <para>
+           <varname>variables_sequence</varname> (<literal>n</literal> variables, each one written according to its format).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Pointers (type 128)</term>
+       <listitem>
+         <para>Not handled</para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+       <term>Function pointers (type 130)</term>
+       <listitem>
+         <para>
+           <varname>function_ptr</varname> (a long integer, (see <link linkend="funptr">funptr</link>)),
+         </para>
+         <para>
+           <varname>function_name_code</varname> (6 long integers, see the 
+           Remarks section below).
+         </para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsection>
+  <refsection>
+    <title>Remarks</title>
+    <para>
+      Numbers (a long interger, a short integer, a double) are stored using the little endian convention.
+    </para>
+    <para>
+      The variable names are stored as a sequence of 6 long integers, with 
+      a specific encoding. See the <literal>cvname.f</literal> file for
+      details.
+    </para>
+  </refsection>
+  <refsection role="see also">
+    <title>See Also</title>
+    <simplelist type="inline">
+      <member>
+       <link linkend="save">save</link>
+      </member>
+      <member>
+       <link linkend="load">load</link>
+      </member>
+      <member>
+       <link linkend="listvarinfile">listvarinfile</link>
+      </member>
+      <member>
+       <link linkend="type">type</link>
+      </member>
+      <member>
+       <link linkend="typeof">typeof</link>
+      </member>
+    </simplelist>
+  </refsection>
 </refentry>
index b687573..712e5c3 100644 (file)
@@ -18,7 +18,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>[v_1, ..., v_n]=scanf(format);</synopsis>
+        <synopsis>[v_1, ..., v_n] = scanf(format);</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
@@ -26,7 +26,7 @@
             <varlistentry>
                 <term>format</term>
                 <listitem>
-                    <para>specifies the format conversion.</para>
+                    <para>a character string: specifies the format conversion.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
@@ -40,7 +40,7 @@
     <refsection>
         <title>Description</title>
         <para>
-            The <function>scanf</function> function get character data on standard input (<code>%io(1)</code>), interprets it according
+            The <function>scanf</function> function gets character data on standard input (<code>%io(1)</code>), interprets it according
             to a <varname>format</varname>, and returns the converted results <varname>v_1</varname>, ..., <varname>v_n</varname>.
         </para>
         <para>
index f194a2c..51a7e90 100644 (file)
                         </listitem>
                         <listitem>
                             <para>
-                                It can be an exponential value, containing a decimal point followed by an exponent field, which consists of an <literal>E</literal> or an <literal>e</literal> followed by an (optionally signed) integer;
+                                it can be an exponential value, containing a decimal point followed by an exponent field, which consists of an <literal>E</literal> or an <literal>e</literal> followed by an (optionally signed) integer;
                             </para>
                         </listitem>
                         <listitem>
index 5e7c670..84d0cbd 100644 (file)
     <refnamediv>
         <refname>sscanf</refname>
         <refpurpose>
-            converts formatted input given by a string (<emphasis role="bold">this function is obsolete)</emphasis>
+            converts formatted input given by a string. <emphasis role="bold">This function is obsolete</emphasis>.
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>[v_1, ..., v_n]=sscanf(string, format)</synopsis>
+        <synopsis>[v_1, ..., v_n] = sscanf(string, format)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
     <refsection>
         <title>Description</title>
         <para>
-            <warning>
+            <caution>
                 This function is obsolete, use preferably the 
                 <function>msscanf</function> function which is more efficient and 
                 is more compatible with the C <function>sscanf</function> 
                 procedure.
-            </warning>
+            </caution>
         </para>
         <para>
             The <function>sscanf</function> function interprets character string  
index 5244bb6..50962f0 100644 (file)
@@ -13,7 +13,9 @@
 <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" version="5.0-subset Scilab" xml:lang="en" xml:id="tempname">
     <refnamediv>
         <refname>tempname</refname>
-        <refpurpose>unique name for temporary file</refpurpose>
+        <refpurpose>
+         creates a file with an unique filename
+       </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
@@ -43,8 +45,8 @@
     <refsection>
         <title>Description</title>
         <para>
-            The <function>tempname</function> creates a file with a unique 
-            filename in the <varname>TMPDIR</varname> directory.
+            The <function>tempname</function> creates a file with an unique 
+            filename in the <literal>TMPDIR</literal> directory.
         </para>
         <para>
             <code>tmp_name = tempname()</code> returns an unique string, 
@@ -65,7 +67,7 @@
         <revhistory>
             <revision>
                 <revnumber>5.4.0</revnumber>
-                <revremark>Function tempname introduced.</revremark>
+               <revremark>Function <function>tempname</function> introduced.</revremark>
             </revision>
         </revhistory>
     </refsection>
index e11370d..21cd313 100644 (file)
@@ -62,7 +62,7 @@
       Если <varname>flag</varname> равен ИСТИНЕ, то файлы <varname>files</varname> сначала преобразуются
       в целевой тип, указанный переменной <code>getos() == 'Windows'</code>.
       Более того, если <varname>flagexpand</varname> равен ИСТИНЕ, то первые
-      строковые значение, такие, как <varname>SCIHOME</varname>, <varname>SCI</varname>
+      строковые значение, такие, как <literal>SCIHOME</literal>, <literal>SCI</literal>
       или <literal>~</literal> разворачиваются с помощью переменных окружения.
     </para>
   </refsection>
index 65dcaff..d4bc722 100644 (file)
@@ -1,4 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * ...
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ *
+ -->
 <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" version="5.0-subset Scilab" xml:lang="ru" xml:id="chdir">
   <info>
     <pubdate>$LastChangedDate$</pubdate>
@@ -25,7 +37,7 @@
         <term>b</term>
         <listitem>
           <para>
-           логическое значение: <constant>%t</constant>, если операция <code>chdir</code> завершилась успешно
+           логическое значение: <constant>%t</constant>, если работа <function>chdir</function> завершилась успешно
          </para>
         </listitem>
       </varlistentry>
@@ -44,7 +56,7 @@
           </para>
         </listitem>
       </varlistentry>
-xs    </variablelist>
+     </variablelist>
   </refsection>
   <refsection>
     <title>Описание</title>
index 8865635..ef2c0e2 100644 (file)
@@ -22,8 +22,8 @@
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
     <synopsis>
-      copyfile(source,destination)
-      [status,message] = copyfile(source,destination)
+      copyfile(source, destination)
+      [status, message] = copyfile(source, destination)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
   <refsection>
     <title>Описание</title>
     <para>
-      <code>copyfile(source,destination)</code> копирует файл или
+      <code>copyfile(source, destination)</code> копирует файл или
       директорию <varname>source</varname> в файл или директорию
       <varname>destination</varname> (и поддиректории).
     </para>
     <para>
       Если источник является директорией, то назначение не может быть файлом.
-      <code>copyfile</code> замещает существующие файлы без предупреждения.
+      <warning>
+       <code>copyfile</code> замещает существующие файлы без предупреждения.
+      </warning>
     </para>
     <para>
       <code>[status, message] = copyfile(source,destination)</code>
@@ -65,7 +67,7 @@
     </para>
     <para>
       Для любой операционной системы, если копирование завершилось успешно, то
-      статус равен 1, а сообщение пустое; если же копирование завершилось неудачно, то статус равен 0 и сообщение не пустое.
+      статус <varname>status</varname> равен 1, а сообщение <varname>message</varname> пустое; если же копирование завершилось неудачно, то статус <varname>status</varname> равен 0 и сообщение <varname>message</varname> не пустое.
     </para>
     <para>
       Временная отметка у файла назначения такая же, как временная отметка исходного файла.
index aa52ada..e390e67 100644 (file)
@@ -41,7 +41,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      Эта функция удаляет файл. Если файл удалён, то она возвращает
+      Эта функция удаляет файл <varname>filename</varname>. Если файл <varname>filename</varname> удалён, то она возвращает
       <constant>%t</constant>, а иначе <constant>%f</constant>.
     </para>
   </refsection>
index 089c762..9ef8843 100644 (file)
@@ -41,7 +41,7 @@
           <para>
             типизированный список <literal>tlist</literal> типа
             <literal>dir</literal> с полями:
-            <varname>name</varname>, <varname>date</varname>, <varname>bytes</varname> и <varname>isdir</varname>.
+            <literal>name</literal>, <literal>date</literal>, <literal>bytes</literal> и <literal>isdir</literal>.
           </para>
         </listitem>
       </varlistentry>
       корректным шаблоном как для Unix, так и для Windows.
     </para>
     <para>
-      Поле <varname>name</varname> возвращаемой переменной является
+      Поле <literal>name</literal> возвращаемой переменной является
       вектор-столбцом имён файлов.
     </para>
     <para>
-      Поле <varname>date</varname> возвращаемой переменной является вектор-столбцом
+      Поле <literal>date</literal> возвращаемой переменной является вектор-столбцом
       целых чисел, содержащих дату последней модификации, кодированную
       в секундах от 1 Янв 1970.
     </para>
     <para>
-      Поле <varname>bytes</varname> возвращаемой переменной является вектор-столбцом
+      Поле <literal>bytes</literal> возвращаемой переменной является вектор-столбцом
       целых чисел, содержащих размер файлов в байтах.
     </para>
     <para>
-      Поле <varname>isdir</varname> возвращаемой переменной является вектор-столбцом
+      Поле <literal>isdir</literal> возвращаемой переменной является вектор-столбцом
       логического значения ИСТИНА, если соответствующее имя расположено в директории.
     </para>
     <para>
index 6019a84..ab92c87 100644 (file)
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="ru" xml:id="dirname">
   <refnamediv>
     <refname>dirname</refname>
-    <refpurpose>получает имя директори из имён файлов</refpurpose>
+    <refpurpose>получает имя директории из имён файлов</refpurpose>
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>dirs = dirname(files[,flag [,flagexpand]])</synopsis>
+    <synopsis>dirs = dirname(files[, flag [,flagexpand]])</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
@@ -48,7 +48,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      <function>dirname</function> возвращает имя директории из файлов,
+      Функция <function>dirname</function> возвращает имя директории из файлов,
       указанных в <varname>files</varname>.
     </para>
     <para>
@@ -56,7 +56,7 @@
       преобразуются в целевой тип, указанный переменной
       <code>getos() == 'Windows'</code>. Более того, если
       <varname>flagexpand</varname> равен ИСТИНЕ, то начальные строки,
-      такие как <varname>SCIHOME</varname>, <varname>SCI</varname> или
+      такие как <literal>SCIHOME</literal>, <literal>SCI</literal> или
       <literal>~</literal> расширяются с помощью переменных среды.
     </para>
     <para>
index fc89d98..26bf449 100644 (file)
@@ -37,8 +37,8 @@
   <refsection>
     <title>Описание</title>
     <para>
-      <function>dispfiles</function> выводит на экран свойства файлов, открытых
-      на данный момент.
+      Функция <function>dispfiles</function> выводит на экран свойства файлов, 
+      открытых на данный момент.
     </para>
   </refsection>
   <refsection>
index c475276..2cdfb39 100644 (file)
       <varlistentry>
         <term>fullpath</term>
         <listitem>
-          <para>строковая матрица, указывающая путь до файла</para>
+          <para>строковая матрица, указывающая путь до файла.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>extension</term>
         <listitem>
           <para>строковая матрица, часть, относящаяся к расширению;
-          может быть любой или ''</para>
+          может быть любой или <literal>''</literal>.</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -41,7 +41,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      <code>extension=fileext(fullpath)</code> изымает из
+      <code>extension = fileext(fullpath)</code> изымает из
       символьной строки часть, относящуюся к расширению, включая точку.
     </para>
   </refsection>
index 5b20154..9f74d34 100644 (file)
@@ -53,7 +53,7 @@
         <term>ierr</term>
         <listitem>
           <para>
-            указатель ошибки, 0, если ошибки не произошло
+            указатель ошибки, 0, если ошибки не произошло.
           </para>
         </listitem>
       </varlistentry>
@@ -74,7 +74,7 @@
       <varlistentry>
         <term>x(2)</term>
         <listitem>
-          <para>Режимный код файла (деситичное значение)</para>
+          <para>Режимный код файла (десятичное значение)</para>
         </listitem>
       </varlistentry>
       <varlistentry>
   </refsection>
   <refsection>
     <title>Ссылки</title>
-    <para>Эта функция является интерфейсом к C-функции stat.</para>
+    <para>Эта функция является интерфейсом к C-функции <function>stat</function>.</para>
     <para>
-      Права обычно определяются в виде восмеричных чисел: используйте
+      Права обычно определяются в виде восьмеричных чисел: используйте
       для преобразования <code>dec2oct(x(2))</code>.
     </para>
     <para>
index 164d7fe..02af1c9 100644 (file)
@@ -18,8 +18,8 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>[path,fname,extension]=fileparts(fullpath)
-      value=fileparts(fullpath,sel)
+    <synopsis>[path, fname, extension] = fileparts(fullpath)
+      value = fileparts(fullpath, sel)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
@@ -36,7 +36,7 @@
         <listitem>
           <para>
             необязательная символьная строка: выбор с возможными значениями:
-            <literal>'path'</literal>, <literal>'fname'</literal> or <literal>'extension'</literal>
+            <literal>'path'</literal>, <literal>'fname'</literal> или <literal>'extension'</literal>
           </para>
         </listitem>
       </varlistentry>
@@ -50,8 +50,8 @@
         <term>fname</term>
         <listitem>
           <para>
-            символьная строка; часть, относящаяся к имени файла,
-          может быть любой или <literal>''</literal>.
+            символьная строка; часть, относящаяся к имени файла, может быть 
+           любой или <literal>''</literal>.
           </para>
         </listitem>
       </varlistentry>
   <refsection>
     <title>Описание</title>
     <para>
-      <code>[path,fname,extension]=fileparts(fullpath)</code> разделяет
-      символьную строку <varname>fullpath</varname> на три части:
-         часть, относящуюся к пути до директории, часть, относящуюся к
-         имени файла и часть, относящуюся к расширению, включая точку.
+      <code>[path, fname, extension] = fileparts(fullpath)</code> разделяет
+      символьную строку <varname>fullpath</varname> на три части: часть, 
+      относящуюся к пути до директории, часть, относящуюся к имени файла и 
+      часть, относящуюся к расширению, включая точку.
     </para>
   </refsection>
   <refsection>
index 5f9dc07..61eec1e 100644 (file)
@@ -34,7 +34,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      Функция <function>filesep</function> возвращает разделитель директорий(<literal>'/'</literal> в GNU/Linux или <literal>'\'</literal> в Windows).
+      Функция <function>filesep</function> возвращает разделитель директорий (<literal>'/'</literal> в GNU/Linux или <literal>'\'</literal> в Windows).
     </para>
   </refsection>
   <refsection>
index 86737d7..e732218 100644 (file)
@@ -21,8 +21,8 @@
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
     <synopsis>f = findfiles()
-      f=findfiles(path)
-      f=findfiles(path,filespec)
+      f = findfiles(path)
+      f = findfiles(path,filespec)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
index b8cb1cd..c5df2c1 100644 (file)
@@ -22,7 +22,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>fprintf(file,format,value_1,..,value_n)</synopsis>
+    <synopsis>fprintf(file, format, value_1,..., value_n)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
index e8a1c23..69f22b1 100644 (file)
@@ -18,7 +18,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>fprintfMat(file,M [,format,text])</synopsis>
+    <synopsis>fprintfMat(file, M [,format, text])</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
@@ -53,7 +53,7 @@
           </para>
           <para>
             <literal>precision</literal>: необязательное число,
-            которое определеяет максимальное количество символов,
+            которое определяет максимальное количество символов,
             напечатанных для всего или части выходного поля, или
             минимальное количество цифр, печатаемых для целых значений;
           </para>
index 693ea91..a8e38f5 100644 (file)
   <refnamediv>
     <refname>fscanf</refname>
     <refpurpose>
-      преобразует форматированный ввод, прочитанный в файле (<emphasis role="bold">эта функция устарела</emphasis>
+      преобразует форматированный ввод, прочитанный в файле. <emphasis role="bold">Эта функция устарела</emphasis>.
     </refpurpose>
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>[v_1, ..., v_n]=fscanf (file, format)</synopsis>
+    <synopsis>[v_1, ..., v_n] = fscanf(file, format)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
@@ -53,7 +53,7 @@
       </warning>
     </para>
     <para>
-      Функция <function>fscanf</function> считывает симольные данные в файле, определённом аргументом <varname>file</varname>, интерпретирует их в соответствии с форматом <varname>format</varname>, и возвращает преобразованные результаты.  
+      Функция <function>fscanf</function> считывает символьные данные в файле, определённом аргументом <varname>file</varname>, интерпретирует их в соответствии с форматом <varname>format</varname>, и возвращает преобразованные результаты.  
     </para>
     <para>
       Параметр <varname>format</varname> содержит спецификации преобразования, используемые для интерпретации ввода.
index c4fa2eb..e27ef2c 100644 (file)
@@ -52,7 +52,7 @@
           </para>
           <para>
             <literal>precision</literal>: необязательное число,
-            которое поределяет максимальное количество знаков,
+            которое определяет максимальное количество знаков,
             выводимых для всех или части выходных полей, или
             минимальное количество цифр, выводимых для целочисленных значений.
           </para>
@@ -75,7 +75,7 @@
         <listitem>
           <para>
             выходная переменная. Вектор-столбец строк. Это комментарии
-            в начале файла с именем <literal>filename</literal>.
+            в начале файла с именем <varname>filename</varname>.
           </para>
         </listitem>
       </varlistentry>
   <refsection>
     <title>Описание</title>
     <para>
-      Функция <literal>fscanfMat</literal> используется для считывания
+      Функция <function>fscanfMat</function> используется для считывания
          вещественной матрицы из текстового файла с именем
-         <literal>filename</literal>. Первые нечисловые строчки файла
-         возвращаются в переменной <literal>text</literal>, если это
+         <varname>filename</varname>. Первые нечисловые строчки файла
+         возвращаются в переменной <varname>text</varname>, если это
          запрошено, а все оставшиеся строчки должны иметь одинаковое
          количество столбцов (разделителем столбцов предполагается пробел
          или символы табуляции). Количество столбцов матрицы должно
          соответствовать количеству столбцов, обнаруженных в файле
-         <literal>filename</literal>, а количество строк получается при
+         <varname>filename</varname>, а количество строк получается при
          обнаружении конца файла (EOF) во входном файле. Эта функция
          может быть использована для чтения числовых данных, сохранённых
-         с помощью функции <literal>fprintfMat</literal> (по умолчанию в
+         с помощью функции <function>fprintfMat</function> (по умолчанию в
          качестве разделителя используется пробел).
     </para>
     <para>
-      <literal>fscanfMat</literal> поддерживает файлы с кодировкой ANSI/ASCII и UTF-8.
+      <function>fscanfMat</function> поддерживает файлы с кодировкой ANSI/ASCII и UTF-8.
     </para>
   </refsection>
   <refsection>
         <link linkend="mfscanf">mfscanf</link>
       </member>
       <member>
-        <link linkend="fscanfMat">fscanfMat</link>
-      </member>
-      <member>
         <link linkend="mget">mget</link>
       </member>
       <member>
         <link linkend="mputstr">mputstr</link>
       </member>
       <member>
-        <link linkend="mscanf">mscanf</link>
-      </member>
-      <member>
         <link linkend="mseek">mseek</link>
       </member>
       <member>
index 0daaa7a..5915711 100644 (file)
@@ -46,7 +46,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      <code>f= fullfile(varargin)</code> формирует полное имя
+      <code>f = fullfile(varargin)</code> формирует полное имя
       файла учитывая платформу, на которой она работает и обрабатывает
       случаи, когда директории начинаются или заканчиваются
       разделителем директорий.
index 77cba4f..61845f3 100644 (file)
@@ -28,7 +28,7 @@
       <varlistentry>
         <term>res</term>
         <listitem>
-          <para>строка или матрица строк, имя полного пути</para>
+          <para>строка или матрица строк, имя полного пути.</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -36,7 +36,7 @@
       <varlistentry>
         <term>relative_path</term>
         <listitem>
-          <para>строка или матрица строк, имя относительного пути</para>
+          <para>строка или матрица строк, имя относительного пути.</para>
         </listitem>
       </varlistentry>
     </variablelist>
@@ -44,7 +44,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      <function>fullpath(relative_path)</function> создаёт имя полного
+      <code>fullpath(relative_path)</code> создаёт имя полного
       пути для определённого имени относительного пути
       <varname>relative_path</varname>.
     </para>
index 7925032..9789ad1 100644 (file)
@@ -28,7 +28,7 @@
       <varlistentry>
         <term>drives</term>
         <listitem>
-          <para>матрица строк, диски</para>
+          <para>матрица строк, диски.</para>
         </listitem>
       </varlistentry>
     </variablelist>
index 045a421..2fde470 100644 (file)
@@ -18,8 +18,8 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>longpath=getlongpathname(shortpath)
-      [longpath,bOK]=getlongpathname(shortpath)
+    <synopsis>longpath = getlongpathname(shortpath)
+      [longpath, bOK] = getlongpathname(shortpath)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
@@ -41,7 +41,7 @@
         <term>bOK</term>
         <listitem>
           <para>
-            логическое значение или матрица логических значений: <literal>%T</literal>, если путь был преобразован, в противном случае -- <literal>%F</literal>.
+            логическое значение или матрица логических значений: <constant>%T</constant>, если путь был преобразован, в противном случае -- <constant>%F</constant>.
           </para>
         </listitem>
       </varlistentry>
       пути <varname>shortpath</varname> в его длинную форму. Если не было 
       найдено длинного имени пути, то этот примитив возвращает указанное имя.
     </para>
+        <para>
+         <note>
+           Примечание: если путь нельзя преобразовать (<varname>bOK</varname> равен <constant>%F</constant>), в особенности, если операционная система не Windows, то возвращаемый длинный путь идентичен входному краткому пути.
+         </note>
+        </para>
   </refsection>
   <refsection>
     <title>Примеры</title>
index 6c0e211..577a137 100644 (file)
@@ -1,4 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2008 - INRIA
+ * ...
+ * 
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at    
+ * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ *
+ -->
 <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" version="5.0-subset Scilab" xml:lang="ru" xml:id="getmd5">
   <refnamediv>
     <refname>getmd5</refname>
   <refsection>
     <title>Описание</title>
     <para>
-      <literal>getmd5(...)</literal> получает контрольную сумму md5 файла или строки.
+      Функция <function>getmd5</function> получает контрольную сумму md5 файла <varname>filename</varname> или строки <varname>ParamString</varname>.
     </para>
   </refsection>
   <refsection>
     <title>Примеры</title>
     <programlisting role="example"><![CDATA[ 
-getmd5('hello world','string')
-getmd5(['hello' 'world'],'string')
-getmd5(['hello' ; 'world'],'string')
+getmd5('Привет, мир!','string')
+getmd5(['Привет,' 'мир!'],'string')
+getmd5(['Привет,' ; 'мир!'],'string')
  
 getmd5( SCI+'/modules/core/etc/core.start' )
 getmd5( SCI+'/modules/core/etc/'+['core.start' 'core.quit'])
index 4e1fea1..6dffeaf 100644 (file)
@@ -19,7 +19,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>rel_file = getrelativefilename(abs_dir,abs_file)</synopsis>
+    <synopsis>rel_file = getrelativefilename(abs_dir, abs_file)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
index e53c595..8ff7c72 100644 (file)
       Примитив <function>getshortpathname</function> преобразует указанное имя 
       пути <varname>longpath</varname> в его краткую форму.
     </para>
+    <para>
+      <note>
+       Примечание: если путь нельзя преобразовать (<varname>bOK</varname> равен <constant>%F</constant>), в особенности, если операционная система не Windows, то возвращаемый короткий путь идентичен входному длинному пути.
+      </note>
+    </para>
   </refsection>
   <refsection>
     <title>Примеры</title>
index 0db2761..8fee923 100644 (file)
@@ -33,7 +33,7 @@
         <term>r</term>
         <listitem>
           <para>
-            логическое значение: <literal>%t</literal>, если <varname>path</varname> является путём до директории.
+            логическое значение: <constant>%t</constant>, если <varname>path</varname> является путём до директории.
           </para>
         </listitem>
       </varlistentry>
   <refsection>
     <title>Описание</title>
     <para>
-      <function>r=isdir(path)</function> проверяет является ли путь <varname>path</varname> путём до директории.
+      <function>r = isdir(path)</function> проверяет является ли путь <varname>path</varname> путём до директории.
     </para>
   </refsection>
   <refsection>
     <title>Сcылка</title>
     <para>
-      Эта функция основана на C-функции 
-      <function>stat</function>.Можно 
-      использовать краткие обозначения <varname>SCI</varname> и 
+      Эта функция основана на C-функции <function>stat</function>. Можно 
+      использовать краткие обозначения <literal>SCI</literal> и 
       <literal>~</literal> для директории Scilab'а и домашней директории.
     </para>
   </refsection>
index 1f5c1c5..aab8581 100644 (file)
@@ -66,8 +66,8 @@
       помощью <varname>paths</varname>, преобразуются в соответствии со 
       значением <code>getos() == 'Windows'</code> (см. также <link linkend="pathconvert">pathconvert</link>).
       Более того, если <varname>flagexpand</varname> равен ИСТИНЕ, то 
-      начальные строки, такие как <varname>SCIHOME</varname>, 
-      <varname>SCI</varname> или <literal>~</literal> расширяются с помощью 
+      начальные строки, такие как <literal>SCIHOME</literal>, 
+      <literal>SCI</literal> или <literal>~</literal> расширяются с помощью 
       переменных окружения.
     </para>
     <para>
index eab6276..2a2ee41 100644 (file)
@@ -7,7 +7,7 @@
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
     <synopsis>listvarinfile(filename)
-      [names,typs,dims,vols]=listvarinfile(filename)
+      [names, typs, dims, vols] = listvarinfile(filename)
     </synopsis>
   </refsynopsisdiv>
   <refsection>
index 7dafdc9..73c2d19 100644 (file)
@@ -19,8 +19,8 @@
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
         <synopsis>
-            files=ls [path]
-            files=ls( [path] )
+            files = ls [path]
+            files = ls( [path] )
         </synopsis>
     </refsynopsisdiv>
     <refsection>
index fd02446..1f5fbf0 100644 (file)
@@ -42,7 +42,7 @@
   <refsection>
     <title>Описание</title>
     <para>
-      <function>maxfiles</function> устанавливает предел количества одновременно открытых файлов.
+      Функция <function>maxfiles</function> устанавливает предел количества одновременно открытых файлов.
     </para>
     <para>Минимум : 20.</para>
     <para>Максимум : 100.</para>
index 220ab8c..31b4755 100644 (file)
@@ -19,7 +19,7 @@
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
     <synopsis>
-      err=mclose([fd])
+      err = mclose([fd])
       mclose('all')
     </synopsis>
   </refsynopsisdiv>
@@ -52,9 +52,9 @@
     <para>
       <code>mclose('all')</code> закрывает все файлы, открытые с помощью
       <code>file('open',..)</code> или <function>mopen</function>. 
-      <warning>
+      <caution>
        Будьте осторожны с использованием <function>mclose</function>, поскольку, когда вы используете её внутри файла-сценария Scilab, то она также закроет и сам сценарий, и Scilab не выполнит команды, написанные после <code>mclose('all')</code>.
-      </warning>
+      </caution>
     </para>
   </refsection>
   <refsection role="see also">
index df76f3a..f35c950 100644 (file)
@@ -41,9 +41,9 @@
       метасимволы.
     </para>
     <para>
-      <warning>
+      <caution>
        Заметьте, что функция <function>mdelete</function> не спрашивает подтверждения, если вы вводите команду на удаление. Во избежание потери файлов, убедитесь, что вы точно указали файлы, которые вы хотите удалить.
-      </warning>
+      </caution>
     </para>
   </refsection>
   <refsection role="see also">
@@ -77,9 +77,6 @@
         <link linkend="mgetstr">mgetstr</link>
       </member>
       <member>
-        <link linkend="mopen">mopen</link>
-      </member>
-      <member>
         <link linkend="mprintf">mprintf</link>
       </member>
       <member>
index ee4ca25..b695a22 100644 (file)
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="ru" xml:id="meof">
   <refnamediv>
     <refname>meof</refname>
-    <refpurpose> check if end of file has been reached</refpurpose>
+    <refpurpose>проверяет достигнут ли конец файла</refpurpose>
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>err=meof(fd)</synopsis>
+    <synopsis>err = meof(fd)</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
@@ -57,9 +57,6 @@
         <link linkend="mclose">mclose</link>
       </member>
       <member>
-        <link linkend="meof">meof</link>
-      </member>
-      <member>
         <link linkend="mfprintf">mfprintf</link>
       </member>
       <member>
index 792a396..b216b5a 100644 (file)
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="windows-1251"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) 2008 - INRIA
@@ -18,7 +18,7 @@
   </refnamediv>
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
-    <synopsis>mfprintf(fd,format,a1,...,an);</synopsis>
+    <synopsis>mfprintf(fd, format, a1, ..., an);</synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Аргументы</title>
@@ -64,7 +64,7 @@
         </listitem>
       </varlistentry>
       <varlistentry>
-        <term>a1,...,an</term>
+        <term>a1, ..., an</term>
         <listitem>
           <para>
             данные, которые преобразуются и распечатываются в соответствии с параметром формата.
     <programlisting role="example"><![CDATA[ 
  
 fd = mopen(TMPDIR+'/text.txt','wt');
-mfprintf(fd,'hello %s %d.\n','world',1);
-mfprintf(fd,'hello %s %d.\n','scilab',2);
-mfprintf(fd,'This line is built with a column vector (26:28) %d.\n',[26:28].');
-mfprintf(fd,'This line is built with a row vector (26:28) %d.\n',[26:28]);
+mfprintf(fd,'Привет, %s %d.\n','мир!',1);
+mfprintf(fd,'Привет, %s %d.\n','Scilab',2);
+mfprintf(fd,'Эта строка построена с помощью вектор-столбца (26:28) %d.\n',[26:28].');
+mfprintf(fd,'Эта строка построена с помощью вектор-строки (26:28) %d.\n',[26:28]);
 A = rand(3,6);
-mfprintf(fd,'This line is built with a matrix %.3f.\n',A);
+mfprintf(fd,'Эта строка построена с помощью матрицы %.3f.\n',A);
 mclose(fd);
 if (isdef('editor') | (funptr('editor')<>0)) then
   editor(TMPDIR+'/text.txt')
@@ -159,7 +159,7 @@ mfprintf(6,'stdout output.\n');
         <link linkend="mdelete">mdelete</link>
       </member>
       <member>
-        <link linkend="printf_conversion">printf_conversion</link>
+        <link linkend="printf_conversion">преобразование в printf</link>
       </member>
     </simplelist>
   </refsection>
index 48ccbfd..4563c94 100644 (file)
@@ -85,9 +85,9 @@
     </para>
     <para>
       <note>
-       В Windows, поведение по умолчанию состоит в пропуске байта 13 (0x0D). 
+       В Windows, поведение по умолчанию состоит в пропуске байта 13 (<literal>0x0D</literal>). 
        Функцию  <function>mopen</function> следует вызывать с опцией
-       <literal>'b'</literal>, например, <code>fd1=mopen(file1,'rb')</code>, так что все байты без исключения будут прочитаны.
+       <literal>'b'</literal>, например, <code>fd1 = mopen(file1,'rb')</code>, так что все байты без исключения будут прочитаны.
       </note>
     </para>
     <para>Тип данных:</para>
         <term>..l</term>
         <listitem>
           <para>
-           обратный порядок байтов (в сочетании с одним из вышеперечисленных 
+           прямой порядок байтов (в сочетании с одним из вышеперечисленных 
            типов)
          </para>
         </listitem>
         <term>..b</term>
         <listitem>
           <para>
-           прямой порядок байтов (в сочетании с одним из вышеперечисленных 
+           обратный порядок байтов (в сочетании с одним из вышеперечисленных 
            типов)
          </para>
         </listitem>
index 0fc130b..aefc094 100644 (file)
@@ -162,7 +162,7 @@ cd TMPDIR;
         <title>Смотрите также</title>
         <simplelist type="inline">
             <member>
-                <link linkend="cd">cd</link>
+                <link linkend="chdir">chdir</link>
             </member>
             <member>
                 <link linkend="dir">dir</link>
index 9302fea..4c654e9 100644 (file)
@@ -17,8 +17,8 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>movefile(source,destination)
-            [status,message] = movefile(source,destination)
+        <synopsis>movefile(source, destination)
+            [status, message] = movefile(source, destination)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
index e3faa0d..3c85b8f 100644 (file)
@@ -18,7 +18,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>paths=pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
+        <synopsis>paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
index 6c3ef19..3e8c856 100644 (file)
@@ -7,14 +7,14 @@
   <refsynopsisdiv>
     <title>Последовательность вызова</title>
     <synopsis>pwd
-      x=pwd()
+      x = pwd()
     </synopsis>
   </refsynopsisdiv>
   <refsection>
     <title>Описание</title>
     <para>
       <code>pwd</code> возвращает в <varname>ans</varname> текущую директорию Scilab'а.
-      <code>x=pwd()</code> возвращает в <varname>x</varname> текущую директорию Scilab'а.
+      <code>x = pwd()</code> возвращает в <varname>x</varname> текущую директорию Scilab'а.
     </para>
   </refsection>
   <refsection>
@@ -30,9 +30,6 @@ x=pwd()
       <member>
         <link linkend="chdir">chdir</link>
       </member>
-      <member>
-        <link linkend="cd">cd</link>
-      </member>
     </simplelist>
   </refsection>
 </refentry>
index 776b772..9a1501f 100644 (file)
@@ -14,7 +14,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" version="5.0-subset Scilab" xml:lang="ru" xml:id="removedir">
     <refnamediv>
         <refname>removedir</refname>
-        <refpurpose>removes a directory</refpurpose>
+        <refpurpose>удаляет директорию</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
             <varname>dirname</varname>.
         </para>
         <para>[
-            <code>[status] = removedir(dirname)</code> удаляет директорию <varname>dirname</varname> и всё её содержимое, возвращая статус. Здесь <varname>status</varname> равен <constant>%T</constant> в случае успеха и <constant>%F</constant> в случае ошибки.
+            <code>[status] = removedir(dirname)</code> удаляет директорию 
+           <varname>dirname</varname> и всё её содержимое, возвращая статус  
+           <varname>status</varname>. Здесь <varname>status</varname> равен 
+           <constant>%T</constant> в случае успеха и <constant>%F</constant> в 
+           случае ошибки.
         </para>
         <para>
             Функция <function>removedir</function> используется в <function>rmdir</function>.
index ce925c9..067c2cd 100644 (file)
@@ -14,7 +14,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" version="5.0-subset Scilab" xml:lang="ru" xml:id="rmdir">
     <refnamediv>
         <refname>rmdir</refname>
-        <refpurpose>removes a directory</refpurpose>
+        <refpurpose>удаляет директорию</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>