<br><br><div class="gmail_quote">On Sun, Mar 21, 2010 at 9:58 PM, Ralf Gommers <span dir="ltr"><<a href="mailto:ralf.gommers@googlemail.com">ralf.gommers@googlemail.com</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;">
<br><br><div class="gmail_quote"><div class="im">On Sun, Mar 21, 2010 at 9:51 PM, Alan G Isaac <span dir="ltr"><<a href="mailto:aisaac@american.edu" target="_blank">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>On 3/21/2010 12:54 AM, Ralf Gommers wrote:<br>
> too many blank lines are needed<br>
<br>
</div>Please define "need" after seeing the compact example I posted.<br>
<br></blockquote></div><div>You need 4 blank lines in your example. Now I tried adding a description for the first argument (q) like this:<div class="im"><br>q, r if mode = 'full' :<br>   - q : ndarray of float or complex, shape (M, K)<br>
</div>
         Description of `q`.<div class="im"><br>   - r : ndarray of float or complex, shape (K, N)<br><br></div>That doesn't work, you need yet more blank lines (try this in the wiki editor).<br><br><br>I just changed the docstring to the following, looks much better in both plain text and html imho:<div class="im">
<br>
<br>q : ndarray of float or complex, optional<br>    The orthonormal matrix, of shape (M, K). Only returned if<br>    ``mode='full'``.<br>r : ndarray of float or complex, optional<br>    The upper-triangular matrix, of shape (K, N) with K = min(M, N).<br>

    Only returned when ``mode='full'`` or ``mode='r'``.<br>a2 : ndarray of float or complex, optional<br>    Array of shape (M, N), only returned when ``mode='economic``'.<br></div><div class="im">
    The  diagonal and the upper triangle of `a2` contains `r`, while<br>
    the rest of the matrix is undefined.<br></div></div></div></blockquote><div><br>This line in the code is fairly amusing by the way:<br>#  economic mode. Isn't actually economic. <br></div></div><br>Economic mode is very similar to 'r' mode anyway, what's the point?<br>
<br>Ralf<br>