<div class="gmail_quote">On Fri, Jun 10, 2011 at 7:22 AM, Steven D'Aprano <span dir="ltr"><<a href="mailto:steve@pearwood.info">steve@pearwood.info</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div class="im">David Stanek wrote:<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
How would a tool know if the behavior of a method changed without analyzing<br>
the code? I think this could very easily lead to a situation where a<br>
project's generated documentation is incorrect.<br>
</blockquote>
<br>
<br></div>
That's the developer's problem, and no different from any other case where you inherit data without ensuring it is the correct data.<br></blockquote><div><br></div><div>This means that a significant amount of existing code may/will have problems with this type of change. If Sphinx did this automatically I'm sure there would be lots of incorrect documentation. I think the developer should explicitly carry over and modify the documentation if necessary.</div>
<div><br></div></div><br>-- <br>David<br>blog: <a href="http://www.traceback.org" target="_blank">http://www.traceback.org</a><br>twitter: <a href="http://twitter.com/dstanek" target="_blank">http://twitter.com/dstanek</a><div>
www: <a href="http://dstanek.com" target="_blank">http://dstanek.com</a></div><br>