Re: [PATCH] First cut at 1954 solution

"C. Michael Pilato" <cmpilato@collab.net> writes:
> I'm a big fan of APIs that list every return value, but haven't the
> time or energy to retroactively do this for Subversion. That said,
> we are pretty good about listing return codes that we anticipate
> callers explicitly testing for. I anticipate callers testing the
> return value of this function (beyond just "is errorful").

We also have a policy of documenting any error codes that callers test
explicitly.

That is, if function A calls function B, and B can return a variety of
errors, and A tests for some of those errors, then B documents at
least those specific error codes and the circumstances under which
they can be returned.

-Karl

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Dec 7 03:46:20 2004