Re: CS question: do private function namechanges count as API changes?
| From: | Greg Beaver | Date: | Sat, 17 Nov 2007 06:12:23 +0000 |
| Subject: | Re: CS question: do private function namechanges count as API changes? | ||
| References: | 1 2 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-48477@lists.php.net to get a copy of this message | ||
Chuck Burgess wrote:
> On Nov 16, 2007 12:36 PM, Jorrit Schippers <jorrit@ncode.nl> wrote:
>
>> I've read that API changes are not recommended, but do private method
>> changes count as API methods? And should I change it to determineOSMatch(),
>> _determineOSMatch() or perhaps (_)determineOsMatch()?
>>
>
> My gut reaction would be private *anything* is fair game, as by definition
> anything *private* is not part of a library's "API". However, others that
> have been in PEAR longer than me should definitely confirm this, as I'd bet
> the question has come up and been discussed before.
Confirmed. This is why documentation is important. By definition,
private means don't use this, as it is not for public consumption and
therefore can change on a moment's notice.
Greg