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.