Help check: validate the help files on compilation against a derivated docbook schema
[scilab.git] / scilab / modules / elementary_functions / help / en_US / signalprocessing / ssrand.xml
index 3b74b23..0f7ea89 100644 (file)
  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
  *
  -->
-<refentry version="5.0-subset Scilab" xml:id="ssrand" xml:lang="en"
-          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">
+<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="ssrand" xml:lang="en">
   <info>
     <pubdate>$LastChangedDate$</pubdate>
   </info>
-
   <refnamediv>
     <refname>ssrand</refname>
-
     <refpurpose>random system generator</refpurpose>
   </refnamediv>
-
   <refsynopsisdiv>
     <title>Calling Sequence</title>
-
     <synopsis>sl=ssrand(nout,nin,nstate)
 [sl,U]=ssrand(nout,nin,nstate,flag)</synopsis>
   </refsynopsisdiv>
-
   <refsection>
     <title>Arguments</title>
-
     <variablelist>
       <varlistentry>
         <term>nout</term>
-
         <listitem>
           <para>integer (number of output)</para>
         </listitem>
       </varlistentry>
-
       <varlistentry>
         <term>nin</term>
-
         <listitem>
           <para>integer (number of input)</para>
         </listitem>
       </varlistentry>
-
       <varlistentry>
         <term>nstate</term>
-
         <listitem>
           <para>integer (dimension of state-space)</para>
         </listitem>
       </varlistentry>
-
       <varlistentry>
         <term>flag</term>
-
         <listitem>
           <para>list made of one character string and one or several
           integers</para>
         </listitem>
       </varlistentry>
-
       <varlistentry>
         <term>sl</term>
-
         <listitem>
           <para>list (<literal>syslin</literal> list)</para>
         </listitem>
       </varlistentry>
-
       <varlistentry>
         <term>U</term>
-
         <listitem>
           <para>square <literal>(nstate x nstate)</literal> nonsingular
           matrix</para>
       </varlistentry>
     </variablelist>
   </refsection>
-
   <refsection>
     <title>Description</title>
-
     <para><literal>sl=ssrand(nout,nin,nstate)</literal> returns a random
     strictly proper (<literal>D=0</literal>) state-space system of size
     <literal>[nout,nint]</literal> represented by a <literal>syslin</literal>
     list and with <literal>nstate</literal> state variables.</para>
-
     <para><literal>[sl,U]=ssrand(nout,nin,nstate,flag)</literal> returns a
     test linear system with given properties specified by
     <literal>flag</literal>. <literal>flag</literal> can be one of the
     following:</para>
-
-    <programlisting role = ""><![CDATA[ 
+    <programlisting><![CDATA[ 
 flag=list('co',dim_cont_subs)  
 flag=list('uo',dim_unobs_subs)
 flag=list('ncno',dim_cno,dim_ncno,dim_co,dim_nco)
@@ -112,7 +85,6 @@ flag=list('dt',dim_inst_unob,dim_instb0,dim_unobs)
 flag=list('on',nr,ng,ng0,nv,rk)
 flag=list('ui',nw,nwu,nwui,nwuis,rk)
  ]]></programlisting>
-
     <para>The complete description of the <literal>Sys</literal> is given in
     the code of the <literal>ssrand</literal> function (in
     <literal>SCI/modules/cacsd/macros/</literal>). For example with
@@ -123,10 +95,8 @@ flag=list('ui',nw,nwu,nwui,nwuis,rk)
     "controllable", "unobservable", "non-controllable-non-observable",
     "stabilizable","detectable","output-nulling","unknown-input".</para>
   </refsection>
-
   <refsection>
     <title>Examples</title>
-
     <programlisting role="example"><![CDATA[ 
 //flag=list('st',dim_cont_subs,dim_stab_subs,dim_stab0)  
 //dim_cont_subs&lt;=dim_stab_subs&lt;=dim_stab0  
@@ -142,12 +112,12 @@ w=ss2ss(Sl,inv(U)); //undo the random change of basis => form as above
 [n,nc,u,sl]=st_ility(Sl);n,nc
  ]]></programlisting>
   </refsection>
-
   <refsection role="see also">
-<title>See Also</title>
-
+    <title>See Also</title>
     <simplelist type="inline">
-      <member><link linkend="syslin">syslin</link></member>
+      <member>
+        <link linkend="syslin">syslin</link>
+      </member>
     </simplelist>
   </refsection>
 </refentry>