svn commit: r1432570 - in /felix/site/trunk/content: documentation/development/provisional-osgi-api-policy.mdtext site/provisional-osgi-api-policy.html

[fm...@apache.org]

Author: fmeschbe
Date: Sun Jan 13 09:58:04 2013
New Revision: 1432570

URL: http://svn.apache.org/viewvc?rev=1432570&view=rev
Log:
Finalize migration of provisional OSGi API policy

Removed:
    felix/site/trunk/content/site/provisional-osgi-api-policy.html
Modified:
    felix/site/trunk/content/documentation/development/provisional-osgi-api-policy.mdtext

Modified: felix/site/trunk/content/documentation/development/provisional-osgi-api-policy.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/development/provisional-osgi-api-policy.mdtext?rev=1432570&r1=1432569&r2=1432570&view=diff
==============================================================================
--- felix/site/trunk/content/documentation/development/provisional-osgi-api-policy.mdtext (original)
+++ felix/site/trunk/content/documentation/development/provisional-osgi-api-policy.mdtext Sun Jan 13 09:58:04 2013
@@ -1,8 +1,5 @@
-translation_pending: true
 Title: Provisional OSGi API Policy
 
-# Provisional OSGi API policy
-
 ## Overview
 
 The OSGi Alliance exposes provisional API through draft specification releases. Additionally, some Felix contributors work for OSGi Alliance member companies and have access to provisional OSGi API. Often, Felix subprojects want to experiment with and/or implement provisional OSGi API. In some cases, Felix subprojects may actually be the reference implementation for the specification in question. This creates potentially confusing or questionable situations.
@@ -23,6 +20,14 @@ Since subprojects will still want to imp
 1. All Felix provisional API must be marked as deprecated.
 1. All Felix provisional API exported from bundles should be exported with a mandatory attribute of `status="provisional"`.
 
+For example to provisionally export the `org.apache.felix.service.metatype` package, the
+`Export-Package` statement would look something like this:
+
+    :::xml
+    <Export-Package>
+      org.apache.felix.service.metatype; version="0.1"; mandatory="status"; status="provisional"
+    </Export-Package>
+
 When working with new specifications, this will likely result in parallel package structures between the provisional OSGi and Felix APIs. When working with existing specifications, it may be necessary to create extensions to existing OSGi interfaces in the Felix package namespace.
 
 ## Policy rationale