do help page moved to control_flow chapter + add an example 34/8934/2
Sylvestre Ledru [Tue, 4 Sep 2012 16:05:50 +0000 (18:05 +0200)]
Change-Id: Ia523a418bcf0cda6a41dc5d1d2444850e3404343

scilab/modules/core/help/en_US/control_flow/do.xml [moved from scilab/modules/core/help/en_US/keywords/do.xml with 60% similarity]
scilab/modules/core/help/fr_FR/control_flow/do.xml [moved from scilab/modules/core/help/fr_FR/keywords/do.xml with 75% similarity]
scilab/modules/core/help/ja_JP/control_flow/do.xml [moved from scilab/modules/core/help/ja_JP/keywords/do.xml with 75% similarity]
scilab/modules/core/help/pt_BR/control_flow/do.xml [moved from scilab/modules/core/help/pt_BR/keywords/do.xml with 75% similarity]
scilab/modules/core/help/ru_RU/control_flow/do.xml [moved from scilab/modules/core/help/ru_RU/keywords/do.xml with 75% similarity]

@@ -2,16 +2,36 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="do">
     <refnamediv>
         <refname>do</refname>
-        <refpurpose> language keyword for loops</refpurpose>
+        <refpurpose>language keyword for loops</refpurpose>
     </refnamediv>
     <refsection>
         <title>Description</title>
         <para>
-            May be used inside <literal>for</literal>  or  <literal>while</literal>
-            instructions to separate the loop 
+            May be used inside <literal>for</literal> or <literal>while</literal>
+            instructions to separate the loop
             variable definition and the set of instructions.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+      i = 0
+      while i<5 do
+          disp("i");
+          i = i + 1;
+      end
+ ]]></programlisting>
+        <programlisting role="example"><![CDATA[
+n=5;
+for i = 1:n do
+    for j = 1:n do
+        a(i,j) = 1/(i+j-1);
+    end;
+end
+
+ ]]></programlisting>
+    </refsection>
+    
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
             variable de boucle de l'ensemble des instructions.
         </para>
     </refsection>
+    <refsection>
+        <title>Exemples</title>
+        <programlisting role="example"><![CDATA[
+      i = 0
+      while i<5 do
+          disp("i");
+          i = i + 1;
+      end
+ ]]></programlisting>
+        <programlisting role="example"><![CDATA[
+n=5;
+for i = 1:n do
+    for j = 1:n do
+        a(i,j) = 1/(i+j-1);
+    end;
+end
+
+ ]]></programlisting>
+    </refsection>
+    
     <refsection role="see also">
         <title>Voir aussi</title>
         <simplelist type="inline">
               ループ変数の定義と命令を分離するために使用されます.
         </para>
     </refsection>
+    
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+      i = 0
+      while i<5 do
+          disp("i");
+          i = i + 1;
+      end
+ ]]></programlisting>
+        <programlisting role="example"><![CDATA[
+n=5;
+for i = 1:n do
+    for j = 1:n do
+        a(i,j) = 1/(i+j-1);
+    end;
+end
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>参照</title>
         <simplelist type="inline">
         </para>
     </refsection>
     <refsection>
+        <title>Exemplos</title>
+        <programlisting role="example"><![CDATA[
+      i = 0
+      while i<5 do
+          disp("i");
+          i = i + 1;
+      end
+ ]]></programlisting>
+        <programlisting role="example"><![CDATA[
+n=5;
+for i = 1:n do
+    for j = 1:n do
+        a(i,j) = 1/(i+j-1);
+    end;
+end
+
+ ]]></programlisting>
+    </refsection>
+    
+    <refsection>
         <title> Ver Também </title>
         <simplelist type="inline">
             <member>
             переменной цикла и набором инструкций.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+      i = 0
+      while i<5 do
+          disp("i");
+          i = i + 1;
+      end
+ ]]></programlisting>
+        <programlisting role="example"><![CDATA[
+n=5;
+for i = 1:n do
+    for j = 1:n do
+        a(i,j) = 1/(i+j-1);
+    end;
+end
+
+ ]]></programlisting>
+    </refsection>
+    
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">