[Numpy-discussion] Help!!! Docstrings overrun by markup crap.

[Charles R Harris]

On Sat, Mar 20, 2010 at 1:32 PM, Alan G Isaac <aisaac@american.edu> wrote:

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

q,r <> mode = 'r''
    q: [M,N] ndarray
        The columns of 'q' are orthonomal.
    r:  [K,N] ndarray
        Upper triangular array.
...

The "<>" standing in for "if". The indentation could be moved out.

Chuck
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/numpy-discussion/attachments/20100320/4f7578fc/attachment-0001.html