Re: Undocumented internal function

[John W. Eaton]

On  1-Sep-2010, Jordi Gutiérrez Hermoso wrote:

| 2010/9/1 Søren Hauberg <address@hidden>:
| > By documenting these functions we are encouraging people to use it.
| 
| This, this is *precisely* the attitude that I want to deprecate. That
| it's desirable and good to consciously choose to not document
| functions and that we'd be doing some sort of damage if we document
| them, that users need to be consciously herded for their own good.
| It's a paternalistic attitude, that users are too dumb and we need to
| steer them by not documenting functions.

That's not what it is about.

What we are saying is that if we could, we would make these functions
inaccessible to ordinary uses, similar to the way C++ classes have
private methods.

jwe