<br><br><div class="gmail_quote">On Wed, Apr 14, 2010 at 11:43 PM, Barry Warsaw <span dir="ltr"><<a href="mailto:barry@python.org">barry@python.org</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 Apr 14, 2010, at 11:13 PM, Ralf Gommers wrote:<br>
<br>
>You're a core developer (I think). But for the *average* user, do you really<br>
>think tags are fine? Earlier in this thread there was a mention of people<br>
>that love to read XML. I'm exaggerating a bit of course, but this is<br>
>similar. Whitespace beats tags for readability.<br>
<br>
</div>Well, I would think that help output, whether in a terminal or online would<br>
use the raw text to do a nicer job of formatting. </blockquote><div> </div><div>If it looks good in help() (and ipython) then I have no problem with it. You would have to preprocess each docstring each time it's viewed though, instead of only when generating html docs. But if it's robust, then sure, it's a non-issue.<br>
</div></div><br>Cheers,<br>Ralf<br>