felix-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Premek Brada <br...@kiv.zcu.cz>
Subject Re: Documenting API evolution
Date Thu, 14 Oct 2010 13:47:50 GMT
  On 14.10.2010 14:59, Richard S. Hall wrote:
>  On 10/14/10 2:48, Felix Meschberger wrote:
>> <snip>
>>      /**
>>       * ...
>>       *
>>       * @since 3.1.2; Web Console Bundle 3.1.4
>>       */
>>      public static final String CONFIG_PRINTER_MODES =...
>>
>> Does this make sense in terms of "good practice" ?
>
> Certainly using the package version makes sense. I think the bundle 
> version makes less sense since the packages could be re-packaged into 
> other bundles, like we do with the OSGi API and others. But it doesn't 
> harm anything.

I agree.  Also I'd think that using bundle symbolic name in the tag 
might be safer than the descriptive name because it is more stable.

Premek


-- 
Premek Brada (Ing et MSc, PhD)
   Lecturer in Software enginering, Webmaster
   Department of Computer Science and Engineering
   University of West Bohemia, Pilsen, CZ
   <<  brada at kiv.zcu.cz | www.kiv.zcu.cz/~brada/ | +420-377-63-2435>>


Mime
View raw message