<br><br><div class="gmail_quote">On Mon, Mar 22, 2010 at 12:27 AM, Alan G Isaac <span dir="ltr">&lt;<a href="mailto:aisaac@american.edu">aisaac@american.edu</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div class="im">&gt;&gt; On 3/21/2010 12:54 AM, Ralf Gommers wrote:<br>
&gt;&gt;&gt; too many blank lines are needed<br>
<br>
<br>
</div><div class="im">&gt; On Sun, Mar 21, 2010 at 9:51 PM, Alan G Isaac &lt;<a href="mailto:aisaac@american.edu">aisaac@american.edu</a><br>
</div><div class="im">&gt; &lt;mailto:<a href="mailto:aisaac@american.edu">aisaac@american.edu</a>&gt;&gt; wrote:<br>
&gt;&gt;     Please define &quot;need&quot; after seeing the compact example I posted.<br>
<br>
<br>
</div><div class="im">On 3/21/2010 9:58 AM, Ralf Gommers wrote:<br>
&gt; You need 4 blank lines in your example. Now I tried adding a description<br>
<br>
<br>
</div>Here is the compact example I posted.<br>
<div class="im"><br>
         q, r if mode = &#39;full&#39;:<br>
            - q : ndarray of float or complex, shape (M, K)<br>
</div><div class="im">            - r : ndarray of float or complex, shape (K, N)<br>
</div>         r if mode = &#39;r&#39;:<br>
<div class="im">            - r : ndarray of float or complex, shape (K, N)<br>
</div>         a2 if mode = &#39;economic&#39;:<br>
            - a2 : ndarray of float or complex, shape (M, N)<br>
<br>
         K = min(M, N).<br>
<div class="im">         The diagonal and the upper triangle of `a2` contains `r`,<br>
</div>         while the rest of `a2` is undefined.<br>
<font color="#888888"><br>
</font></blockquote><div>Your example works, the only blank lines it needs is before and after the whole block, plus above &quot;K = min(M, N).&quot; With one level of indentation this is an alternative to dashed lists.<br>
<br>After adding definitions for the returned arguments I still think it doesn&#39;t look good, but that&#39;s maybe a matter of taste. Try this in the wiki (in the Notes, doesn&#39;t work in Parameters/Returns):<br><br>q, r if mode = &#39;full&#39;:<br>
    - q : ndarray of float or complex, shape (M, K) <br>          Definition of q.<br>    - r : ndarray of float or complex, shape (K, N)<br>          Definition of r.<br>r if mode = &#39;r&#39;:<br>    - r : ndarray of float or complex, shape (K, N)<br>
          Definition of r.<br>a2 if mode = &#39;economic&#39;:<br>    - a2 : ndarray of float or complex, shape (M, N)<br>          Definition of a.<br>  <br>    K = min(M, N).<br>    The diagonal and the upper triangle of `a2` contains `r`,<br>
    while the rest of `a2` is undefined.<br><br><br>Cheers,<br>Ralf<br><br></div></div><br>