[arc-discuss] When should interfaces be private?

[Shawn Walker]

On Fri, May 2, 2008 at 11:47 AM, James Carlson <james.d.carlson at sun.com> wrote:
> Shawn Walker writes:
>  > The point is that, if I was a shareholder, I wouldn't want Sun
>  > spending money on documenting things that they don't intend others to
>  > use.
>
>  We do, though.  Visit the ARC repository some time.  Or read any of
>  the design documents that've been published.  Or look at the header
>  files and source if you choose.
>
>  Documentation of private interfaces does in fact exist, and we often
>  work hard to make it correct.  It's not published (as man pages)
>  intentionally, and nothing that hasn't established an ARC contract can
>  depend on it, though.

I didn't mean documentation in that sense, I meant the sort of
documentation you found on docs.sun.com, and maintain.

-- 
Shawn Walker

"To err is human -- and to blame it on a computer is even more so." -
Robert Orben