<br><br><div class="gmail_quote">On Sun, Mar 21, 2010 at 10:18 AM, Charles R Harris <span dir="ltr"><<a href="mailto:charlesr.harris@gmail.com">charlesr.harris@gmail.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><div></div><div class="h5">On Sat, Mar 20, 2010 at 7:45 PM, Ralf Gommers <span dir="ltr"><<a href="mailto:ralf.gommers@googlemail.com" target="_blank">ralf.gommers@googlemail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br><br><div class="gmail_quote"><div><div></div><div>On Sun, Mar 21, 2010 at 4:18 AM, Charles R Harris <span dir="ltr"><<a href="mailto:charlesr.harris@gmail.com" target="_blank">charlesr.harris@gmail.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br><br><div class="gmail_quote"><div>On Sat, Mar 20, 2010 at 1:32 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="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">



<div>On 3/20/2010 2:15 PM, <a href="mailto:josef.pktd@gmail.com" target="_blank">josef.pktd@gmail.com</a> wrote:<br>
> As far as I know, stars are the only way to render a list in<br>
> restructured txt, otherwise it looses the list formatting.<br>
<br>
</div>Try a definition list?<br>
Example below.<br>
Alan<br>
<br>
<br>
Returns<br>
-------<br>
<br>
q, r if mode = 'full':<br>
<div>    - q : ndarray of float or complex, shape (M, K)<br>
    - r : ndarray of float or complex, shape (K, N)<br>
<br>
</div><div>    K = min(M, N)<br>
<br>
r if mode = 'r':<br>
    - r : ndarray of float or complex, shape (K, N)<br>
<br>
</div>a2 if mode = 'economic':<br>
<div>    - a2 : ndarray of float or complex, shape (M, N)<br>
<br>
    The diagonal and the upper triangle of a2 contains r,<br>
    while the rest of the matrix is undefined.<br>
<br></div></blockquote></div><div><br>Maybe handle it in a manner similar to the other sections.<br><br>q,r <> mode = 'r''<br>    q: [M,N] ndarray<br>        The columns of 'q' are orthonomal.<br>


    r:  [K,N] ndarray<br>
        Upper triangular array.<br>...<br><br>The "<>" standing in for "if". The indentation could be moved out.<br><br></div></div></blockquote></div></div><div>Looks good, but what determines that this is a list, the <>? What if you want a list that does not use if's? If this can be made to work, great, but it will probably be much more robust if there's some kind of markup. Stars or dashes would not look that bad imho if there would be no need for blank lines.<br>


<br></div></div></blockquote></div></div><div><br>That was just a suggestion, I think it can probably be improved upon. Thoughts?<br></div></div></blockquote><div><br>In general a list should just be defined with *. Like:<br>
* item 1<br>    * sub-item 1<br>      Hey, a multi-line sub-item works too!<br>    * sub-item 2<br>* item 2<br><br>In the specific case of a variable number of return values, I do not like the if..else construction. How about this:<br>
<br>q : ndarray<br>    The q-value. If mode='r' this contains .... <br>    If mode='economic' ....<br>r : ndarray, optional<br>    The r-value. Is only returned if mode='r'. <br><br>'optional' could be changed to 'conditional' or something like that.<br>
<br>Ralf<br><br></div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div class="gmail_quote"><div> <br></div><div class="im"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">

<div class="gmail_quote"><div>Also, if someone feels like tackling this, please make multi-line list items work at the same time. See <a href="http://code.google.com/p/pydocweb/issues/detail?id=46" target="_blank">http://code.google.com/p/pydocweb/issues/detail?id=46</a><br>


<br></div></div></blockquote></div><div><br>Chuck <br></div><br></div>
<br>_______________________________________________<br>
NumPy-Discussion mailing list<br>
<a href="mailto:NumPy-Discussion@scipy.org">NumPy-Discussion@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/numpy-discussion" target="_blank">http://mail.scipy.org/mailman/listinfo/numpy-discussion</a><br>
<br></blockquote></div><br>