On Sep 9, 2005, at 9:19 AM, Paul McNett wrote:
Think of it how it pertains to Dabo: do you want our users, when perusing the Dabo documentation, to see the registerObject() function, when it really doesn't pertain to anything they need to do and is outside of the intended API? If you want users calling registerObject() directly, then it should not have an underscore. Otherwise, it should.
There are a ton of methods like that throughout Dabo. I've always written my code from the POV of the Python standard, and I think if someone was looking at our code and saw 'self.Form._anything ()', they'd think that we were pretty lax.
If you are concerned about someone browsing the docs or code, then all we need to do is add info in the docstring to indicate that it is not to be called by user code.
-- Ed Leafe -- http://leafe.com -- http://dabodev.com _______________________________________________ Post Messages to: [email protected] Subscription Maintenance: http://leafe.com/mailman/listinfo/dabo-dev
