[wxPython-dev] SoC Unit Test Status

[Frank Tobia]

Kevin,

On 7/11/07, Kevin Ollivier <kevino at theolliviers.com> wrote:
>
>
> One last question for Frank. I noticed you have an assert for missing
> wx.Slider.GetRange(). AFAICT, that function is not part of the wx.SliderA=
PI. It probably SHOULD be, as we have SetRange(min, max), but right now you
> get the values by calling GetMin() and GetMax(). It was probably done this
> way because in C++ returning two values is difficult and they didn't want=
 to
> use wx.Size or wx.Point for it, so they just stuck with the GetMin/GetMax
> functions.
>
> I included that test because of pg.207 in "wxPython in Action": Table 7.1=
0shows a GetRange function.  Perhaps this should be an erratum?

This point raises a greater issue.  In the absence of online docs, we can
sometimes defer to "wxPython in Action."  In these cases, or in cases where
docs and book conflict, which is to be considered canon?  Should docs
reflect code, and "wxPython in Action" reflect docs?  Should the docs, and
the book as well, specify a contract against which the code must conform?  I
feel this is an important issue which needs clarification.

-Frank
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.wxwidgets.org/pipermail/wxpython-dev/attachments/20070711=
/b0834275/attachment.htm