Hi Florian, 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 things :-) cheers tobi Today Florian Forster wrote: > Hi, > > 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.[23] 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 > functions/interface. > 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.. ;) > > Regards, > -octo > -- Tobi Oetiker, OETIKER+PARTNER AG, Aarweg 15 CH-4600 Olten http://it.oetiker.ch [EMAIL PROTECTED] ++41 62 213 9902 _______________________________________________ rrd-developers mailing list [email protected] https://lists.oetiker.ch/cgi-bin/listinfo/rrd-developers
