<?xml version="1.0" encoding="UTF-8"?>
<!--
This file is part of the Scilab time frequency toolbox.
This file must be used under the terms of the  terms of the GNU General Public License 
as published by the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

Copyright (c) 1996 by CNRS (France).
-->

<refentry xml:id="divider" 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:scilab="http://www.scilab.org"
          xmlns:ns3="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:db="http://docbook.org/ns/docbook">

  <refnamediv>
    <refname>divider</refname><refpurpose>Find dividers of an integer.</refpurpose>
  </refnamediv>

<refsynopsisdiv>
   <title>Calling Sequence</title>
   <synopsis>
   	[N,M]=divider(N1)
   </synopsis>
</refsynopsisdiv>

<refsection>
  <title>Parameters</title>
  <variablelist>
    <varlistentry><term>N1 :</term>
    <listitem>
      <para>an array of  positive integers.</para>
    </listitem>
    </varlistentry>
    <varlistentry>
      <term>N:</term>
      <listitem>
    <para>an array of  positive integers with same sizes as N1.</para>
    </listitem>
    </varlistentry>
    <varlistentry>
      <term>M:</term>
      <listitem>
        <para>an array of  positive integers with same sizes as N1.</para>
      </listitem>
    </varlistentry>
  </variablelist>
</refsection>


<refsection>
   <title>Description</title>
   <para>
     find two integers N and M such that M.*N=N1 and M and N as close
     as possible from sqrt(N1).
   </para>
   <para>
</para>
</refsection>

<refsection>
   <title>Examples</title>
   <programlisting role="example"><![CDATA[
	 [N,M]=divider(258)

         [N,M]=divider([6 8;4 198])
   ]]></programlisting>
</refsection>

<refsection>
   <title>Authors</title>
   <simplelist type="vert">
   <member>H. Nahrstaedt - Aug 2010</member>
   <member>	F. Auger - November 1995.</member>
   <member>	Copyright (c) 1996 by CNRS (France).</member>
   </simplelist>
</refsection>
</refentry>
