* Bug #6979 fixed - Help page of rlist() was unclear.
[scilab.git] / scilab / modules / data_structures / help / en_US / rlist.xml
index fb54193..31f279b 100644 (file)
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>rlist()
-            rlist(a1 ,..., an)
+        <synopsis>[r] = rlist()
+            [r] = rlist(N, D [,dom])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
+        <title>Arguments</title>
+        <variablelist>
+            <varlistentry>
+                <term>N,D</term>
+                <listitem>
+                    <para>polynomial martices.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>dom</term>
+                <listitem>
+                    <para>
+                        character string, or <literal>[]</literal> or a scalar.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>r</term>
+                <listitem>
+                    <para>
+                        tlist ("r" list) representing the rational fraction.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
         <title>Description</title>
         <para>
-            <literal>rlist(a1, ..., an)</literal> is a shortcut  to
-            <literal>tlist(['r','num';'den','dt'], a1, ..., an)</literal>.
+            <literal>rlist(N, D, dom)</literal> is a shortcut  to
+            <literal>tlist(['r','num','den','dt'], N, D, dom)</literal>.
         </para>
         <para>
-            <literal>rlist(a1, ..., an)</literal> creates a <literal>tlist</literal> with  <literal>['r','num';'den','dt']</literal> as
-            first entry and  <literal>ai</literal>'s as next entries if any. No type nor size
-            checking is done on <literal>ai</literal>'s.
+            To correspond to the domain time of a linear system, <varname>dom</varname> 
+            must be equal to <literal>'c'</literal>,<literal>'d'</literal>, <literal>[]</literal> or a scalar.
+            One the one hand, to be similar to functions as <link linkend="syslin">syslin</link>, 
+            and on the other, to use some functions as <link linkend="tf2ss">tf2ss</link>, it
+            is necessary that <varname>dom</varname> is equal to these values.
         </para>
     </refsection>
     <refsection>
@@ -42,6 +71,11 @@ W'*W
 Num=[s,s+2;1,s];
 Den=[s*s,s;s,s*s];
 rlist(Num,Den,[])
+
+H1=(1+2*s)/s^2;
+S1bis=syslin('c',H1)
+r=rlist(H1.num, H1.den, 'c')
+r == S1bis
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
@@ -56,6 +90,9 @@ rlist(Num,Den,[])
             <member>
                 <link linkend="rational">rational</link>
             </member>
+            <member>
+                <link linkend="tf2ss">tf2ss</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>