[rrd-developers] it exposes too much ...
tobi at oetiker.ch
Tue Jun 10 13:20:44 CEST 2008
well until now, we did export everything, so in 1.3 there will be
the first step in cleaning this up by exporting+documenting the
bits that we want to export, and export-documenting the bits that
some people may be using.
In 1.4 the whole business will be finished by bringing it all in
line: only export what is documented ...
I am also not a friend of people hitting on the head with smelly
Today Florian Forster wrote:
> On Mon, Jun 09, 2008 at 06:07:42PM +0200, Tobi Oetiker wrote:
> > So how about this. We export the symbols but do NOT put them in rrd.h.
> > this means that if someone wants to code, using them, it will work,
> > but it will also mean that they have to use our private headers for
> > compilation, makeing it clear that there is not guarantee for support
> > in future versions ...
> I think undocumented (i. e. not in the header file) features (i. e.
> exported symbols) are the devil's approach to software development.
> Not documenting features essentially means that _less_ people use them,
> but you're stuck with the very same problems as if everybody used them.
> So, for versions 1. I'd favor one of these two options:
> - Fully support those functions. This means to export and document those
> functions and to increase the SONAME if 1.4 removes/changes the
> Not the worst solution imho: People who used (so far undocumented!)
> functions will have to adapt their code for 1.4, but that's progress
> and accounted for by the SONAME bump.
> - Don't export these functions at all. This will break code using
> undocumented features _now_ (instead of when 1.4 is released). Hit
> everyone who comes whining over the head with something smelly. Then
> ask them what they need(ed) the functions for and make sure your new
> interface can handle those cases. Maybe someone even ports the changes
> back to 1.3..?
> Just my $.02, but I'd hate to see you make the same mistake Microsoft
> has been doing for years.. ;)
Tobi Oetiker, OETIKER+PARTNER AG, Aarweg 15 CH-4600 Olten
http://it.oetiker.ch tobi at oetiker.ch ++41 62 213 9902
More information about the rrd-developers