<br><br><div class="gmail_quote">On Mon, Mar 22, 2010 at 12:27 AM, Alan G Isaac <span dir="ltr"><<a href="mailto:aisaac@american.edu">aisaac@american.edu</a>></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">>> On 3/21/2010 12:54 AM, Ralf Gommers wrote:<br>
>>> too many blank lines are needed<br>
<br>
<br>
</div><div class="im">> On Sun, Mar 21, 2010 at 9:51 PM, Alan G Isaac <<a href="mailto:aisaac@american.edu">aisaac@american.edu</a><br>
</div><div class="im">> <mailto:<a href="mailto:aisaac@american.edu">aisaac@american.edu</a>>> wrote:<br>
>>     Please define "need" 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>
> 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 = 'full':<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 = 'r':<br>
<div class="im">            - r : ndarray of float or complex, shape (K, N)<br>
</div>         a2 if mode = 'economic':<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 "K = min(M, N)." 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't look good, but that's maybe a matter of taste. Try this in the wiki (in the Notes, doesn't work in Parameters/Returns):<br><br>q, r if mode = 'full':<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 = 'r':<br>    - r : ndarray of float or complex, shape (K, N)<br>
          Definition of r.<br>a2 if mode = 'economic':<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>