Return-Path: 
 <dev-return-25336-apmail-felix-dev-archive=felix.apache.org@felix.apache.org>
Delivered-To: apmail-felix-dev-archive@www.apache.org
Received: (qmail 80069 invoked from network); 14 Oct 2010 13:48:26 -0000
Received: from unknown (HELO mail.apache.org) (140.211.11.3)
  by 140.211.11.9 with SMTP; 14 Oct 2010 13:48:26 -0000
Received: (qmail 33438 invoked by uid 500); 14 Oct 2010 13:48:26 -0000
Delivered-To: apmail-felix-dev-archive@felix.apache.org
Received: (qmail 33232 invoked by uid 500); 14 Oct 2010 13:48:24 -0000
Mailing-List: contact dev-help@felix.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:dev-help@felix.apache.org>
List-Unsubscribe: <mailto:dev-unsubscribe@felix.apache.org>
List-Post: <mailto:dev@felix.apache.org>
List-Id: <dev.felix.apache.org>
Reply-To: dev@felix.apache.org
Delivered-To: mailing list dev@felix.apache.org
Received: (qmail 33224 invoked by uid 99); 14 Oct 2010 13:48:24 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 14 Oct 2010 13:48:24 +0000
X-ASF-Spam-Status: No, hits=-0.0 required=10.0
	tests=SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: local policy)
Received: from [147.228.57.19] (HELO fred.zcu.cz) (147.228.57.19)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 14 Oct 2010 13:48:19 +0000
Received: from [IPv6:2001:718:1801:1a02:200:5efe:147.228.182.229] (unknown
 [IPv6:2001:718:1801:1a02:200:5efe:93e4:b6e5])
	(Authenticated sender: brada)
	by fred.zcu.cz (Postfix) with ESMTPSA id 87225A00378D;
	Thu, 14 Oct 2010 15:47:52 +0200 (CEST)
Message-ID: <4CB70A06.2030601@kiv.zcu.cz>
Date: Thu, 14 Oct 2010 15:47:50 +0200
From: Premek Brada <brada@kiv.zcu.cz>
Reply-To: brada@kiv.zcu.cz
Organization: University of West Bohemia, Pilsen, CZ
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US;
 rv:1.9.2.9) Gecko/20100915 Thunderbird/3.1.4
MIME-Version: 1.0
To: dev@felix.apache.org
CC: "Richard S. Hall" <heavy@ungoverned.org>
Subject: Re: Documenting API evolution
References: <4CB6A7B6.20306@gmail.com> <4CB6FE99.1030503@ungoverned.org>
In-Reply-To: <4CB6FE99.1030503@ungoverned.org>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-ZCU-MailScanner-ID: 87225A00378D.A1C39
X-ZCU-MailScanner: Found to be clean
X-ZCU-MailScanner-SpamCheck: not spam, SpamAssassin (not cached,
	score=-102.9, required 5, autolearn=not spam, ALL_TRUSTED -1.00,
	BAYES_00 -1.90, USER_IN_WHITELIST -100.00)
X-ZCU-MailScanner-From: brada@kiv.zcu.cz
X-Old-Spam-Status: No

  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>>