From f15379ab9b229c141de2afc322ae7e72828f2e3c Mon Sep 17 00:00:00 2001
From: Sylvestre Ledru <sylvestre.ledru@scilab-enterprises.com>
Date: Tue, 15 Jan 2013 09:23:08 +0100
Subject: [PATCH] Add examples for rlist & whereis

Change-Id: I0dc54536c6e23dd5c574023a391bb9eb2a662628
---
 .../modules/data_structures/help/en_US/rlist.xml   |   15 +++++++++++++++
 .../modules/data_structures/help/fr_FR/rlist.xml   |   14 ++++++++++++++
 .../functions/help/en_US/libraries/whereis.xml     |   10 +++++++++-
 .../functions/help/fr_FR/libraries/whereis.xml     |   12 ++++++++++--
 4 files changed, 48 insertions(+), 3 deletions(-)

diff --git a/scilab/modules/data_structures/help/en_US/rlist.xml b/scilab/modules/data_structures/help/en_US/rlist.xml
index 22f8be7..f9be5ee 100644
--- a/scilab/modules/data_structures/help/en_US/rlist.xml
+++ b/scilab/modules/data_structures/help/en_US/rlist.xml
@@ -33,6 +33,18 @@
             checking is done on <literal>ai</literal>'s.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+W=[1/s,1/(s+1)]
+W'*W
+Num=[s,s+2;1,s];
+Den=[s*s,s;s,s*s];
+rlist(Num,Den,[])
+ ]]></programlisting>
+    </refsection>
+    
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
@@ -42,6 +54,9 @@
             <member>
                 <link linkend="syslin">syslin</link>
             </member>
+            <member>
+                <link linkend="rational">rational</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
diff --git a/scilab/modules/data_structures/help/fr_FR/rlist.xml b/scilab/modules/data_structures/help/fr_FR/rlist.xml
index a027b54..1bebf90 100644
--- a/scilab/modules/data_structures/help/fr_FR/rlist.xml
+++ b/scilab/modules/data_structures/help/fr_FR/rlist.xml
@@ -22,6 +22,17 @@
         <para>
         </para>
     </refsection>
+    <refsection>
+        <title>Exemples</title>
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+W=[1/s,1/(s+1)]
+W'*W
+Num=[s,s+2;1,s];
+Den=[s*s,s;s,s*s];
+rlist(Num,Den,[])
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Voir aussi</title>
         <simplelist type="inline">
@@ -31,6 +42,9 @@
             <member>
                 <link linkend="syslin">syslin</link>
             </member>
+            <member>
+                <link linkend="rational">rational</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
diff --git a/scilab/modules/functions/help/en_US/libraries/whereis.xml b/scilab/modules/functions/help/en_US/libraries/whereis.xml
index 1811939..5664137 100644
--- a/scilab/modules/functions/help/en_US/libraries/whereis.xml
+++ b/scilab/modules/functions/help/en_US/libraries/whereis.xml
@@ -12,10 +12,18 @@
         <title>Description</title>
         <para>
             returns as a character string
-            the name of the library containing the function <literal>function-name</literal>. 
+            the name of the library containing the function <literal>function-name</literal>.
             The path of the library is returned by typing <literal>"librname"</literal>.
         </para>
     </refsection>
+    <refsection>
+        <title>Exemples</title>
+        <programlisting role="example"><![CDATA[
+whereis("ls") // Should return fileiolib
+whereis("plot") // Should return graphicslib
+ ]]></programlisting>
+    </refsection>
+    
     <refsection role="see also">
         <title>See Also</title>
         <simplelist type="inline">
diff --git a/scilab/modules/functions/help/fr_FR/libraries/whereis.xml b/scilab/modules/functions/help/fr_FR/libraries/whereis.xml
index 4f579ef..e895d60 100644
--- a/scilab/modules/functions/help/fr_FR/libraries/whereis.xml
+++ b/scilab/modules/functions/help/fr_FR/libraries/whereis.xml
@@ -2,7 +2,7 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="whereis">
     <refnamediv>
         <refname>whereis</refname>
-        <refpurpose>nom de la bibliothèque contenant une fonction  </refpurpose>
+        <refpurpose>nom de la bibliothèque contenant une fonction</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
@@ -12,10 +12,18 @@
         <title>Description</title>
         <para>
             Renvoie une chaîne de caractères contenant le nom de la bibliothèque contenant
-            la fonction <literal>function-name</literal>. 
+            la fonction <literal>function-name</literal>.
             Le chemin d'accès à la bibliothèque peut être obtenu avec la fonction <literal>"librname"</literal>.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+whereis("ls") // Devrait retourner fileiolib
+whereis("plot") // Devrait retourner graphicslib
+ ]]></programlisting>
+    </refsection>
+    
     <refsection role="see also">
         <title>Voir aussi</title>
         <simplelist type="inline">
-- 
1.7.9.5