On Wed, Apr 22, 2009 at 12:09:28PM -0500, Shawn Walker wrote: > Tom Mueller wrote: >> Any class that is referenced via any parameters or return values from >> the public API (the api module) is also part of the public API. The 3rd >> parameter to the ImageInterface constructor is a ProgressTracker >> object. So this exposes ProgressTracker as part of the public API. > > Not quite. The progresstracker, despite its exposure, has never been > declared to be a part of the public client API, although it obviously > needs to be at some point, but right now there are no guarantees > surrounding it. Of course, technically, since pkg(5) isn't a reviewed > project, there are no guarantees surrounding it period.
The ProgressTracker is likley going to change as part of the transport rework. If it's not part of the initial putback, it will certainly change as follow-on transport modifications occur. (The first transport putback is probably going to duplicate the existing functionality with a few feature improvements.) I'm reserving the right to change the ProgressTracker as part of this work. Once the transport has sedimented more, we can talk about turning the ProgressTracker into an API. However, it's premature to do so now. -j _______________________________________________ pkg-discuss mailing list [email protected] http://mail.opensolaris.org/mailman/listinfo/pkg-discuss
