<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, Jan 6, 2013 at 4:24 PM, Alexander Arsenovic <span dir="ltr">&lt;<a href="mailto:arsenovic@virginia.edu" target="_blank">arsenovic@virginia.edu</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>i recently started using the ipython sphinx directive in my docs.  it seems to 
me that using this in the `Examples` section of the docstrings would be 
good  practice, as it prevents me from making error in the examples, and could  be used to insert plots. <br><br>from what i see, the  scipy/numpy doc strings dont make use docs use this.  is there a reason why *not* to use the ipython directive in scipy/numpy-convention docstrings?<br>
</div></div></blockquote><div><br></div><div>We already can and do include plots with the plot directive. Changing &quot;&gt;&gt;&gt;&quot; to &quot;In [1]&quot; is also not really needed. And the standard way to check for errors in examples is with doctest, although we don&#39;t really care much about that at the moment in numpy/scipy.<br>
<br></div><div>So there&#39;s not a large incentive to start using the ipython directive AFAICT.<br><br></div><div>Ralf<br><br></div></div><br></div></div>