<br><br><div class="gmail_quote">On Sun, Mar 21, 2010 at 9:57 PM,  <span dir="ltr"><<a href="mailto:josef.pktd@gmail.com">josef.pktd@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;">
<div class="im">On Sun, Mar 21, 2010 at 9:51 AM, Alan G Isaac <<a href="mailto:aisaac@american.edu">aisaac@american.edu</a>> wrote:<br>
> On 3/21/2010 12:54 AM, Ralf Gommers wrote:<br>
>> too many blank lines are needed<br>
><br>
> Please define "need" after seeing the compact example I posted.<br>
><br>
> Personally, I think reST makes the right trade-offs,<br>
> minimizing markup within the constraint of being unambiguous.<br>
<br>
</div>I tried<br>
<a href="http://docs.scipy.org/scipy/docs/scipy.signal.signaltools.convolve/diff/4791/5687/" target="_blank">http://docs.scipy.org/scipy/docs/scipy.signal.signaltools.convolve/diff/4791/5687/</a><br>
<br>
last night, but no version looks really nice. I didn't manage the<br>
definition list.<br>
<br>
The mode parameter description is an example for  the most common case<br>
when we need to do lists in the Parameters descriptions.<br>
<br>
But I don't think we have consistent use of markup for this case until now<br>
<br>
One alternative is here:<br>
<a href="http://docs.scipy.org/scipy/docs/scipy.interpolate.rbf.Rbf/" target="_blank">http://docs.scipy.org/scipy/docs/scipy.interpolate.rbf.Rbf/</a><br>
<br>
A good example that can be used as pattern and is acceptable would be useful.<br>
<br>
</blockquote><div>Both look sort of okay, but are abusing the syntax. <br><br>What do you think about the following:<br>1. Do not use lists with multiple indentation levels, it just doesn't look good and should not be necessary.<br>
2. Use dashes for simple lists.<br>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)<br><br>Cheers,<br>
Ralf<br></div></div>