[Numpy-discussion] Help!!! Docstrings overrun by markup crap.
Charles R Harris
Sun Mar 21 18:07:49 CDT 2010
On Sun, Mar 21, 2010 at 8:53 AM, Ralf Gommers
> On Sun, Mar 21, 2010 at 10:41 PM, <firstname.lastname@example.org> wrote:
>> On Sun, Mar 21, 2010 at 10:16 AM, Ralf Gommers
>> <email@example.com> 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
>> > 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
>> > sections. This is a bug and simply needs to be fixed. (this would fix
>> > 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
>> but the html looks ok
> Html looks fine indeed. It should still look like that once that bug is
Could you open a ticket for this? We need to track it somewhere.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the NumPy-Discussion