public/private/stable/unstable

[Aaron Bentley]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Robert Collins wrote:
> On Tue, 2008-08-26 at 19:33 -0400, Aaron Bentley wrote:
> What I want is a way to signal 'unsupported but you can use it without
> violating abstraction' (that is unsupported-and-public). Now, I'm happy
> to signal that purely with comments, as I did in my most recent patch.
> IF other folk are happy with that.
> 
> So can we do :
>  _ -> unsupported-AND-private
> no _ -> read the docstring

I would like people to be able to tell, at a glance, when a method is
completely safe to use.  I think requiring reading the docstring of
every non _ method would be burdensome.

How about:
_ -> unsupported-AND-private unless the docstring says otherwise
no _ -> supported and public.

So you'd signal unsupported-and-public using a _ with a docstring.

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFItJc90F+nu1YWqI0RAiJ0AJsHHcoHQm83RYSVIOmMJtxwR+5ChQCeOopk
pjbCLZk52j7H8Yp6FomvRB8=
=qaij
-----END PGP SIGNATURE-----