On Sun, Mar 21, 2010 at 8:53 AM, Ralf Gommers <[email protected]>wrote:
> > > On Sun, Mar 21, 2010 at 10:41 PM, <[email protected]> wrote: > >> On Sun, Mar 21, 2010 at 10:16 AM, Ralf Gommers >> <[email protected]> wrote: >> >> > Both look sort of okay, but are abusing the syntax. >> > >> > What do you think about the following: >> > 1. Do not use lists with multiple indentation levels, it just doesn't >> look >> > good and should not be necessary. >> > 2. Use dashes for simple lists. >> >> both fine with me, we can convert asterisks to dashes >> >> > 3. List with multi-line items are broken only inside the >> Parameters/Returns >> > sections. This is a bug and simply needs to be fixed. (this would fix >> both >> > of your examples) >> >> Does this mean if this bug gets fixed, then we wouldn't need the extra >> empty lines between list items? >> > > Yes. The following works in the Notes section, but not in Parameters: > - item one > - item two > this is a multi-line item > - item 3 > > >> >> Currently, the rendering in the doc editor view for item lists has >> also wrong indentation >> http://docs.scipy.org/numpy/docs/numpy.ndarray.transpose/ >> but the html looks ok >> >> http://docs.scipy.org/doc/numpy/reference/generated/numpy.ndarray.transpose.html >> > > Html looks fine indeed. It should still look like that once that bug is > fixed. > > Could you open a ticket for this? We need to track it somewhere. Chuck
_______________________________________________ NumPy-Discussion mailing list [email protected] http://mail.scipy.org/mailman/listinfo/numpy-discussion
