Revision of some help pages for module fileio.

[scilab.git] / scilab / modules / fileio / help / en_US / scanf.xml

diff --git a/scilab/modules/fileio/help/en_US/scanf.xml b/scilab/modules/fileio/help/en_US/scanf.xml
index 1932c46..b687573 100644 (file)
--- a/scilab/modules/fileio/help/en_US/scanf.xml
+++ b/scilab/modules/fileio/help/en_US/scanf.xml
@@ -12,72 +12,74 @@
  *
  -->
 <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="scanf">
-  <refnamediv>
-    <refname>scanf</refname>
-    <refpurpose> Converts formatted input on standard input</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <title>Calling Sequence</title>
-    <synopsis>[v_1,...v_n]=scanf (format);</synopsis>
-  </refsynopsisdiv>
-  <refsection>
-    <title>Arguments</title>
-    <variablelist>
-      <varlistentry>
-        <term>format</term>
-        <listitem>
-          <para>Specifies the format conversion.</para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </refsection>
-  <refsection>
-    <title>Description</title>
-    <para>
-      The scanf functions get character data on standard input (%io(1)), interpret it according
-      to a format, and returns the converted results.
-    </para>
-    <para>
-      The format parameter contains conversion specifications
-      used to interpret the input.
-    </para>
-    <para>
-      The format parameter can contain
-      white-space characters (blanks, tabs, newline, or formfeed)
-      that, except in the following two cases, read the input up to the
-      next nonwhite-space character. Unless there is a match in the control
-      string, trailing white space (including a newline character) is not
-      read.
-    </para>
-    <itemizedlist>
-      <listitem>
-        <para>Any character except % (percent sign), which must match the next character of the input stream.</para>
-      </listitem>
-      <listitem>
+    <refnamediv>
+        <refname>scanf</refname>
+        <refpurpose>converts formatted input on standard input</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Calling Sequence</title>
+        <synopsis>[v_1, ..., v_n]=scanf(format);</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Arguments</title>
+        <variablelist>
+            <varlistentry>
+                <term>format</term>
+                <listitem>
+                    <para>specifies the format conversion.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>v_1, ..., v_n</term>
+                <listitem>
+                    <para>converted results.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Description</title>
         <para>
-          A conversion specification that directs the conversion of the next input field. see <link linkend="scanf_conversion">scanf_conversion</link> for details.
+            The <function>scanf</function> function get 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>
-      </listitem>
-    </itemizedlist>
-  </refsection>
-  <refsection role="see also">
-    <title>See Also</title>
-    <simplelist type="inline">
-      <member>
-        <link linkend="printf">printf</link>
-      </member>
-      <member>
-        <link linkend="read">read</link>
-      </member>
-      <member>
-        <link linkend="fscanf">fscanf</link>
-      </member>
-      <member>
-        <link linkend="sscanf">sscanf</link>
-      </member>
-      <member>
-        <link linkend="scanf_conversion">scanf_conversion</link>
-      </member>
-    </simplelist>
-  </refsection>
+        <para>
+            The <varname>format</varname> parameter contains conversion specifications
+            used to interpret the input.
+        </para>
+        <para>
+            The <varname>format</varname> parameter can contain
+            white-space characters (blanks, tabs, newline, or formfeed)
+            that, except in the following two cases, read the input up to the
+            next nonwhite-space character. Unless there is a match in the control
+            string, trailing white-space (including a newline character) is not
+            read.
+        </para>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    Any character except <literal>%</literal> (percent sign), which must match the next character of the input stream.
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    A conversion specification that directs the conversion of the next input field. See <link linkend="scanf_conversion">scanf_conversion</link> for details.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </refsection>
+    <refsection role="see also">
+        <title>See Also</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="read">read</link>
+            </member>
+            <member>
+                <link linkend="fscanf">fscanf</link>
+            </member>
+            <member>
+                <link linkend="scanf_conversion">scanf_conversion</link>
+            </member>
+        </simplelist>
+    </refsection>
 </refentry>