# HG changeset patch
# User Frank Benoit <benoit@tionex.de>
# Date 1239708176 -7200
# Node ID 0628aaa2996c10fd666000777fd13c6fa4f13b5f
# Parent  b2d6122fa18956d189a75a7693adb3ce71593a9f
added osgi FramworkLog

diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/osgi/src/org/osgi/framework/Bundle.d
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.eclipse.osgi/osgi/src/org/osgi/framework/Bundle.d	Tue Apr 14 13:22:56 2009 +0200
@@ -0,0 +1,1122 @@
+/*
+ * $Header: /cvshome/build/org.osgi.framework/src/org/osgi/framework/Bundle.java,v 1.54 2007/02/21 16:49:05 hargrave Exp $
+ *
+ * Copyright (c) OSGi Alliance (2000, 2007). All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+module org.osgi.framework.Bundle;
+
+import java.lang.all;
+
+// import java.io.IOException;
+// import java.io.InputStream;
+// import java.net.URL;
+// import java.util.Dictionary;
+// import java.util.Enumeration;
+
+/**
+ * An installed bundle in the Framework.
+ *
+ * <p>
+ * A <code>Bundle</code> object is the access point to define the lifecycle of
+ * an installed bundle. Each bundle installed in the OSGi environment must have
+ * an associated <code>Bundle</code> object.
+ *
+ * <p>
+ * A bundle must have a unique identity, a <code>long</code>, chosen by the
+ * Framework. This identity must not change during the lifecycle of a bundle,
+ * even when the bundle is updated. Uninstalling and then reinstalling the
+ * bundle must create a new unique identity.
+ *
+ * <p>
+ * A bundle can be in one of six states:
+ * <ul>
+ * <li>{@link #UNINSTALLED}
+ * <li>{@link #INSTALLED}
+ * <li>{@link #RESOLVED}
+ * <li>{@link #STARTING}
+ * <li>{@link #STOPPING}
+ * <li>{@link #ACTIVE}
+ * </ul>
+ * <p>
+ * Values assigned to these states have no specified ordering; they represent
+ * bit values that may be ORed together to determine if a bundle is in one of
+ * the valid states.
+ *
+ * <p>
+ * A bundle should only execute code when its state is one of
+ * <code>STARTING</code>,<code>ACTIVE</code>, or <code>STOPPING</code>.
+ * An <code>UNINSTALLED</code> bundle can not be set to another state; it is a
+ * zombie and can only be reached because references are kept somewhere.
+ *
+ * <p>
+ * The Framework is the only entity that is allowed to create
+ * <code>Bundle</code> objects, and these objects are only valid within the
+ * Framework that created them.
+ *
+ * @ThreadSafe
+ * @version $Revision: 1.54 $
+ */
+public interface Bundle {
+    /**
+     * The bundle is uninstalled and may not be used.
+     *
+     * <p>
+     * The <code>UNINSTALLED</code> state is only visible after a bundle is
+     * uninstalled; the bundle is in an unusable state but references to the
+     * <code>Bundle</code> object may still be available and used for
+     * introspection.
+     * <p>
+     * The value of <code>UNINSTALLED</code> is 0x00000001.
+     */
+    public static const int UNINSTALLED             = 0x00000001;
+
+    /**
+     * The bundle is installed but not yet resolved.
+     *
+     * <p>
+     * A bundle is in the <code>INSTALLED</code> state when it has been
+     * installed in the Framework but is not or cannot be resolved.
+     * <p>
+     * This state is visible if the bundle's code dependencies are not resolved.
+     * The Framework may attempt to resolve an <code>INSTALLED</code> bundle's
+     * code dependencies and move the bundle to the <code>RESOLVED</code>
+     * state.
+     * <p>
+     * The value of <code>INSTALLED</code> is 0x00000002.
+     */
+    public static const int INSTALLED               = 0x00000002;
+
+    /**
+     * The bundle is resolved and is able to be started.
+     *
+     * <p>
+     * A bundle is in the <code>RESOLVED</code> state when the Framework has
+     * successfully resolved the bundle's code dependencies. These dependencies
+     * include:
+     * <ul>
+     * <li>The bundle's class path from its {@link Constants#BUNDLE_CLASSPATH}
+     * Manifest header.
+     * <li>The bundle's package dependencies from its
+     * {@link Constants#EXPORT_PACKAGE} and {@link Constants#IMPORT_PACKAGE}
+     * Manifest headers.
+     * <li>The bundle's required bundle dependencies from its
+     * {@link Constants#REQUIRE_BUNDLE} Manifest header.
+     * <li>A fragment bundle's host dependency from its
+     * {@link Constants#FRAGMENT_HOST} Manifest header.
+     * </ul>
+     * <p>
+     * Note that the bundle is not active yet. A bundle must be put in the
+     * <code>RESOLVED</code> state before it can be started. The Framework may
+     * attempt to resolve a bundle at any time.
+     * <p>
+     * The value of <code>RESOLVED</code> is 0x00000004.
+     */
+    public static const int RESOLVED                = 0x00000004;
+
+    /**
+     * The bundle is in the process of starting.
+     *
+     * <p>
+     * A bundle is in the <code>STARTING</code> state when its
+     * {@link #start(int) start} method is active. A bundle must be in this
+     * state when the bundle's {@link BundleActivator#start} is called. If the
+     * <code>BundleActivator.start</code> method completes without exception,
+     * then the bundle has successfully started and must move to the
+     * <code>ACTIVE</code> state.
+     * <p>
+     * If the bundle has a
+     * {@link Constants#ACTIVATION_LAZY lazy activation policy}, then the
+     * bundle may remain in this state for some time until the activation is
+     * triggered.
+     * <p>
+     * The value of <code>STARTING</code> is 0x00000008.
+     */
+    public static const int STARTING                = 0x00000008;
+
+    /**
+     * The bundle is in the process of stopping.
+     *
+     * <p>
+     * A bundle is in the <code>STOPPING</code> state when its
+     * {@link #stop(int) stop} method is active. A bundle must be in this state
+     * when the bundle's {@link BundleActivator#stop} method is called. When the
+     * <code>BundleActivator.stop</code> method completes the bundle is
+     * stopped and must move to the <code>RESOLVED</code> state.
+     * <p>
+     * The value of <code>STOPPING</code> is 0x00000010.
+     */
+    public static const int STOPPING                = 0x00000010;
+
+    /**
+     * The bundle is now running.
+     *
+     * <p>
+     * A bundle is in the <code>ACTIVE</code> state when it has been
+     * successfully started and activated.
+     * <p>
+     * The value of <code>ACTIVE</code> is 0x00000020.
+     */
+    public static const int ACTIVE                  = 0x00000020;
+
+    /**
+     * The bundle start operation is transient and the persistent autostart
+     * setting of the bundle is not modified.
+     *
+     * <p>
+     * This bit may be set when calling {@link #start(int)} to notify the
+     * framework that the autostart setting of the bundle must not be modified.
+     * If this bit is not set, then the autostart setting of the bundle is
+     * modified.
+     *
+     * @since 1.4
+     * @see #start(int)
+     */
+    public static const int START_TRANSIENT         = 0x00000001;
+
+    /**
+     * The bundle start operation must activate the bundle according to the
+     * bundle's declared
+     * {@link Constants#BUNDLE_ACTIVATIONPOLICY activation policy}.
+     *
+     * <p>
+     * This bit may be set when calling {@link #start(int)} to notify the
+     * framework that the bundle must be activated using the bundle's declared
+     * activation policy.
+     *
+     * @since 1.4
+     * @see Constants#BUNDLE_ACTIVATIONPOLICY
+     * @see #start(int)
+     */
+    public static const int START_ACTIVATION_POLICY = 0x00000002;
+
+    /**
+     * The bundle stop is transient and the persistent autostart setting of the
+     * bundle is not modified.
+     *
+     * <p>
+     * This bit may be set when calling {@link #stop(int)} to notify the
+     * framework that the autostart setting of the bundle must not be modified.
+     * If this bit is not set, then the autostart setting of the bundle is
+     * modified.
+     *
+     * @since 1.4
+     * @see #stop(int)
+     */
+    public static final int STOP_TRANSIENT          = 0x00000001;
+
+    /**
+     * Returns this bundle's current state.
+     *
+     * <p>
+     * A bundle can be in only one state at any time.
+     *
+     * @return An element of <code>UNINSTALLED</code>,<code>INSTALLED</code>,
+     *         <code>RESOLVED</code>,<code>STARTING</code>,
+     *         <code>STOPPING</code>,<code>ACTIVE</code>.
+     */
+    public int getState();
+
+    /**
+     * Starts this bundle.
+     *
+     * <p>
+     * If this bundle's state is <code>UNINSTALLED</code> then an
+     * <code>IllegalStateException</code> is thrown.
+     * <p>
+     * If the Framework implements the optional Start Level service and the
+     * current start level is less than this bundle's start level:
+     * <ul>
+     * <li>If the {@link #START_TRANSIENT} option is set, then a
+     * <code>BundleException</code> is thrown indicating this bundle cannot be
+     * started due to the Framework's current start level.
+     *
+     * <li>Otherwise, the Framework must set this bundle's persistent autostart
+     * setting to <em>Started with declared activation</em> if the
+     * {@link #START_ACTIVATION_POLICY} option is set or
+     * <em>Started with eager activation</em> if not set.
+     * </ul>
+     * <p>
+     * When the Framework's current start level becomes equal to or more than
+     * this bundle's start level, this bundle will be started.
+     * <p>
+     * Otherwise, the following steps are required to start this bundle:
+     * <ol>
+     * <li>If this bundle is in the process of being activated or deactivated
+     * then this method must wait for activation or deactivation to complete
+     * before continuing. If this does not occur in a reasonable time, a
+     * <code>BundleException</code> is thrown to indicate this bundle was
+     * unable to be started.
+     *
+     * <li>If this bundle's state is <code>ACTIVE</code> then this method
+     * returns immediately.
+     *
+     * <li>If the {@link #START_TRANSIENT} option is not set then set this
+     * bundle's autostart setting to <em>Started with declared activation</em>
+     * if the {@link #START_ACTIVATION_POLICY} option is set or
+     * <em>Started with eager activation</em> if not set. When the Framework
+     * is restarted and this bundle's autostart setting is not <em>Stopped</em>,
+     * this bundle must be automatically started.
+     *
+     * <li>If this bundle's state is not <code>RESOLVED</code>, an attempt
+     * is made to resolve this bundle. If the Framework cannot resolve this
+     * bundle, a <code>BundleException</code> is thrown.
+     *
+     * <li>If the {@link #START_ACTIVATION_POLICY} option is set and this
+     * bundle's declared activation policy is
+     * {@link Constants#ACTIVATION_LAZY lazy} then:
+     * <ul>
+     * <li>If this bundle's state is <code>STARTING</code> then this method
+     * returns immediately.
+     * <li>This bundle's state is set to <code>STARTING</code>.
+     * <li>A bundle event of type {@link BundleEvent#LAZY_ACTIVATION} is fired.
+     * <li>This method returns immediately and the remaining steps will be
+     * followed when this bundle's activation is later triggered.
+     * </ul>
+     * <i></i>
+     * <li>This bundle's state is set to <code>STARTING</code>.
+     *
+     * <li>A bundle event of type {@link BundleEvent#STARTING} is fired.
+     *
+     * <li>The {@link BundleActivator#start} method of this bundle's
+     * <code>BundleActivator</code>, if one is specified, is called. If the
+     * <code>BundleActivator</code> is invalid or throws an exception then:
+     * <ul>
+     * <li>This bundle's state is set to <code>STOPPING</code>.
+     * <li>A bundle event of type {@link BundleEvent#STOPPING} is fired.
+     * <li>Any services registered by this bundle must be unregistered.
+     * <li>Any services used by this bundle must be released.
+     * <li>Any listeners registered by this bundle must be removed.
+     * <li>This bundle's state is set to <code>RESOLVED</code>.
+     * <li>A bundle event of type {@link BundleEvent#STOPPED} is fired.
+     * <li>A <code>BundleException</code> is then thrown.
+     * </ul>
+     * <i></i>
+     * <li>If this bundle's state is <code>UNINSTALLED</code>, because this
+     * bundle was uninstalled while the <code>BundleActivator.start</code>
+     * method was running, a <code>BundleException</code> is thrown.
+     *
+     * <li>This bundle's state is set to <code>ACTIVE</code>.
+     *
+     * <li>A bundle event of type {@link BundleEvent#STARTED} is fired.
+     * </ol>
+     *
+     * <b>Preconditions </b>
+     * <ul>
+     * <li><code>getState()</code> in {<code>INSTALLED</code>,
+     * <code>RESOLVED</code>} or {<code>INSTALLED</code>,
+     * <code>RESOLVED</code>, <code>STARTING</code>} if this bundle has a
+     * lazy activation policy.
+     * </ul>
+     * <b>Postconditions, no exceptions thrown </b>
+     * <ul>
+     * <li>Bundle autostart setting is modified unless the
+     * {@link #START_TRANSIENT} option was set.
+     * <li><code>getState()</code> in {<code>ACTIVE</code>} unless the
+     * lazy activation policy was used.
+     * <li><code>BundleActivator.start()</code> has been called and did not
+     * throw an exception unless the lazy activation policy was used.
+     * </ul>
+     * <b>Postconditions, when an exception is thrown </b>
+     * <ul>
+     * <li>Depending on when the exception occurred, bundle autostart setting
+     * is modified unless the {@link #START_TRANSIENT} option was set.
+     * <li><code>getState()</code> not in {<code>STARTING</code>,
+     * <code>ACTIVE</code>}.
+     * </ul>
+     *
+     * @param options The options for starting this bundle. See
+     *        {@link #START_TRANSIENT} and {@link #START_ACTIVATION_POLICY}.
+     *        The Framework must ignore unrecognized options.
+     * @throws BundleException If this bundle could not be started. This could
+     *         be because a code dependency could not be resolved or the
+     *         specified <code>BundleActivator</code> could not be loaded or
+     *         threw an exception or this bundle is a fragment.
+     * @throws java.lang.IllegalStateException If this bundle has been
+     *         uninstalled or this bundle tries to change its own state.
+     * @throws java.lang.SecurityException If the caller does not have the
+     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
+     *         the Java Runtime Environment supports permissions.
+     * @since 1.4
+     */
+    public void start(int options);
+
+    /**
+     * Starts this bundle with no options.
+     *
+     * <p>
+     * This method calls <code>start(0)</code>.
+     *
+     * @throws BundleException If this bundle could not be started. This could
+     *         be because a code dependency could not be resolved or the
+     *         specified <code>BundleActivator</code> could not be loaded or
+     *         threw an exception or this bundle is a fragment.
+     * @throws java.lang.IllegalStateException If this bundle has been
+     *         uninstalled or this bundle tries to change its own state.
+     * @throws java.lang.SecurityException If the caller does not have the
+     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
+     *         the Java Runtime Environment supports permissions.
+     * @see #start(int)
+     */
+    public void start();
+
+    /**
+     * Stops this bundle.
+     *
+     * <p>
+     * The following steps are required to stop a bundle:
+     * <ol>
+     * <li>If this bundle's state is <code>UNINSTALLED</code> then an
+     * <code>IllegalStateException</code> is thrown.
+     *
+     * <li>If this bundle is in the process of being activated or deactivated
+     * then this method must wait for activation or deactivation to complete
+     * before continuing. If this does not occur in a reasonable time, a
+     * <code>BundleException</code> is thrown to indicate this bundle was
+     * unable to be stopped.
+     * <li>If the {@link #STOP_TRANSIENT} option is not set then then set this
+     * bundle's persistent autostart setting to to <em>Stopped</em>. When the
+     * Framework is restarted and this bundle's autostart setting is
+     * <em>Stopped</em>, this bundle must not be automatically started.
+     *
+     * <li>If this bundle's state is not <code>ACTIVE</code> then this method
+     * returns immediately.
+     *
+     * <li>This bundle's state is set to <code>STOPPING</code>.
+     *
+     * <li>A bundle event of type {@link BundleEvent#STOPPING} is fired.
+     *
+     * <li>The {@link BundleActivator#stop} method of this bundle's
+     * <code>BundleActivator</code>, if one is specified, is called. If that
+     * method throws an exception, this method must continue to stop this
+     * bundle. A <code>BundleException</code> must be thrown after completion
+     * of the remaining steps.
+     *
+     * <li>Any services registered by this bundle must be unregistered.
+     * <li>Any services used by this bundle must be released.
+     * <li>Any listeners registered by this bundle must be removed.
+     *
+     * <li>If this bundle's state is <code>UNINSTALLED</code>, because this
+     * bundle was uninstalled while the <code>BundleActivator.stop</code>
+     * method was running, a <code>BundleException</code> must be thrown.
+     *
+     * <li>This bundle's state is set to <code>RESOLVED</code>.
+     *
+     * <li>A bundle event of type {@link BundleEvent#STOPPED} is fired.
+     * </ol>
+     *
+     * <b>Preconditions </b>
+     * <ul>
+     * <li><code>getState()</code> in {<code>ACTIVE</code>}.
+     * </ul>
+     * <b>Postconditions, no exceptions thrown </b>
+     * <ul>
+     * <li>Bundle autostart setting is modified unless the
+     * {@link #STOP_TRANSIENT} option was set.
+     * <li><code>getState()</code> not in {<code>ACTIVE</code>,
+     * <code>STOPPING</code>}.
+     * <li><code>BundleActivator.stop</code> has been called and did not
+     * throw an exception.
+     * </ul>
+     * <b>Postconditions, when an exception is thrown </b>
+     * <ul>
+     * <li>Bundle autostart setting is modified unless the
+     * {@link #STOP_TRANSIENT} option was set.
+     * </ul>
+     *
+     * @param options The options for stoping this bundle. See
+     *        {@link #STOP_TRANSIENT}. The Framework must ignore unrecognized
+     *        options.
+     * @throws BundleException If this bundle's <code>BundleActivator</code>
+     *         threw an exception or this bundle is a fragment.
+     * @throws java.lang.IllegalStateException If this bundle has been
+     *         uninstalled or this bundle tries to change its own state.
+     * @throws java.lang.SecurityException If the caller does not have the
+     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
+     *         the Java Runtime Environment supports permissions.
+     * @since 1.4
+     */
+    public void stop(int options);
+
+    /**
+     * Stops this bundle with no options.
+     *
+     * <p>
+     * This method calls <code>stop(0)</code>.
+     *
+     * @throws BundleException If this bundle's <code>BundleActivator</code>
+     *         threw an exception or this bundle is a fragment.
+     * @throws java.lang.IllegalStateException If this bundle has been
+     *         uninstalled or this bundle tries to change its own state.
+     * @throws java.lang.SecurityException If the caller does not have the
+     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
+     *         the Java Runtime Environment supports permissions.
+     * @see #start(int)
+     */
+    public void stop();
+
+    /**
+     * Updates this bundle.
+     *
+     * <p>
+     * If this bundle's state is <code>ACTIVE</code>, it must be stopped
+     * before the update and started after the update successfully completes.
+     *
+     * <p>
+     * If this bundle has exported any packages, these packages must not be
+     * updated. Instead, the previous package version must remain exported until
+     * the <code>PackageAdmin.refreshPackages</code> method has been has been
+     * called or the Framework is relaunched.
+     *
+     * <p>
+     * The following steps are required to update a bundle:
+     * <ol>
+     * <li>If this bundle's state is <code>UNINSTALLED</code> then an
+     * <code>IllegalStateException</code> is thrown.
+     *
+     * <li>If this bundle's state is <code>ACTIVE</code>,
+     * <code>STARTING</code> or <code>STOPPING</code>, this bundle is
+     * stopped as described in the <code>Bundle.stop</code> method. If
+     * <code>Bundle.stop</code> throws an exception, the exception is rethrown
+     * terminating the update.
+     *
+     * <li>The download location of the new version of this bundle is
+     * determined from either this bundle's
+     * {@link Constants#BUNDLE_UPDATELOCATION} Manifest header (if available) or
+     * this bundle's original location.
+     *
+     * <li>The location is interpreted in an implementation dependent manner,
+     * typically as a URL, and the new version of this bundle is obtained from
+     * this location.
+     *
+     * <li>The new version of this bundle is installed. If the Framework is
+     * unable to install the new version of this bundle, the original version of
+     * this bundle must be restored and a <code>BundleException</code> must be
+     * thrown after completion of the remaining steps.
+     *
+     * <li>If this bundle has declared an Bundle-RequiredExecutionEnvironment
+     * header, then the listed execution environments must be verified against
+     * the installed execution environments. If they do not all match, the
+     * original version of this bundle must be restored and a
+     * <code>BundleException</code> must be thrown after completion of the
+     * remaining steps.
+     *
+     * <li>This bundle's state is set to <code>INSTALLED</code>.
+     *
+     * <li>If the new version of this bundle was successfully installed, a
+     * bundle event of type {@link BundleEvent#UPDATED} is fired.
+     *
+     * <li>If this bundle's state was originally <code>ACTIVE</code>, the
+     * updated bundle is started as described in the <code>Bundle.start</code>
+     * method. If <code>Bundle.start</code> throws an exception, a Framework
+     * event of type {@link FrameworkEvent#ERROR} is fired containing the
+     * exception.
+     * </ol>
+     *
+     * <b>Preconditions </b>
+     * <ul>
+     * <li><code>getState()</code> not in {<code>UNINSTALLED</code>}.
+     * </ul>
+     * <b>Postconditions, no exceptions thrown </b>
+     * <ul>
+     * <li><code>getState()</code> in {<code>INSTALLED</code>,
+     * <code>RESOLVED</code>,<code>ACTIVE</code>}.
+     * <li>This bundle has been updated.
+     * </ul>
+     * <b>Postconditions, when an exception is thrown </b>
+     * <ul>
+     * <li><code>getState()</code> in {<code>INSTALLED</code>,
+     * <code>RESOLVED</code>,<code>ACTIVE</code>}.
+     * <li>Original bundle is still used; no update occurred.
+     * </ul>
+     *
+     * @throws BundleException If the update fails.
+     * @throws java.lang.IllegalStateException If this bundle has been
+     *         uninstalled or this bundle tries to change its own state.
+     * @throws java.lang.SecurityException If the caller does not have the
+     *         appropriate <code>AdminPermission[this,LIFECYCLE]</code> for
+     *         both the current bundle and the updated bundle, and the Java
+     *         Runtime Environment supports permissions.
+     * @see #stop()
+     * @see #start()
+     */
+    public void update();
+
+//     /**
+//      * Updates this bundle from an <code>InputStream</code>.
+//      *
+//      * <p>
+//      * This method performs all the steps listed in <code>Bundle.update()</code>,
+//      * except the new version of this bundle must be read from the supplied
+//      * <code>InputStream</code>, rather than a <code>URL</code>.
+//      * <p>
+//      * This method must always close the <code>InputStream</code> when it is
+//      * done, even if an exception is thrown.
+//      *
+//      * @param in The <code>InputStream</code> from which to read the new
+//      *        bundle.
+//      * @throws BundleException If the provided stream cannot be read or the
+//      *         update fails.
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled or this bundle tries to change its own state.
+//      * @throws java.lang.SecurityException If the caller does not have the
+//      *         appropriate <code>AdminPermission[this,LIFECYCLE]</code> for
+//      *         both the current bundle and the updated bundle, and the Java
+//      *         Runtime Environment supports permissions.
+//      * @see #update()
+//      */
+//     public void update(InputStream in_);
+//
+//     /**
+//      * Uninstalls this bundle.
+//      *
+//      * <p>
+//      * This method causes the Framework to notify other bundles that this bundle
+//      * is being uninstalled, and then puts this bundle into the
+//      * <code>UNINSTALLED</code> state. The Framework must remove any resources
+//      * related to this bundle that it is able to remove.
+//      *
+//      * <p>
+//      * If this bundle has exported any packages, the Framework must continue to
+//      * make these packages available to their importing bundles until the
+//      * <code>PackageAdmin.refreshPackages</code> method has been called or the
+//      * Framework is relaunched.
+//      *
+//      * <p>
+//      * The following steps are required to uninstall a bundle:
+//      * <ol>
+//      * <li>If this bundle's state is <code>UNINSTALLED</code> then an
+//      * <code>IllegalStateException</code> is thrown.
+//      *
+//      * <li>If this bundle's state is <code>ACTIVE</code>,
+//      * <code>STARTING</code> or <code>STOPPING</code>, this bundle is
+//      * stopped as described in the <code>Bundle.stop</code> method. If
+//      * <code>Bundle.stop</code> throws an exception, a Framework event of type
+//      * {@link FrameworkEvent#ERROR} is fired containing the exception.
+//      *
+//      * <li>This bundle's state is set to <code>UNINSTALLED</code>.
+//      *
+//      * <li>A bundle event of type {@link BundleEvent#UNINSTALLED} is fired.
+//      *
+//      * <li>This bundle and any persistent storage area provided for this bundle
+//      * by the Framework are removed.
+//      * </ol>
+//      *
+//      * <b>Preconditions </b>
+//      * <ul>
+//      * <li><code>getState()</code> not in {<code>UNINSTALLED</code>}.
+//      * </ul>
+//      * <b>Postconditions, no exceptions thrown </b>
+//      * <ul>
+//      * <li><code>getState()</code> in {<code>UNINSTALLED</code>}.
+//      * <li>This bundle has been uninstalled.
+//      * </ul>
+//      * <b>Postconditions, when an exception is thrown </b>
+//      * <ul>
+//      * <li><code>getState()</code> not in {<code>UNINSTALLED</code>}.
+//      * <li>This Bundle has not been uninstalled.
+//      * </ul>
+//      *
+//      * @throws BundleException If the uninstall failed. This can occur if
+//      *         another thread is attempting to change this bundle's state and
+//      *         does not complete in a timely manner.
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled or this bundle tries to change its own state.
+//      * @throws java.lang.SecurityException If the caller does not have the
+//      *         appropriate <code>AdminPermission[this,LIFECYCLE]</code>, and
+//      *         the Java Runtime Environment supports permissions.
+//      * @see #stop()
+//      */
+//     public void uninstall();
+//
+//     /**
+//      * Returns this bundle's Manifest headers and values. This method returns
+//      * all the Manifest headers and values from the main section of this
+//      * bundle's Manifest file; that is, all lines prior to the first blank line.
+//      *
+//      * <p>
+//      * Manifest header names are case-insensitive. The methods of the returned
+//      * <code>Dictionary</code> object must operate on header names in a
+//      * case-insensitive manner.
+//      *
+//      * If a Manifest header value starts with &quot;%&quot;, it must be
+//      * localized according to the default locale.
+//      *
+//      * <p>
+//      * For example, the following Manifest headers and values are included if
+//      * they are present in the Manifest file:
+//      *
+//      * <pre>
+//      *     Bundle-Name
+//      *     Bundle-Vendor
+//      *     Bundle-Version
+//      *     Bundle-Description
+//      *     Bundle-DocURL
+//      *     Bundle-ContactAddress
+//      * </pre>
+//      *
+//      * <p>
+//      * This method must continue to return Manifest header information while
+//      * this bundle is in the <code>UNINSTALLED</code> state.
+//      *
+//      * @return A <code>Dictionary</code> object containing this bundle's
+//      *         Manifest headers and values.
+//      *
+//      * @throws java.lang.SecurityException If the caller does not have the
+//      *         appropriate <code>AdminPermission[this,METADATA]</code>, and
+//      *         the Java Runtime Environment supports permissions.
+//      *
+//      * @see Constants#BUNDLE_LOCALIZATION
+//      */
+//     public Dictionary getHeaders();
+//
+//     /**
+//      * Returns this bundle's unique identifier. This bundle is assigned a unique
+//      * identifier by the Framework when it was installed in the OSGi
+//      * environment.
+//      *
+//      * <p>
+//      * A bundle's unique identifier has the following attributes:
+//      * <ul>
+//      * <li>Is unique and persistent.
+//      * <li>Is a <code>long</code>.
+//      * <li>Its value is not reused for another bundle, even after a bundle is
+//      * uninstalled.
+//      * <li>Does not change while a bundle remains installed.
+//      * <li>Does not change when a bundle is updated.
+//      * </ul>
+//      *
+//      * <p>
+//      * This method must continue to return this bundle's unique identifier while
+//      * this bundle is in the <code>UNINSTALLED</code> state.
+//      *
+//      * @return The unique identifier of this bundle.
+//      */
+//     public long getBundleId();
+//
+//     /**
+//      * Returns this bundle's location identifier.
+//      *
+//      * <p>
+//      * The location identifier is the location passed to
+//      * <code>BundleContext.installBundle</code> when a bundle is installed.
+//      * The location identifier does not change while this bundle remains
+//      * installed, even if this bundle is updated.
+//      *
+//      * <p>
+//      * This method must continue to return this bundle's location identifier
+//      * while this bundle is in the <code>UNINSTALLED</code> state.
+//      *
+//      * @return The string representation of this bundle's location identifier.
+//      * @throws java.lang.SecurityException If the caller does not have the
+//      *         appropriate <code>AdminPermission[this,METADATA]</code>, and
+//      *         the Java Runtime Environment supports permissions.
+//      */
+//     public String getLocation();
+//
+//     /**
+//      * Returns this bundle's <code>ServiceReference</code> list for all
+//      * services it has registered or <code>null</code> if this bundle has no
+//      * registered services.
+//      *
+//      * <p>
+//      * If the Java runtime supports permissions, a <code>ServiceReference</code>
+//      * object to a service is included in the returned list only if the caller
+//      * has the <code>ServicePermission</code> to get the service using at
+//      * least one of the named classes the service was registered under.
+//      *
+//      * <p>
+//      * The list is valid at the time of the call to this method, however, as the
+//      * Framework is a very dynamic environment, services can be modified or
+//      * unregistered at anytime.
+//      *
+//      * @return An array of <code>ServiceReference</code> objects or
+//      *         <code>null</code>.
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @see ServiceRegistration
+//      * @see ServiceReference
+//      * @see ServicePermission
+//      */
+//     public ServiceReference[] getRegisteredServices();
+//
+//     /**
+//      * Returns this bundle's <code>ServiceReference</code> list for all
+//      * services it is using or returns <code>null</code> if this bundle is not
+//      * using any services. A bundle is considered to be using a service if its
+//      * use count for that service is greater than zero.
+//      *
+//      * <p>
+//      * If the Java Runtime Environment supports permissions, a
+//      * <code>ServiceReference</code> object to a service is included in the
+//      * returned list only if the caller has the <code>ServicePermission</code>
+//      * to get the service using at least one of the named classes the service
+//      * was registered under.
+//      * <p>
+//      * The list is valid at the time of the call to this method, however, as the
+//      * Framework is a very dynamic environment, services can be modified or
+//      * unregistered at anytime.
+//      *
+//      * @return An array of <code>ServiceReference</code> objects or
+//      *         <code>null</code>.
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @see ServiceReference
+//      * @see ServicePermission
+//      */
+//     public ServiceReference[] getServicesInUse();
+//
+//     /**
+//      * Determines if this bundle has the specified permissions.
+//      *
+//      * <p>
+//      * If the Java Runtime Environment does not support permissions, this method
+//      * always returns <code>true</code>.
+//      * <p>
+//      * <code>permission</code> is of type <code>Object</code> to avoid
+//      * referencing the <code>java.security.Permission</code> class directly.
+//      * This is to allow the Framework to be implemented in Java environments
+//      * which do not support permissions.
+//      *
+//      * <p>
+//      * If the Java Runtime Environment does support permissions, this bundle and
+//      * all its resources including embedded JAR files, belong to the same
+//      * <code>java.security.ProtectionDomain</code>; that is, they must share
+//      * the same set of permissions.
+//      *
+//      * @param permission The permission to verify.
+//      *
+//      * @return <code>true</code> if this bundle has the specified permission
+//      *         or the permissions possessed by this bundle imply the specified
+//      *         permission; <code>false</code> if this bundle does not have the
+//      *         specified permission or <code>permission</code> is not an
+//      *         <code>instanceof</code> <code>java.security.Permission</code>.
+//      *
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      */
+//     public bool hasPermission(Object permission);
+//
+//     /**
+//      * Find the specified resource from this bundle.
+//      *
+//      * This bundle's class loader is called to search for the specified
+//      * resource. If this bundle's state is <code>INSTALLED</code>, this
+//      * method must attempt to resolve this bundle before attempting to get the
+//      * specified resource. If this bundle cannot be resolved, then only this
+//      * bundle must be searched for the specified resource. Imported packages
+//      * cannot be searched when this bundle has not been resolved. If this bundle
+//      * is a fragment bundle then <code>null</code> is returned.
+//      *
+//      * @param name The name of the resource. See
+//      *        <code>java.lang.ClassLoader.getResource</code> for a description
+//      *        of the format of a resource name.
+//      * @return A URL to the named resource, or <code>null</code> if the
+//      *         resource could not be found or if this bundle is a fragment
+//      *         bundle or if the caller does not have the appropriate
+//      *         <code>AdminPermission[this,RESOURCE]</code>, and the Java
+//      *         Runtime Environment supports permissions.
+//      *
+//      * @since 1.1
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @see #getEntry
+//      * @see #findEntries
+//      */
+//     public URL getResource(String name);
+//
+//     /**
+//      * Returns this bundle's Manifest headers and values localized to the
+//      * specified locale.
+//      *
+//      * <p>
+//      * This method performs the same function as
+//      * <code>Bundle.getHeaders()</code> except the manifest header values are
+//      * localized to the specified locale.
+//      *
+//      * <p>
+//      * If a Manifest header value starts with &quot;%&quot;, it must be
+//      * localized according to the specified locale. If a locale is specified and
+//      * cannot be found, then the header values must be returned using the
+//      * default locale. Localizations are searched for in the following order:
+//      *
+//      * <pre>
+//      *   bn + "_" + Ls + "_" + Cs + "_" + Vs
+//      *   bn + "_" + Ls + "_" + Cs
+//      *   bn + "_" + Ls
+//      *   bn + "_" + Ld + "_" + Cd + "_" + Vd
+//      *   bn + "_" + Ld + "_" + Cd
+//      *   bn + "_" + Ld
+//      *     bn
+//      * </pre>
+//      *
+//      * Where <code>bn</code> is this bundle's localization basename,
+//      * <code>Ls</code>, <code>Cs</code> and <code>Vs</code> are the
+//      * specified locale (language, country, variant) and <code>Ld</code>,
+//      * <code>Cd</code> and <code>Vd</code> are the default locale (language,
+//      * country, variant).
+//      *
+//      * If <code>null</code> is specified as the locale string, the header
+//      * values must be localized using the default locale. If the empty string
+//      * (&quot;&quot;) is specified as the locale string, the header values must
+//      * not be localized and the raw (unlocalized) header values, including any
+//      * leading &quot;%&quot;, must be returned.
+//      *
+//      * <p>
+//      * This method must continue to return Manifest header information while
+//      * this bundle is in the <code>UNINSTALLED</code> state, however the
+//      * header values must only be available in the raw and default locale
+//      * values.
+//      *
+//      * @param locale The locale name into which the header values are to be
+//      *        localized. If the specified locale is <code>null</code> then the
+//      *        locale returned by <code>java.util.Locale.getDefault</code> is
+//      *        used. If the specified locale is the empty string, this method
+//      *        will return the raw (unlocalized) manifest headers including any
+//      *        leading &quot;%&quot;.
+//      * @return A <code>Dictionary</code> object containing this bundle's
+//      *         Manifest headers and values.
+//      *
+//      * @throws java.lang.SecurityException If the caller does not have the
+//      *         appropriate <code>AdminPermission[this,METADATA]</code>, and
+//      *         the Java Runtime Environment supports permissions.
+//      *
+//      * @see #getHeaders()
+//      * @see Constants#BUNDLE_LOCALIZATION
+//      * @since 1.3
+//      */
+//     public Dictionary getHeaders(String locale);
+//
+//     /**
+//      * Returns the symbolic name of this bundle as specified by its
+//      * <code>Bundle-SymbolicName</code> manifest header. The name must be
+//      * unique, it is recommended to use a reverse domain name naming convention
+//      * like that used for java packages. If this bundle does not have a
+//      * specified symbolic name then <code>null</code> is returned.
+//      *
+//      * <p>
+//      * This method must continue to return this bundle's symbolic name while
+//      * this bundle is in the <code>UNINSTALLED</code> state.
+//      *
+//      * @return The symbolic name of this bundle.
+//      * @since 1.3
+//      */
+//     public String getSymbolicName();
+//
+//     /**
+//      * Loads the specified class using this bundle's classloader.
+//      *
+//      * <p>
+//      * If this bundle is a fragment bundle then this method must throw a
+//      * <code>ClassNotFoundException</code>.
+//      *
+//      * <p>
+//      * If this bundle's state is <code>INSTALLED</code>, this method must
+//      * attempt to resolve this bundle before attempting to load the class.
+//      *
+//      * <p>
+//      * If this bundle cannot be resolved, a Framework event of type
+//      * {@link FrameworkEvent#ERROR} is fired containing a
+//      * <code>BundleException</code> with details of the reason this bundle
+//      * could not be resolved. This method must then throw a
+//      * <code>ClassNotFoundException</code>.
+//      *
+//      * <p>
+//      * If this bundle's state is <code>UNINSTALLED</code>, then an
+//      * <code>IllegalStateException</code> is thrown.
+//      *
+//      * @param name The name of the class to load.
+//      * @return The Class object for the requested class.
+//      * @throws java.lang.ClassNotFoundException If no such class can be found or
+//      *         if this bundle is a fragment bundle or if the caller does not
+//      *         have the appropriate <code>AdminPermission[this,CLASS]</code>,
+//      *         and the Java Runtime Environment supports permissions.
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @since 1.3
+//      */
+//     public Class loadClass(String name) throws ClassNotFoundException;
+//
+//     /**
+//      * Find the specified resources from this bundle.
+//      *
+//      * This bundle's class loader is called to search for the specified
+//      * resources. If this bundle's state is <code>INSTALLED</code>, this
+//      * method must attempt to resolve this bundle before attempting to get the
+//      * specified resources. If this bundle cannot be resolved, then only this
+//      * bundle must be searched for the specified resources. Imported packages
+//      * cannot be searched when a bundle has not been resolved. If this bundle is
+//      * a fragment bundle then <code>null</code> is returned.
+//      *
+//      * @param name The name of the resource. See
+//      *        <code>java.lang.ClassLoader.getResources</code> for a
+//      *        description of the format of a resource name.
+//      * @return An enumeration of URLs to the named resources, or
+//      *         <code>null</code> if the resource could not be found or if this
+//      *         bundle is a fragment bundle or if the caller does not have the
+//      *         appropriate <code>AdminPermission[this,RESOURCE]</code>, and
+//      *         the Java Runtime Environment supports permissions.
+//      *
+//      * @since 1.3
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @throws java.io.IOException If there is an I/O error.
+//      */
+//     public Enumeration getResources(String name) throws IOException;
+//
+//     /**
+//      * Returns an Enumeration of all the paths (<code>String</code> objects)
+//      * to entries within this bundle whose longest sub-path matches the
+//      * specified path. This bundle's classloader is not used to search for
+//      * entries. Only the contents of this bundle are searched.
+//      * <p>
+//      * The specified path is always relative to the root of this bundle and may
+//      * begin with a &quot;/&quot;. A path value of &quot;/&quot; indicates the
+//      * root of this bundle.
+//      * <p>
+//      * Returned paths indicating subdirectory paths end with a &quot;/&quot;.
+//      * The returned paths are all relative to the root of this bundle and must
+//      * not begin with &quot;/&quot;.
+//      *
+//      * @param path The path name for which to return entry paths.
+//      * @return An Enumeration of the entry paths (<code>String</code>
+//      *         objects) or <code>null</code> if no entry could be found or if
+//      *         the caller does not have the appropriate
+//      *         <code>AdminPermission[this,RESOURCE]</code> and the Java
+//      *         Runtime Environment supports permissions.
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @since 1.3
+//      */
+//     public Enumeration getEntryPaths(String path);
+//
+//     /**
+//      * Returns a URL to the entry at the specified path in this bundle. This
+//      * bundle's classloader is not used to search for the entry. Only the
+//      * contents of this bundle are searched for the entry.
+//      * <p>
+//      * The specified path is always relative to the root of this bundle and may
+//      * begin with &quot;/&quot;. A path value of &quot;/&quot; indicates the
+//      * root of this bundle.
+//      *
+//      * @param path The path name of the entry.
+//      * @return A URL to the entry, or <code>null</code> if no entry could be
+//      *         found or if the caller does not have the appropriate
+//      *         <code>AdminPermission[this,RESOURCE]</code> and the Java
+//      *         Runtime Environment supports permissions.
+//      *
+//      * @throws java.lang.IllegalStateException If this bundle has been
+//      *         uninstalled.
+//      * @since 1.3
+//      */
+//     public URL getEntry(String path);
+//
+//     /**
+//      * Returns the time when this bundle was last modified. A bundle is
+//      * considered to be modified when it is installed, updated or uninstalled.
+//      *
+//      * <p>
+//      * The time value is the number of milliseconds since January 1, 1970,
+//      * 00:00:00 GMT.
+//      *
+//      * @return The time when this bundle was last modified.
+//      * @since 1.3
+//      */
+//     public long getLastModified();
+//
+//     /**
+//      * Returns entries in this bundle and its attached fragments. This bundle's
+//      * classloader is not used to search for entries. Only the contents of this
+//      * bundle and its attached fragments are searched for the specified entries.
+//      *
+//      * If this bundle's state is <code>INSTALLED</code>, this method must
+//      * attempt to resolve this bundle before attempting to find entries.
+//      *
+//      * <p>
+//      * This method is intended to be used to obtain configuration, setup,
+//      * localization and other information from this bundle. This method takes
+//      * into account that the &quot;contents&quot; of this bundle can be extended
+//      * with fragments. This &quot;bundle space&quot; is not a namespace with
+//      * unique members; the same entry name can be present multiple times. This
+//      * method therefore returns an enumeration of URL objects. These URLs can
+//      * come from different JARs but have the same path name. This method can
+//      * either return only entries in the specified path or recurse into
+//      * subdirectories returning entries in the directory tree beginning at the
+//      * specified path. Fragments can be attached after this bundle is resolved,
+//      * possibly changing the set of URLs returned by this method. If this bundle
+//      * is not resolved, only the entries in the JAR file of this bundle are
+//      * returned.
+//      * <p>
+//      * Examples:
+//      *
+//      * <pre>
+//      * // List all XML files in the OSGI-INF directory and below
+//      * Enumeration e = b.findEntries(&quot;OSGI-INF&quot;, &quot;*.xml&quot;, true);
+//      *
+//      * // Find a specific localization file
+//      * Enumeration e = b.findEntries(&quot;OSGI-INF/l10n&quot;,
+//      *                               &quot;bundle_nl_DU.properties&quot;,
+//      *                               false);
+//      * if (e.hasMoreElements())
+//      *  return (URL) e.nextElement();
+//      * </pre>
+//      *
+//      * @param path The path name in which to look. The path is always relative
+//      *        to the root of this bundle and may begin with &quot;/&quot;. A
+//      *        path value of &quot;/&quot; indicates the root of this bundle.
+//      * @param filePattern The file name pattern for selecting entries in the
+//      *        specified path. The pattern is only matched against the last
+//      *        element of the entry path and it supports substring matching, as
+//      *        specified in the Filter specification, using the wildcard
+//      *        character (&quot;*&quot;). If null is specified, this is
+//      *        equivalent to &quot;*&quot; and matches all files.
+//      * @param recurse If <code>true</code>, recurse into subdirectories.
+//      *        Otherwise only return entries from the specified path.
+//      * @return An enumeration of URL objects for each matching entry, or
+//      *         <code>null</code> if an entry could not be found or if the
+//      *         caller does not have the appropriate
+//      *         <code>AdminPermission[this,RESOURCE]</code>, and the Java
+//      *         Runtime Environment supports permissions. The URLs are sorted
+//      *         such that entries from this bundle are returned first followed by
+//      *         the entries from attached fragments in ascending bundle id order.
+//      *         If this bundle is a fragment, then only matching entries in this
+//      *         fragment are returned.
+//      * @since 1.3
+//      */
+//     public Enumeration findEntries(String path, String filePattern,
+//             bool recurse);
+//
+//     /**
+//      * Returns this bundle's {@link BundleContext}. The returned
+//      * <code>BundleContext</code> can be used by the caller to act on behalf
+//      * of this bundle.
+//      *
+//      * <p>
+//      * If this bundle is not in the {@link #STARTING}, {@link #ACTIVE}, or
+//      * {@link #STOPPING} states or this bundle is a fragment bundle, then this
+//      * bundle has no valid <code>BundleContext</code>. This method will
+//      * return <code>null</code> if this bundle has no valid
+//      * <code>BundleContext</code>.
+//      *
+//      * @return A <code>BundleContext</code> for this bundle or
+//      *         <code>null</code> if this bundle has no valid
+//      *         <code>BundleContext</code>.
+//      * @throws java.lang.SecurityException If the caller does not have the
+//      *         appropriate <code>AdminPermission[this,CONTEXT]</code>, and
+//      *         the Java Runtime Environment supports permissions.
+//      * @since 1.4
+//      */
+//     public BundleContext getBundleContext();
+}
diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/osgi/src/org/osgi/framework/FrameworkEvent.d
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.eclipse.osgi/osgi/src/org/osgi/framework/FrameworkEvent.d	Tue Apr 14 13:22:56 2009 +0200
@@ -0,0 +1,210 @@
+/*
+ * $Header: /cvshome/build/org.osgi.framework/src/org/osgi/framework/FrameworkEvent.java,v 1.15 2007/02/20 00:14:12 hargrave Exp $
+ * 
+ * Copyright (c) OSGi Alliance (2004, 2007). All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+module org.osgi.framework.FrameworkEvent;
+import org.osgi.framework.Bundle;
+
+import java.lang.all;
+import java.util.EventObject;
+
+/**
+ * A general event from the Framework.
+ * 
+ * <p>
+ * <code>FrameworkEvent</code> objects are delivered to
+ * <code>FrameworkListener</code>s when a general event occurs within the
+ * OSGi environment. A type code is used to identify the event type for future
+ * extendability.
+ * 
+ * <p>
+ * OSGi Alliance reserves the right to extend the set of event types.
+ * 
+ * @Immutable
+ * @see FrameworkListener
+ * @version $Revision: 1.15 $
+ */
+
+public class FrameworkEvent : EventObject {
+    static final long       serialVersionUID    = 207051004521261705L;
+    /**
+     * Bundle related to the event.
+     */
+    private final Bundle    bundle;
+
+    /**
+     * Exception related to the event.
+     */
+    private final Throwable throwable;
+
+    /**
+     * Type of event.
+     */
+    private final int       type;
+
+    /**
+     * The Framework has started.
+     * 
+     * <p>
+     * This event is fired when the Framework has started after all installed
+     * bundles that are marked to be started have been started and the Framework
+     * has reached the intitial start level.
+     * 
+     * <p>
+     * The value of <code>STARTED</code> is 0x00000001.
+     * 
+     * @see "<code>StartLevel</code>"
+     */
+    public final static int STARTED             = 0x00000001;
+
+    /**
+     * An error has occurred.
+     * 
+     * <p>
+     * There was an error associated with a bundle.
+     * 
+     * <p>
+     * The value of <code>ERROR</code> is 0x00000002.
+     */
+    public final static int ERROR               = 0x00000002;
+
+    /**
+     * A PackageAdmin.refreshPackage operation has completed.
+     * 
+     * <p>
+     * This event is fired when the Framework has completed the refresh packages
+     * operation initiated by a call to the PackageAdmin.refreshPackages method.
+     * 
+     * <p>
+     * The value of <code>PACKAGES_REFRESHED</code> is 0x00000004.
+     * 
+     * @since 1.2
+     * @see "<code>PackageAdmin.refreshPackages</code>"
+     */
+    public final static int PACKAGES_REFRESHED  = 0x00000004;
+
+    /**
+     * A StartLevel.setStartLevel operation has completed.
+     * 
+     * <p>
+     * This event is fired when the Framework has completed changing the active
+     * start level initiated by a call to the StartLevel.setStartLevel method.
+     * 
+     * <p>
+     * The value of <code>STARTLEVEL_CHANGED</code> is 0x00000008.
+     * 
+     * @since 1.2
+     * @see "<code>StartLevel</code>"
+     */
+    public final static int STARTLEVEL_CHANGED  = 0x00000008;
+
+    /**
+     * A warning has occurred.
+     * 
+     * <p>
+     * There was a warning associated with a bundle.
+     * 
+     * <p>
+     * The value of <code>WARNING</code> is 0x00000010.
+     * 
+     * @since 1.3
+     */
+    public final static int WARNING             = 0x00000010;
+
+    /**
+     * An informational event has occurred.
+     * 
+     * <p>
+     * There was an informational event associated with a bundle.
+     * 
+     * <p>
+     * The value of <code>INFO</code> is 0x00000020.
+     * 
+     * @since 1.3
+     */
+    public final static int INFO                = 0x00000020;
+
+    /**
+     * Creates a Framework event.
+     * 
+     * @param type The event type.
+     * @param source The event source object. This may not be <code>null</code>.
+     * @deprecated As of 1.2. This constructor is deprecated in favor of using
+     *             the other constructor with the System Bundle as the event
+     *             source.
+     */
+    public this(int type, Object source) {
+        super(source);
+        this.type = type;
+        this.bundle = null;
+        this.throwable = null;
+    }
+
+    /**
+     * Creates a Framework event regarding the specified bundle.
+     * 
+     * @param type The event type.
+     * @param bundle The event source.
+     * @param throwable The related exception. This argument may be
+     *        <code>null</code> if there is no related exception.
+     */
+    public this(int type, Bundle bundle, Throwable throwable) {
+        super(cast(Object)bundle);
+        this.type = type;
+        this.bundle = bundle;
+        this.throwable = throwable;
+    }
+
+    /**
+     * Returns the exception related to this event.
+     * 
+     * @return The related exception or <code>null</code> if none.
+     */
+    public Throwable getThrowable() {
+        return throwable;
+    }
+
+    /**
+     * Returns the bundle associated with the event. This bundle is also the
+     * source of the event.
+     * 
+     * @return The bundle associated with the event.
+     */
+    public Bundle getBundle() {
+        return bundle;
+    }
+
+    /**
+     * Returns the type of framework event.
+     * <p>
+     * The type values are:
+     * <ul>
+     * <li>{@link #STARTED}
+     * <li>{@link #ERROR}
+     * <li>{@link #WARNING}
+     * <li>{@link #INFO}
+     * <li>{@link #PACKAGES_REFRESHED}
+     * <li>{@link #STARTLEVEL_CHANGED}
+     * </ul>
+     * 
+     * @return The type of state change.
+     */
+
+    public int getType() {
+        return type;
+    }
+}
diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/src/org/osgi/framework/Bundle.d
--- a/org.eclipse.osgi/src/org/osgi/framework/Bundle.d	Tue Apr 14 12:11:09 2009 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,1122 +0,0 @@
-/*
- * $Header: /cvshome/build/org.osgi.framework/src/org/osgi/framework/Bundle.java,v 1.54 2007/02/21 16:49:05 hargrave Exp $
- *
- * Copyright (c) OSGi Alliance (2000, 2007). All Rights Reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-module org.osgi.framework.Bundle;
-
-import java.lang.all;
-
-// import java.io.IOException;
-// import java.io.InputStream;
-// import java.net.URL;
-// import java.util.Dictionary;
-// import java.util.Enumeration;
-
-/**
- * An installed bundle in the Framework.
- *
- * <p>
- * A <code>Bundle</code> object is the access point to define the lifecycle of
- * an installed bundle. Each bundle installed in the OSGi environment must have
- * an associated <code>Bundle</code> object.
- *
- * <p>
- * A bundle must have a unique identity, a <code>long</code>, chosen by the
- * Framework. This identity must not change during the lifecycle of a bundle,
- * even when the bundle is updated. Uninstalling and then reinstalling the
- * bundle must create a new unique identity.
- *
- * <p>
- * A bundle can be in one of six states:
- * <ul>
- * <li>{@link #UNINSTALLED}
- * <li>{@link #INSTALLED}
- * <li>{@link #RESOLVED}
- * <li>{@link #STARTING}
- * <li>{@link #STOPPING}
- * <li>{@link #ACTIVE}
- * </ul>
- * <p>
- * Values assigned to these states have no specified ordering; they represent
- * bit values that may be ORed together to determine if a bundle is in one of
- * the valid states.
- *
- * <p>
- * A bundle should only execute code when its state is one of
- * <code>STARTING</code>,<code>ACTIVE</code>, or <code>STOPPING</code>.
- * An <code>UNINSTALLED</code> bundle can not be set to another state; it is a
- * zombie and can only be reached because references are kept somewhere.
- *
- * <p>
- * The Framework is the only entity that is allowed to create
- * <code>Bundle</code> objects, and these objects are only valid within the
- * Framework that created them.
- *
- * @ThreadSafe
- * @version $Revision: 1.54 $
- */
-public interface Bundle {
-    /**
-     * The bundle is uninstalled and may not be used.
-     *
-     * <p>
-     * The <code>UNINSTALLED</code> state is only visible after a bundle is
-     * uninstalled; the bundle is in an unusable state but references to the
-     * <code>Bundle</code> object may still be available and used for
-     * introspection.
-     * <p>
-     * The value of <code>UNINSTALLED</code> is 0x00000001.
-     */
-    public static const int UNINSTALLED             = 0x00000001;
-
-    /**
-     * The bundle is installed but not yet resolved.
-     *
-     * <p>
-     * A bundle is in the <code>INSTALLED</code> state when it has been
-     * installed in the Framework but is not or cannot be resolved.
-     * <p>
-     * This state is visible if the bundle's code dependencies are not resolved.
-     * The Framework may attempt to resolve an <code>INSTALLED</code> bundle's
-     * code dependencies and move the bundle to the <code>RESOLVED</code>
-     * state.
-     * <p>
-     * The value of <code>INSTALLED</code> is 0x00000002.
-     */
-    public static const int INSTALLED               = 0x00000002;
-
-    /**
-     * The bundle is resolved and is able to be started.
-     *
-     * <p>
-     * A bundle is in the <code>RESOLVED</code> state when the Framework has
-     * successfully resolved the bundle's code dependencies. These dependencies
-     * include:
-     * <ul>
-     * <li>The bundle's class path from its {@link Constants#BUNDLE_CLASSPATH}
-     * Manifest header.
-     * <li>The bundle's package dependencies from its
-     * {@link Constants#EXPORT_PACKAGE} and {@link Constants#IMPORT_PACKAGE}
-     * Manifest headers.
-     * <li>The bundle's required bundle dependencies from its
-     * {@link Constants#REQUIRE_BUNDLE} Manifest header.
-     * <li>A fragment bundle's host dependency from its
-     * {@link Constants#FRAGMENT_HOST} Manifest header.
-     * </ul>
-     * <p>
-     * Note that the bundle is not active yet. A bundle must be put in the
-     * <code>RESOLVED</code> state before it can be started. The Framework may
-     * attempt to resolve a bundle at any time.
-     * <p>
-     * The value of <code>RESOLVED</code> is 0x00000004.
-     */
-    public static const int RESOLVED                = 0x00000004;
-
-    /**
-     * The bundle is in the process of starting.
-     *
-     * <p>
-     * A bundle is in the <code>STARTING</code> state when its
-     * {@link #start(int) start} method is active. A bundle must be in this
-     * state when the bundle's {@link BundleActivator#start} is called. If the
-     * <code>BundleActivator.start</code> method completes without exception,
-     * then the bundle has successfully started and must move to the
-     * <code>ACTIVE</code> state.
-     * <p>
-     * If the bundle has a
-     * {@link Constants#ACTIVATION_LAZY lazy activation policy}, then the
-     * bundle may remain in this state for some time until the activation is
-     * triggered.
-     * <p>
-     * The value of <code>STARTING</code> is 0x00000008.
-     */
-    public static const int STARTING                = 0x00000008;
-
-    /**
-     * The bundle is in the process of stopping.
-     *
-     * <p>
-     * A bundle is in the <code>STOPPING</code> state when its
-     * {@link #stop(int) stop} method is active. A bundle must be in this state
-     * when the bundle's {@link BundleActivator#stop} method is called. When the
-     * <code>BundleActivator.stop</code> method completes the bundle is
-     * stopped and must move to the <code>RESOLVED</code> state.
-     * <p>
-     * The value of <code>STOPPING</code> is 0x00000010.
-     */
-    public static const int STOPPING                = 0x00000010;
-
-    /**
-     * The bundle is now running.
-     *
-     * <p>
-     * A bundle is in the <code>ACTIVE</code> state when it has been
-     * successfully started and activated.
-     * <p>
-     * The value of <code>ACTIVE</code> is 0x00000020.
-     */
-    public static const int ACTIVE                  = 0x00000020;
-
-    /**
-     * The bundle start operation is transient and the persistent autostart
-     * setting of the bundle is not modified.
-     *
-     * <p>
-     * This bit may be set when calling {@link #start(int)} to notify the
-     * framework that the autostart setting of the bundle must not be modified.
-     * If this bit is not set, then the autostart setting of the bundle is
-     * modified.
-     *
-     * @since 1.4
-     * @see #start(int)
-     */
-    public static const int START_TRANSIENT         = 0x00000001;
-
-    /**
-     * The bundle start operation must activate the bundle according to the
-     * bundle's declared
-     * {@link Constants#BUNDLE_ACTIVATIONPOLICY activation policy}.
-     *
-     * <p>
-     * This bit may be set when calling {@link #start(int)} to notify the
-     * framework that the bundle must be activated using the bundle's declared
-     * activation policy.
-     *
-     * @since 1.4
-     * @see Constants#BUNDLE_ACTIVATIONPOLICY
-     * @see #start(int)
-     */
-    public static const int START_ACTIVATION_POLICY = 0x00000002;
-
-    /**
-     * The bundle stop is transient and the persistent autostart setting of the
-     * bundle is not modified.
-     *
-     * <p>
-     * This bit may be set when calling {@link #stop(int)} to notify the
-     * framework that the autostart setting of the bundle must not be modified.
-     * If this bit is not set, then the autostart setting of the bundle is
-     * modified.
-     *
-     * @since 1.4
-     * @see #stop(int)
-     */
-    public static final int STOP_TRANSIENT          = 0x00000001;
-
-    /**
-     * Returns this bundle's current state.
-     *
-     * <p>
-     * A bundle can be in only one state at any time.
-     *
-     * @return An element of <code>UNINSTALLED</code>,<code>INSTALLED</code>,
-     *         <code>RESOLVED</code>,<code>STARTING</code>,
-     *         <code>STOPPING</code>,<code>ACTIVE</code>.
-     */
-    public int getState();
-
-    /**
-     * Starts this bundle.
-     *
-     * <p>
-     * If this bundle's state is <code>UNINSTALLED</code> then an
-     * <code>IllegalStateException</code> is thrown.
-     * <p>
-     * If the Framework implements the optional Start Level service and the
-     * current start level is less than this bundle's start level:
-     * <ul>
-     * <li>If the {@link #START_TRANSIENT} option is set, then a
-     * <code>BundleException</code> is thrown indicating this bundle cannot be
-     * started due to the Framework's current start level.
-     *
-     * <li>Otherwise, the Framework must set this bundle's persistent autostart
-     * setting to <em>Started with declared activation</em> if the
-     * {@link #START_ACTIVATION_POLICY} option is set or
-     * <em>Started with eager activation</em> if not set.
-     * </ul>
-     * <p>
-     * When the Framework's current start level becomes equal to or more than
-     * this bundle's start level, this bundle will be started.
-     * <p>
-     * Otherwise, the following steps are required to start this bundle:
-     * <ol>
-     * <li>If this bundle is in the process of being activated or deactivated
-     * then this method must wait for activation or deactivation to complete
-     * before continuing. If this does not occur in a reasonable time, a
-     * <code>BundleException</code> is thrown to indicate this bundle was
-     * unable to be started.
-     *
-     * <li>If this bundle's state is <code>ACTIVE</code> then this method
-     * returns immediately.
-     *
-     * <li>If the {@link #START_TRANSIENT} option is not set then set this
-     * bundle's autostart setting to <em>Started with declared activation</em>
-     * if the {@link #START_ACTIVATION_POLICY} option is set or
-     * <em>Started with eager activation</em> if not set. When the Framework
-     * is restarted and this bundle's autostart setting is not <em>Stopped</em>,
-     * this bundle must be automatically started.
-     *
-     * <li>If this bundle's state is not <code>RESOLVED</code>, an attempt
-     * is made to resolve this bundle. If the Framework cannot resolve this
-     * bundle, a <code>BundleException</code> is thrown.
-     *
-     * <li>If the {@link #START_ACTIVATION_POLICY} option is set and this
-     * bundle's declared activation policy is
-     * {@link Constants#ACTIVATION_LAZY lazy} then:
-     * <ul>
-     * <li>If this bundle's state is <code>STARTING</code> then this method
-     * returns immediately.
-     * <li>This bundle's state is set to <code>STARTING</code>.
-     * <li>A bundle event of type {@link BundleEvent#LAZY_ACTIVATION} is fired.
-     * <li>This method returns immediately and the remaining steps will be
-     * followed when this bundle's activation is later triggered.
-     * </ul>
-     * <i></i>
-     * <li>This bundle's state is set to <code>STARTING</code>.
-     *
-     * <li>A bundle event of type {@link BundleEvent#STARTING} is fired.
-     *
-     * <li>The {@link BundleActivator#start} method of this bundle's
-     * <code>BundleActivator</code>, if one is specified, is called. If the
-     * <code>BundleActivator</code> is invalid or throws an exception then:
-     * <ul>
-     * <li>This bundle's state is set to <code>STOPPING</code>.
-     * <li>A bundle event of type {@link BundleEvent#STOPPING} is fired.
-     * <li>Any services registered by this bundle must be unregistered.
-     * <li>Any services used by this bundle must be released.
-     * <li>Any listeners registered by this bundle must be removed.
-     * <li>This bundle's state is set to <code>RESOLVED</code>.
-     * <li>A bundle event of type {@link BundleEvent#STOPPED} is fired.
-     * <li>A <code>BundleException</code> is then thrown.
-     * </ul>
-     * <i></i>
-     * <li>If this bundle's state is <code>UNINSTALLED</code>, because this
-     * bundle was uninstalled while the <code>BundleActivator.start</code>
-     * method was running, a <code>BundleException</code> is thrown.
-     *
-     * <li>This bundle's state is set to <code>ACTIVE</code>.
-     *
-     * <li>A bundle event of type {@link BundleEvent#STARTED} is fired.
-     * </ol>
-     *
-     * <b>Preconditions </b>
-     * <ul>
-     * <li><code>getState()</code> in {<code>INSTALLED</code>,
-     * <code>RESOLVED</code>} or {<code>INSTALLED</code>,
-     * <code>RESOLVED</code>, <code>STARTING</code>} if this bundle has a
-     * lazy activation policy.
-     * </ul>
-     * <b>Postconditions, no exceptions thrown </b>
-     * <ul>
-     * <li>Bundle autostart setting is modified unless the
-     * {@link #START_TRANSIENT} option was set.
-     * <li><code>getState()</code> in {<code>ACTIVE</code>} unless the
-     * lazy activation policy was used.
-     * <li><code>BundleActivator.start()</code> has been called and did not
-     * throw an exception unless the lazy activation policy was used.
-     * </ul>
-     * <b>Postconditions, when an exception is thrown </b>
-     * <ul>
-     * <li>Depending on when the exception occurred, bundle autostart setting
-     * is modified unless the {@link #START_TRANSIENT} option was set.
-     * <li><code>getState()</code> not in {<code>STARTING</code>,
-     * <code>ACTIVE</code>}.
-     * </ul>
-     *
-     * @param options The options for starting this bundle. See
-     *        {@link #START_TRANSIENT} and {@link #START_ACTIVATION_POLICY}.
-     *        The Framework must ignore unrecognized options.
-     * @throws BundleException If this bundle could not be started. This could
-     *         be because a code dependency could not be resolved or the
-     *         specified <code>BundleActivator</code> could not be loaded or
-     *         threw an exception or this bundle is a fragment.
-     * @throws java.lang.IllegalStateException If this bundle has been
-     *         uninstalled or this bundle tries to change its own state.
-     * @throws java.lang.SecurityException If the caller does not have the
-     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
-     *         the Java Runtime Environment supports permissions.
-     * @since 1.4
-     */
-    public void start(int options);
-
-    /**
-     * Starts this bundle with no options.
-     *
-     * <p>
-     * This method calls <code>start(0)</code>.
-     *
-     * @throws BundleException If this bundle could not be started. This could
-     *         be because a code dependency could not be resolved or the
-     *         specified <code>BundleActivator</code> could not be loaded or
-     *         threw an exception or this bundle is a fragment.
-     * @throws java.lang.IllegalStateException If this bundle has been
-     *         uninstalled or this bundle tries to change its own state.
-     * @throws java.lang.SecurityException If the caller does not have the
-     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
-     *         the Java Runtime Environment supports permissions.
-     * @see #start(int)
-     */
-    public void start();
-
-    /**
-     * Stops this bundle.
-     *
-     * <p>
-     * The following steps are required to stop a bundle:
-     * <ol>
-     * <li>If this bundle's state is <code>UNINSTALLED</code> then an
-     * <code>IllegalStateException</code> is thrown.
-     *
-     * <li>If this bundle is in the process of being activated or deactivated
-     * then this method must wait for activation or deactivation to complete
-     * before continuing. If this does not occur in a reasonable time, a
-     * <code>BundleException</code> is thrown to indicate this bundle was
-     * unable to be stopped.
-     * <li>If the {@link #STOP_TRANSIENT} option is not set then then set this
-     * bundle's persistent autostart setting to to <em>Stopped</em>. When the
-     * Framework is restarted and this bundle's autostart setting is
-     * <em>Stopped</em>, this bundle must not be automatically started.
-     *
-     * <li>If this bundle's state is not <code>ACTIVE</code> then this method
-     * returns immediately.
-     *
-     * <li>This bundle's state is set to <code>STOPPING</code>.
-     *
-     * <li>A bundle event of type {@link BundleEvent#STOPPING} is fired.
-     *
-     * <li>The {@link BundleActivator#stop} method of this bundle's
-     * <code>BundleActivator</code>, if one is specified, is called. If that
-     * method throws an exception, this method must continue to stop this
-     * bundle. A <code>BundleException</code> must be thrown after completion
-     * of the remaining steps.
-     *
-     * <li>Any services registered by this bundle must be unregistered.
-     * <li>Any services used by this bundle must be released.
-     * <li>Any listeners registered by this bundle must be removed.
-     *
-     * <li>If this bundle's state is <code>UNINSTALLED</code>, because this
-     * bundle was uninstalled while the <code>BundleActivator.stop</code>
-     * method was running, a <code>BundleException</code> must be thrown.
-     *
-     * <li>This bundle's state is set to <code>RESOLVED</code>.
-     *
-     * <li>A bundle event of type {@link BundleEvent#STOPPED} is fired.
-     * </ol>
-     *
-     * <b>Preconditions </b>
-     * <ul>
-     * <li><code>getState()</code> in {<code>ACTIVE</code>}.
-     * </ul>
-     * <b>Postconditions, no exceptions thrown </b>
-     * <ul>
-     * <li>Bundle autostart setting is modified unless the
-     * {@link #STOP_TRANSIENT} option was set.
-     * <li><code>getState()</code> not in {<code>ACTIVE</code>,
-     * <code>STOPPING</code>}.
-     * <li><code>BundleActivator.stop</code> has been called and did not
-     * throw an exception.
-     * </ul>
-     * <b>Postconditions, when an exception is thrown </b>
-     * <ul>
-     * <li>Bundle autostart setting is modified unless the
-     * {@link #STOP_TRANSIENT} option was set.
-     * </ul>
-     *
-     * @param options The options for stoping this bundle. See
-     *        {@link #STOP_TRANSIENT}. The Framework must ignore unrecognized
-     *        options.
-     * @throws BundleException If this bundle's <code>BundleActivator</code>
-     *         threw an exception or this bundle is a fragment.
-     * @throws java.lang.IllegalStateException If this bundle has been
-     *         uninstalled or this bundle tries to change its own state.
-     * @throws java.lang.SecurityException If the caller does not have the
-     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
-     *         the Java Runtime Environment supports permissions.
-     * @since 1.4
-     */
-    public void stop(int options);
-
-    /**
-     * Stops this bundle with no options.
-     *
-     * <p>
-     * This method calls <code>stop(0)</code>.
-     *
-     * @throws BundleException If this bundle's <code>BundleActivator</code>
-     *         threw an exception or this bundle is a fragment.
-     * @throws java.lang.IllegalStateException If this bundle has been
-     *         uninstalled or this bundle tries to change its own state.
-     * @throws java.lang.SecurityException If the caller does not have the
-     *         appropriate <code>AdminPermission[this,EXECUTE]</code>, and
-     *         the Java Runtime Environment supports permissions.
-     * @see #start(int)
-     */
-    public void stop();
-
-    /**
-     * Updates this bundle.
-     *
-     * <p>
-     * If this bundle's state is <code>ACTIVE</code>, it must be stopped
-     * before the update and started after the update successfully completes.
-     *
-     * <p>
-     * If this bundle has exported any packages, these packages must not be
-     * updated. Instead, the previous package version must remain exported until
-     * the <code>PackageAdmin.refreshPackages</code> method has been has been
-     * called or the Framework is relaunched.
-     *
-     * <p>
-     * The following steps are required to update a bundle:
-     * <ol>
-     * <li>If this bundle's state is <code>UNINSTALLED</code> then an
-     * <code>IllegalStateException</code> is thrown.
-     *
-     * <li>If this bundle's state is <code>ACTIVE</code>,
-     * <code>STARTING</code> or <code>STOPPING</code>, this bundle is
-     * stopped as described in the <code>Bundle.stop</code> method. If
-     * <code>Bundle.stop</code> throws an exception, the exception is rethrown
-     * terminating the update.
-     *
-     * <li>The download location of the new version of this bundle is
-     * determined from either this bundle's
-     * {@link Constants#BUNDLE_UPDATELOCATION} Manifest header (if available) or
-     * this bundle's original location.
-     *
-     * <li>The location is interpreted in an implementation dependent manner,
-     * typically as a URL, and the new version of this bundle is obtained from
-     * this location.
-     *
-     * <li>The new version of this bundle is installed. If the Framework is
-     * unable to install the new version of this bundle, the original version of
-     * this bundle must be restored and a <code>BundleException</code> must be
-     * thrown after completion of the remaining steps.
-     *
-     * <li>If this bundle has declared an Bundle-RequiredExecutionEnvironment
-     * header, then the listed execution environments must be verified against
-     * the installed execution environments. If they do not all match, the
-     * original version of this bundle must be restored and a
-     * <code>BundleException</code> must be thrown after completion of the
-     * remaining steps.
-     *
-     * <li>This bundle's state is set to <code>INSTALLED</code>.
-     *
-     * <li>If the new version of this bundle was successfully installed, a
-     * bundle event of type {@link BundleEvent#UPDATED} is fired.
-     *
-     * <li>If this bundle's state was originally <code>ACTIVE</code>, the
-     * updated bundle is started as described in the <code>Bundle.start</code>
-     * method. If <code>Bundle.start</code> throws an exception, a Framework
-     * event of type {@link FrameworkEvent#ERROR} is fired containing the
-     * exception.
-     * </ol>
-     *
-     * <b>Preconditions </b>
-     * <ul>
-     * <li><code>getState()</code> not in {<code>UNINSTALLED</code>}.
-     * </ul>
-     * <b>Postconditions, no exceptions thrown </b>
-     * <ul>
-     * <li><code>getState()</code> in {<code>INSTALLED</code>,
-     * <code>RESOLVED</code>,<code>ACTIVE</code>}.
-     * <li>This bundle has been updated.
-     * </ul>
-     * <b>Postconditions, when an exception is thrown </b>
-     * <ul>
-     * <li><code>getState()</code> in {<code>INSTALLED</code>,
-     * <code>RESOLVED</code>,<code>ACTIVE</code>}.
-     * <li>Original bundle is still used; no update occurred.
-     * </ul>
-     *
-     * @throws BundleException If the update fails.
-     * @throws java.lang.IllegalStateException If this bundle has been
-     *         uninstalled or this bundle tries to change its own state.
-     * @throws java.lang.SecurityException If the caller does not have the
-     *         appropriate <code>AdminPermission[this,LIFECYCLE]</code> for
-     *         both the current bundle and the updated bundle, and the Java
-     *         Runtime Environment supports permissions.
-     * @see #stop()
-     * @see #start()
-     */
-    public void update();
-
-//     /**
-//      * Updates this bundle from an <code>InputStream</code>.
-//      *
-//      * <p>
-//      * This method performs all the steps listed in <code>Bundle.update()</code>,
-//      * except the new version of this bundle must be read from the supplied
-//      * <code>InputStream</code>, rather than a <code>URL</code>.
-//      * <p>
-//      * This method must always close the <code>InputStream</code> when it is
-//      * done, even if an exception is thrown.
-//      *
-//      * @param in The <code>InputStream</code> from which to read the new
-//      *        bundle.
-//      * @throws BundleException If the provided stream cannot be read or the
-//      *         update fails.
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled or this bundle tries to change its own state.
-//      * @throws java.lang.SecurityException If the caller does not have the
-//      *         appropriate <code>AdminPermission[this,LIFECYCLE]</code> for
-//      *         both the current bundle and the updated bundle, and the Java
-//      *         Runtime Environment supports permissions.
-//      * @see #update()
-//      */
-//     public void update(InputStream in_);
-//
-//     /**
-//      * Uninstalls this bundle.
-//      *
-//      * <p>
-//      * This method causes the Framework to notify other bundles that this bundle
-//      * is being uninstalled, and then puts this bundle into the
-//      * <code>UNINSTALLED</code> state. The Framework must remove any resources
-//      * related to this bundle that it is able to remove.
-//      *
-//      * <p>
-//      * If this bundle has exported any packages, the Framework must continue to
-//      * make these packages available to their importing bundles until the
-//      * <code>PackageAdmin.refreshPackages</code> method has been called or the
-//      * Framework is relaunched.
-//      *
-//      * <p>
-//      * The following steps are required to uninstall a bundle:
-//      * <ol>
-//      * <li>If this bundle's state is <code>UNINSTALLED</code> then an
-//      * <code>IllegalStateException</code> is thrown.
-//      *
-//      * <li>If this bundle's state is <code>ACTIVE</code>,
-//      * <code>STARTING</code> or <code>STOPPING</code>, this bundle is
-//      * stopped as described in the <code>Bundle.stop</code> method. If
-//      * <code>Bundle.stop</code> throws an exception, a Framework event of type
-//      * {@link FrameworkEvent#ERROR} is fired containing the exception.
-//      *
-//      * <li>This bundle's state is set to <code>UNINSTALLED</code>.
-//      *
-//      * <li>A bundle event of type {@link BundleEvent#UNINSTALLED} is fired.
-//      *
-//      * <li>This bundle and any persistent storage area provided for this bundle
-//      * by the Framework are removed.
-//      * </ol>
-//      *
-//      * <b>Preconditions </b>
-//      * <ul>
-//      * <li><code>getState()</code> not in {<code>UNINSTALLED</code>}.
-//      * </ul>
-//      * <b>Postconditions, no exceptions thrown </b>
-//      * <ul>
-//      * <li><code>getState()</code> in {<code>UNINSTALLED</code>}.
-//      * <li>This bundle has been uninstalled.
-//      * </ul>
-//      * <b>Postconditions, when an exception is thrown </b>
-//      * <ul>
-//      * <li><code>getState()</code> not in {<code>UNINSTALLED</code>}.
-//      * <li>This Bundle has not been uninstalled.
-//      * </ul>
-//      *
-//      * @throws BundleException If the uninstall failed. This can occur if
-//      *         another thread is attempting to change this bundle's state and
-//      *         does not complete in a timely manner.
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled or this bundle tries to change its own state.
-//      * @throws java.lang.SecurityException If the caller does not have the
-//      *         appropriate <code>AdminPermission[this,LIFECYCLE]</code>, and
-//      *         the Java Runtime Environment supports permissions.
-//      * @see #stop()
-//      */
-//     public void uninstall();
-//
-//     /**
-//      * Returns this bundle's Manifest headers and values. This method returns
-//      * all the Manifest headers and values from the main section of this
-//      * bundle's Manifest file; that is, all lines prior to the first blank line.
-//      *
-//      * <p>
-//      * Manifest header names are case-insensitive. The methods of the returned
-//      * <code>Dictionary</code> object must operate on header names in a
-//      * case-insensitive manner.
-//      *
-//      * If a Manifest header value starts with &quot;%&quot;, it must be
-//      * localized according to the default locale.
-//      *
-//      * <p>
-//      * For example, the following Manifest headers and values are included if
-//      * they are present in the Manifest file:
-//      *
-//      * <pre>
-//      *     Bundle-Name
-//      *     Bundle-Vendor
-//      *     Bundle-Version
-//      *     Bundle-Description
-//      *     Bundle-DocURL
-//      *     Bundle-ContactAddress
-//      * </pre>
-//      *
-//      * <p>
-//      * This method must continue to return Manifest header information while
-//      * this bundle is in the <code>UNINSTALLED</code> state.
-//      *
-//      * @return A <code>Dictionary</code> object containing this bundle's
-//      *         Manifest headers and values.
-//      *
-//      * @throws java.lang.SecurityException If the caller does not have the
-//      *         appropriate <code>AdminPermission[this,METADATA]</code>, and
-//      *         the Java Runtime Environment supports permissions.
-//      *
-//      * @see Constants#BUNDLE_LOCALIZATION
-//      */
-//     public Dictionary getHeaders();
-//
-//     /**
-//      * Returns this bundle's unique identifier. This bundle is assigned a unique
-//      * identifier by the Framework when it was installed in the OSGi
-//      * environment.
-//      *
-//      * <p>
-//      * A bundle's unique identifier has the following attributes:
-//      * <ul>
-//      * <li>Is unique and persistent.
-//      * <li>Is a <code>long</code>.
-//      * <li>Its value is not reused for another bundle, even after a bundle is
-//      * uninstalled.
-//      * <li>Does not change while a bundle remains installed.
-//      * <li>Does not change when a bundle is updated.
-//      * </ul>
-//      *
-//      * <p>
-//      * This method must continue to return this bundle's unique identifier while
-//      * this bundle is in the <code>UNINSTALLED</code> state.
-//      *
-//      * @return The unique identifier of this bundle.
-//      */
-//     public long getBundleId();
-//
-//     /**
-//      * Returns this bundle's location identifier.
-//      *
-//      * <p>
-//      * The location identifier is the location passed to
-//      * <code>BundleContext.installBundle</code> when a bundle is installed.
-//      * The location identifier does not change while this bundle remains
-//      * installed, even if this bundle is updated.
-//      *
-//      * <p>
-//      * This method must continue to return this bundle's location identifier
-//      * while this bundle is in the <code>UNINSTALLED</code> state.
-//      *
-//      * @return The string representation of this bundle's location identifier.
-//      * @throws java.lang.SecurityException If the caller does not have the
-//      *         appropriate <code>AdminPermission[this,METADATA]</code>, and
-//      *         the Java Runtime Environment supports permissions.
-//      */
-//     public String getLocation();
-//
-//     /**
-//      * Returns this bundle's <code>ServiceReference</code> list for all
-//      * services it has registered or <code>null</code> if this bundle has no
-//      * registered services.
-//      *
-//      * <p>
-//      * If the Java runtime supports permissions, a <code>ServiceReference</code>
-//      * object to a service is included in the returned list only if the caller
-//      * has the <code>ServicePermission</code> to get the service using at
-//      * least one of the named classes the service was registered under.
-//      *
-//      * <p>
-//      * The list is valid at the time of the call to this method, however, as the
-//      * Framework is a very dynamic environment, services can be modified or
-//      * unregistered at anytime.
-//      *
-//      * @return An array of <code>ServiceReference</code> objects or
-//      *         <code>null</code>.
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @see ServiceRegistration
-//      * @see ServiceReference
-//      * @see ServicePermission
-//      */
-//     public ServiceReference[] getRegisteredServices();
-//
-//     /**
-//      * Returns this bundle's <code>ServiceReference</code> list for all
-//      * services it is using or returns <code>null</code> if this bundle is not
-//      * using any services. A bundle is considered to be using a service if its
-//      * use count for that service is greater than zero.
-//      *
-//      * <p>
-//      * If the Java Runtime Environment supports permissions, a
-//      * <code>ServiceReference</code> object to a service is included in the
-//      * returned list only if the caller has the <code>ServicePermission</code>
-//      * to get the service using at least one of the named classes the service
-//      * was registered under.
-//      * <p>
-//      * The list is valid at the time of the call to this method, however, as the
-//      * Framework is a very dynamic environment, services can be modified or
-//      * unregistered at anytime.
-//      *
-//      * @return An array of <code>ServiceReference</code> objects or
-//      *         <code>null</code>.
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @see ServiceReference
-//      * @see ServicePermission
-//      */
-//     public ServiceReference[] getServicesInUse();
-//
-//     /**
-//      * Determines if this bundle has the specified permissions.
-//      *
-//      * <p>
-//      * If the Java Runtime Environment does not support permissions, this method
-//      * always returns <code>true</code>.
-//      * <p>
-//      * <code>permission</code> is of type <code>Object</code> to avoid
-//      * referencing the <code>java.security.Permission</code> class directly.
-//      * This is to allow the Framework to be implemented in Java environments
-//      * which do not support permissions.
-//      *
-//      * <p>
-//      * If the Java Runtime Environment does support permissions, this bundle and
-//      * all its resources including embedded JAR files, belong to the same
-//      * <code>java.security.ProtectionDomain</code>; that is, they must share
-//      * the same set of permissions.
-//      *
-//      * @param permission The permission to verify.
-//      *
-//      * @return <code>true</code> if this bundle has the specified permission
-//      *         or the permissions possessed by this bundle imply the specified
-//      *         permission; <code>false</code> if this bundle does not have the
-//      *         specified permission or <code>permission</code> is not an
-//      *         <code>instanceof</code> <code>java.security.Permission</code>.
-//      *
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      */
-//     public bool hasPermission(Object permission);
-//
-//     /**
-//      * Find the specified resource from this bundle.
-//      *
-//      * This bundle's class loader is called to search for the specified
-//      * resource. If this bundle's state is <code>INSTALLED</code>, this
-//      * method must attempt to resolve this bundle before attempting to get the
-//      * specified resource. If this bundle cannot be resolved, then only this
-//      * bundle must be searched for the specified resource. Imported packages
-//      * cannot be searched when this bundle has not been resolved. If this bundle
-//      * is a fragment bundle then <code>null</code> is returned.
-//      *
-//      * @param name The name of the resource. See
-//      *        <code>java.lang.ClassLoader.getResource</code> for a description
-//      *        of the format of a resource name.
-//      * @return A URL to the named resource, or <code>null</code> if the
-//      *         resource could not be found or if this bundle is a fragment
-//      *         bundle or if the caller does not have the appropriate
-//      *         <code>AdminPermission[this,RESOURCE]</code>, and the Java
-//      *         Runtime Environment supports permissions.
-//      *
-//      * @since 1.1
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @see #getEntry
-//      * @see #findEntries
-//      */
-//     public URL getResource(String name);
-//
-//     /**
-//      * Returns this bundle's Manifest headers and values localized to the
-//      * specified locale.
-//      *
-//      * <p>
-//      * This method performs the same function as
-//      * <code>Bundle.getHeaders()</code> except the manifest header values are
-//      * localized to the specified locale.
-//      *
-//      * <p>
-//      * If a Manifest header value starts with &quot;%&quot;, it must be
-//      * localized according to the specified locale. If a locale is specified and
-//      * cannot be found, then the header values must be returned using the
-//      * default locale. Localizations are searched for in the following order:
-//      *
-//      * <pre>
-//      *   bn + "_" + Ls + "_" + Cs + "_" + Vs
-//      *   bn + "_" + Ls + "_" + Cs
-//      *   bn + "_" + Ls
-//      *   bn + "_" + Ld + "_" + Cd + "_" + Vd
-//      *   bn + "_" + Ld + "_" + Cd
-//      *   bn + "_" + Ld
-//      *     bn
-//      * </pre>
-//      *
-//      * Where <code>bn</code> is this bundle's localization basename,
-//      * <code>Ls</code>, <code>Cs</code> and <code>Vs</code> are the
-//      * specified locale (language, country, variant) and <code>Ld</code>,
-//      * <code>Cd</code> and <code>Vd</code> are the default locale (language,
-//      * country, variant).
-//      *
-//      * If <code>null</code> is specified as the locale string, the header
-//      * values must be localized using the default locale. If the empty string
-//      * (&quot;&quot;) is specified as the locale string, the header values must
-//      * not be localized and the raw (unlocalized) header values, including any
-//      * leading &quot;%&quot;, must be returned.
-//      *
-//      * <p>
-//      * This method must continue to return Manifest header information while
-//      * this bundle is in the <code>UNINSTALLED</code> state, however the
-//      * header values must only be available in the raw and default locale
-//      * values.
-//      *
-//      * @param locale The locale name into which the header values are to be
-//      *        localized. If the specified locale is <code>null</code> then the
-//      *        locale returned by <code>java.util.Locale.getDefault</code> is
-//      *        used. If the specified locale is the empty string, this method
-//      *        will return the raw (unlocalized) manifest headers including any
-//      *        leading &quot;%&quot;.
-//      * @return A <code>Dictionary</code> object containing this bundle's
-//      *         Manifest headers and values.
-//      *
-//      * @throws java.lang.SecurityException If the caller does not have the
-//      *         appropriate <code>AdminPermission[this,METADATA]</code>, and
-//      *         the Java Runtime Environment supports permissions.
-//      *
-//      * @see #getHeaders()
-//      * @see Constants#BUNDLE_LOCALIZATION
-//      * @since 1.3
-//      */
-//     public Dictionary getHeaders(String locale);
-//
-//     /**
-//      * Returns the symbolic name of this bundle as specified by its
-//      * <code>Bundle-SymbolicName</code> manifest header. The name must be
-//      * unique, it is recommended to use a reverse domain name naming convention
-//      * like that used for java packages. If this bundle does not have a
-//      * specified symbolic name then <code>null</code> is returned.
-//      *
-//      * <p>
-//      * This method must continue to return this bundle's symbolic name while
-//      * this bundle is in the <code>UNINSTALLED</code> state.
-//      *
-//      * @return The symbolic name of this bundle.
-//      * @since 1.3
-//      */
-//     public String getSymbolicName();
-//
-//     /**
-//      * Loads the specified class using this bundle's classloader.
-//      *
-//      * <p>
-//      * If this bundle is a fragment bundle then this method must throw a
-//      * <code>ClassNotFoundException</code>.
-//      *
-//      * <p>
-//      * If this bundle's state is <code>INSTALLED</code>, this method must
-//      * attempt to resolve this bundle before attempting to load the class.
-//      *
-//      * <p>
-//      * If this bundle cannot be resolved, a Framework event of type
-//      * {@link FrameworkEvent#ERROR} is fired containing a
-//      * <code>BundleException</code> with details of the reason this bundle
-//      * could not be resolved. This method must then throw a
-//      * <code>ClassNotFoundException</code>.
-//      *
-//      * <p>
-//      * If this bundle's state is <code>UNINSTALLED</code>, then an
-//      * <code>IllegalStateException</code> is thrown.
-//      *
-//      * @param name The name of the class to load.
-//      * @return The Class object for the requested class.
-//      * @throws java.lang.ClassNotFoundException If no such class can be found or
-//      *         if this bundle is a fragment bundle or if the caller does not
-//      *         have the appropriate <code>AdminPermission[this,CLASS]</code>,
-//      *         and the Java Runtime Environment supports permissions.
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @since 1.3
-//      */
-//     public Class loadClass(String name) throws ClassNotFoundException;
-//
-//     /**
-//      * Find the specified resources from this bundle.
-//      *
-//      * This bundle's class loader is called to search for the specified
-//      * resources. If this bundle's state is <code>INSTALLED</code>, this
-//      * method must attempt to resolve this bundle before attempting to get the
-//      * specified resources. If this bundle cannot be resolved, then only this
-//      * bundle must be searched for the specified resources. Imported packages
-//      * cannot be searched when a bundle has not been resolved. If this bundle is
-//      * a fragment bundle then <code>null</code> is returned.
-//      *
-//      * @param name The name of the resource. See
-//      *        <code>java.lang.ClassLoader.getResources</code> for a
-//      *        description of the format of a resource name.
-//      * @return An enumeration of URLs to the named resources, or
-//      *         <code>null</code> if the resource could not be found or if this
-//      *         bundle is a fragment bundle or if the caller does not have the
-//      *         appropriate <code>AdminPermission[this,RESOURCE]</code>, and
-//      *         the Java Runtime Environment supports permissions.
-//      *
-//      * @since 1.3
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @throws java.io.IOException If there is an I/O error.
-//      */
-//     public Enumeration getResources(String name) throws IOException;
-//
-//     /**
-//      * Returns an Enumeration of all the paths (<code>String</code> objects)
-//      * to entries within this bundle whose longest sub-path matches the
-//      * specified path. This bundle's classloader is not used to search for
-//      * entries. Only the contents of this bundle are searched.
-//      * <p>
-//      * The specified path is always relative to the root of this bundle and may
-//      * begin with a &quot;/&quot;. A path value of &quot;/&quot; indicates the
-//      * root of this bundle.
-//      * <p>
-//      * Returned paths indicating subdirectory paths end with a &quot;/&quot;.
-//      * The returned paths are all relative to the root of this bundle and must
-//      * not begin with &quot;/&quot;.
-//      *
-//      * @param path The path name for which to return entry paths.
-//      * @return An Enumeration of the entry paths (<code>String</code>
-//      *         objects) or <code>null</code> if no entry could be found or if
-//      *         the caller does not have the appropriate
-//      *         <code>AdminPermission[this,RESOURCE]</code> and the Java
-//      *         Runtime Environment supports permissions.
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @since 1.3
-//      */
-//     public Enumeration getEntryPaths(String path);
-//
-//     /**
-//      * Returns a URL to the entry at the specified path in this bundle. This
-//      * bundle's classloader is not used to search for the entry. Only the
-//      * contents of this bundle are searched for the entry.
-//      * <p>
-//      * The specified path is always relative to the root of this bundle and may
-//      * begin with &quot;/&quot;. A path value of &quot;/&quot; indicates the
-//      * root of this bundle.
-//      *
-//      * @param path The path name of the entry.
-//      * @return A URL to the entry, or <code>null</code> if no entry could be
-//      *         found or if the caller does not have the appropriate
-//      *         <code>AdminPermission[this,RESOURCE]</code> and the Java
-//      *         Runtime Environment supports permissions.
-//      *
-//      * @throws java.lang.IllegalStateException If this bundle has been
-//      *         uninstalled.
-//      * @since 1.3
-//      */
-//     public URL getEntry(String path);
-//
-//     /**
-//      * Returns the time when this bundle was last modified. A bundle is
-//      * considered to be modified when it is installed, updated or uninstalled.
-//      *
-//      * <p>
-//      * The time value is the number of milliseconds since January 1, 1970,
-//      * 00:00:00 GMT.
-//      *
-//      * @return The time when this bundle was last modified.
-//      * @since 1.3
-//      */
-//     public long getLastModified();
-//
-//     /**
-//      * Returns entries in this bundle and its attached fragments. This bundle's
-//      * classloader is not used to search for entries. Only the contents of this
-//      * bundle and its attached fragments are searched for the specified entries.
-//      *
-//      * If this bundle's state is <code>INSTALLED</code>, this method must
-//      * attempt to resolve this bundle before attempting to find entries.
-//      *
-//      * <p>
-//      * This method is intended to be used to obtain configuration, setup,
-//      * localization and other information from this bundle. This method takes
-//      * into account that the &quot;contents&quot; of this bundle can be extended
-//      * with fragments. This &quot;bundle space&quot; is not a namespace with
-//      * unique members; the same entry name can be present multiple times. This
-//      * method therefore returns an enumeration of URL objects. These URLs can
-//      * come from different JARs but have the same path name. This method can
-//      * either return only entries in the specified path or recurse into
-//      * subdirectories returning entries in the directory tree beginning at the
-//      * specified path. Fragments can be attached after this bundle is resolved,
-//      * possibly changing the set of URLs returned by this method. If this bundle
-//      * is not resolved, only the entries in the JAR file of this bundle are
-//      * returned.
-//      * <p>
-//      * Examples:
-//      *
-//      * <pre>
-//      * // List all XML files in the OSGI-INF directory and below
-//      * Enumeration e = b.findEntries(&quot;OSGI-INF&quot;, &quot;*.xml&quot;, true);
-//      *
-//      * // Find a specific localization file
-//      * Enumeration e = b.findEntries(&quot;OSGI-INF/l10n&quot;,
-//      *                               &quot;bundle_nl_DU.properties&quot;,
-//      *                               false);
-//      * if (e.hasMoreElements())
-//      *  return (URL) e.nextElement();
-//      * </pre>
-//      *
-//      * @param path The path name in which to look. The path is always relative
-//      *        to the root of this bundle and may begin with &quot;/&quot;. A
-//      *        path value of &quot;/&quot; indicates the root of this bundle.
-//      * @param filePattern The file name pattern for selecting entries in the
-//      *        specified path. The pattern is only matched against the last
-//      *        element of the entry path and it supports substring matching, as
-//      *        specified in the Filter specification, using the wildcard
-//      *        character (&quot;*&quot;). If null is specified, this is
-//      *        equivalent to &quot;*&quot; and matches all files.
-//      * @param recurse If <code>true</code>, recurse into subdirectories.
-//      *        Otherwise only return entries from the specified path.
-//      * @return An enumeration of URL objects for each matching entry, or
-//      *         <code>null</code> if an entry could not be found or if the
-//      *         caller does not have the appropriate
-//      *         <code>AdminPermission[this,RESOURCE]</code>, and the Java
-//      *         Runtime Environment supports permissions. The URLs are sorted
-//      *         such that entries from this bundle are returned first followed by
-//      *         the entries from attached fragments in ascending bundle id order.
-//      *         If this bundle is a fragment, then only matching entries in this
-//      *         fragment are returned.
-//      * @since 1.3
-//      */
-//     public Enumeration findEntries(String path, String filePattern,
-//             bool recurse);
-//
-//     /**
-//      * Returns this bundle's {@link BundleContext}. The returned
-//      * <code>BundleContext</code> can be used by the caller to act on behalf
-//      * of this bundle.
-//      *
-//      * <p>
-//      * If this bundle is not in the {@link #STARTING}, {@link #ACTIVE}, or
-//      * {@link #STOPPING} states or this bundle is a fragment bundle, then this
-//      * bundle has no valid <code>BundleContext</code>. This method will
-//      * return <code>null</code> if this bundle has no valid
-//      * <code>BundleContext</code>.
-//      *
-//      * @return A <code>BundleContext</code> for this bundle or
-//      *         <code>null</code> if this bundle has no valid
-//      *         <code>BundleContext</code>.
-//      * @throws java.lang.SecurityException If the caller does not have the
-//      *         appropriate <code>AdminPermission[this,CONTEXT]</code>, and
-//      *         the Java Runtime Environment supports permissions.
-//      * @since 1.4
-//      */
-//     public BundleContext getBundleContext();
-}
diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLog.d
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLog.d	Tue Apr 14 13:22:56 2009 +0200
@@ -0,0 +1,99 @@
+/*******************************************************************************
+ * Copyright (c) 2004, 2008 IBM Corporation and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     IBM Corporation - initial API and implementation
+ *******************************************************************************/
+module org.eclipse.osgi.framework.log.FrameworkLog;
+import org.eclipse.osgi.framework.log.FrameworkLogEntry;
+
+import java.lang.all;
+import java.io.File;
+//import java.io.IOException;
+import java.io.Writer;
+
+import org.osgi.framework.FrameworkEvent;
+
+/**
+ * The FramworkLog interface.  A FrameworkLog implementation is provided by the
+ * FrameworkAdaptor and used by the Framework to log any error messages and
+ * FrameworkEvents of type ERROR.  The FrameworkLog may persist the log messages 
+ * to the filesystem or allow other ways of accessing the log information.
+ * @since 3.1
+ * @noimplement This interface is not intended to be implemented by clients.
+ */
+public interface FrameworkLog {
+    /**
+     * A service lookup constant (value "performance") indicating an 
+     * implementation of the logging service that logs performance events. 
+     * Create a filter with this property set to <code>"true"</code> in order to 
+     * obtain a performance log.
+     * 
+     * @since 3.1
+     */
+    public static final String SERVICE_PERFORMANCE = "performance"; //$NON-NLS-1$
+
+    /**
+     * Logs the information from a FrameworkEvent to the FrameworkLog.
+     * @param frameworkEvent The FrameworkEvent to log.
+     */
+    public void log(FrameworkEvent frameworkEvent);
+
+    /**
+     * Logs the FrameworkLogEntry to the FrameworkLog
+     * @param logEntry The entry to log.
+     */
+    public void log(FrameworkLogEntry logEntry);
+
+    /**
+     * Sets the current Writer used to log messages to the specified
+     * newWriter.  If append is set to true then the content
+     * of the current Writer will be appended to the new Writer 
+     * if possible.
+     * @param newWriter The Writer to use for logging messages. 
+     * @param append Indicates whether the content of the current Writer
+     * used for logging messages should be appended to the end of the new 
+     * Writer.
+     */
+    public void setWriter(Writer newWriter, bool append);
+
+    /** 
+     * Sets the current File used to log messages to a FileWriter
+     * using the specified File.  If append is set to true then the 
+     * content of the current Writer will be appended to the 
+     * new File if possible.
+     * @param newFile The File to create a new FileWriter which will be
+     * used for logging messages.
+     * @param append Indicates whether the content of the current Writer
+     * used for logging messages should be appended to the end of the new 
+     * File.
+     * @throws IOException if any problem occurs while constructing a
+     * FileWriter from the newFile.  If this exception is thrown the 
+     * FrameworkLog will not be effected and will continue to use the 
+     * current Writer to log messages.
+     */
+    public void setFile(File newFile, bool append) ;
+
+    /**
+     * Returns the log File if it is set, otherwise null is returned.
+     * @return the log File if it is set, otherwise null is returned.
+     */
+    public File getFile();
+
+    /**
+     * Sets the console log option.  If this is set then all logs will be
+     * logged to System.out as well as the current Writer.
+     * @param consoleLog indicates whether to log to System.out
+     */
+    public void setConsoleLog(bool consoleLog);
+
+    /**
+     * Closes the FrameworkLog.  After the FrameworkLog is closed messages may
+     * no longer be logged to it.
+     */
+    public void close();
+}
diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLogEntry.d
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLogEntry.d	Tue Apr 14 13:22:56 2009 +0200
@@ -0,0 +1,176 @@
+/*******************************************************************************
+ * Copyright (c) 2004, 2008 IBM Corporation and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     IBM Corporation - initial API and implementation
+ *******************************************************************************/
+
+module org.eclipse.osgi.framework.log.FrameworkLogEntry;
+
+import java.lang.all;
+
+/**
+ * A framework log entry used to log information to a FrameworkLog
+ * @since 3.1
+ * @noextend This class is not intended to be subclassed by clients.
+ */
+public class FrameworkLogEntry {
+    /**
+     * Severity constant (value 0) indicating this log entry represents the nominal case.
+     * @see #getSeverity()
+     * @since 3.2
+     */
+    public static final int OK = 0;
+
+    /** 
+     * Severity constant (bit mask, value 1) indicating this log entry is informational only.
+     * @see #getSeverity()
+     * @since 3.2
+     */
+    public static final int INFO = 0x01;
+
+    /** 
+     * Severity constant (bit mask, value 2) indicating this log entry represents a warning.
+     * @see #getSeverity()
+     * @since 3.2
+     */
+    public static final int WARNING = 0x02;
+
+    /** 
+     * Severity constant (bit mask, value 4) indicating this log entry represents an error.
+     * @see #getSeverity()
+     * @since 3.2
+     */
+    public static final int ERROR = 0x04;
+
+    /**
+     * Status type severity (bit mask, value 8) indicating this log entry represents a cancellation.
+     * @see #getSeverity()
+     * @since 3.2
+     */
+    public static final int CANCEL = 0x08;
+
+    // It would be nice to rename some of these fields but we cannot change the getter method
+    // names without breaking clients.  Changing only the field names would be confusing.
+    //TODO "entry" has another meaning here - title, summary, tag are better names 
+    private String entry;
+    private String message;
+    //TODO get rid of this
+    private int stackCode;
+    //TODO: use "reason" or "cause" instead
+    private Throwable throwable;
+    private FrameworkLogEntry[] children;
+    private int severity = 0;
+    private int bundleCode = 0;
+
+    /**
+     * Constructs a new FrameworkLogEntry
+     * @param entry the entry
+     * @param message the message
+     * @param stackCode the stack code
+     * @param throwable the throwable
+     * @param children the children
+     */
+    public this(String entry, String message, int stackCode, Throwable throwable, FrameworkLogEntry[] children) {
+        this.entry = entry;
+        this.message = message;
+        this.stackCode = stackCode;
+        this.throwable = throwable;
+        this.children = children;
+    }
+
+    /**
+     * Constructs a new FrameworkLogEntry
+     * @param entry the entry
+     * @param severity the severity
+     * @param bundleCode the bundle code
+     * @param message the message
+     * @param stackCode the stack code
+     * @param throwable the throwable
+     * @param children the children
+     * @since 3.2
+     */
+    public this(String entry, int severity, int bundleCode, String message, int stackCode, Throwable throwable, FrameworkLogEntry[] children) {
+        this.entry = entry;
+        this.message = message;
+        this.stackCode = stackCode;
+        this.throwable = throwable;
+        this.children = children;
+        this.severity = severity;
+        this.bundleCode = bundleCode;
+    }
+
+    /**
+     * 
+     * @return Returns the children.
+     */
+    public FrameworkLogEntry[] getChildren() {
+        return children;
+    }
+
+    /**
+     * @return Returns the entry.
+     */
+    public String getEntry() {
+        return entry;
+    }
+
+    /**
+     * @return Returns the message.
+     */
+    public String getMessage() {
+        return message;
+    }
+
+    /**
+     * @return Returns the stackCode.
+     */
+    public int getStackCode() {
+        return stackCode;
+    }
+
+    /**
+     * @return Returns the throwable.
+     */
+    public Throwable getThrowable() {
+        return throwable;
+    }
+
+    /**
+     * Returns the severity. The severities are as follows (in descending order):
+     * <ul>
+     * <li><code>CANCEL</code> - cancelation occurred</li>
+     * <li><code>ERROR</code> - a serious error (most severe)</li>
+     * <li><code>WARNING</code> - a warning (less severe)</li>
+     * <li><code>INFO</code> - an informational ("fyi") message (least severe)</li>
+     * <li><code>OK</code> - everything is just fine</li>
+     * </ul>
+     * <p>
+     * The severity of a multi-entry log is defined to be the maximum
+     * severity of any of its children, or <code>OK</code> if it has
+     * no children.
+     * </p>
+     *
+     * @return the severity: one of <code>OK</code>, <code>ERROR</code>, 
+     * <code>INFO</code>, <code>WARNING</code>,  or <code>CANCEL</code>
+     * @since 3.2
+     */
+    public int getSeverity() {
+        return severity;
+    }
+
+    /**
+     * Returns the bundle-specific code describing the outcome.
+     *
+     * @return bundle-specific code
+     * @since 3.2
+     */
+    public int getBundleCode() {
+        return bundleCode;
+    }
+
+}
diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/supplement/src/org/eclipse/osgi/util/NLS.d
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.eclipse.osgi/supplement/src/org/eclipse/osgi/util/NLS.d	Tue Apr 14 13:22:56 2009 +0200
@@ -0,0 +1,446 @@
+/*******************************************************************************
+ * Copyright (c) 2005, 2008 IBM Corporation and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ *     IBM - Initial API and implementation
+ * Port to the D programming language:
+ *     Frank Benoit <benoit@tionex.de>
+ *******************************************************************************/
+module org.osgi.util.NLS;
+
+import java.lang.all;
+
+// import java.io.IOException;
+// import java.io.InputStream;
+// import java.lang.reflect.Field;
+// import java.lang.reflect.Modifier;
+// import java.security.AccessController;
+// import java.security.PrivilegedAction;
+// import java.util.ArrayList;
+// import java.util.HashMap;
+// import java.util.Locale;
+// import java.util.Map;
+// import java.util.Properties;
+//
+// import org.eclipse.osgi.framework.debug.Debug;
+// import org.eclipse.osgi.framework.log.FrameworkLog;
+// import org.eclipse.osgi.framework.log.FrameworkLogEntry;
+
+/**
+ * Common superclass for all message bundle classes.  Provides convenience
+ * methods for manipulating messages.
+ * <p>
+ * The <code>#bind</code> methods perform string substitution and should be considered a
+ * convenience and <em>not</em> a full substitute replacement for <code>MessageFormat#format</code>
+ * method calls.
+ * </p>
+ * <p>
+ * Text appearing within curly braces in the given message, will be interpreted
+ * as a numeric index to the corresponding substitution object in the given array. Calling
+ * the <code>#bind</code> methods with text that does not map to an integer will result in an
+ * {@link IllegalArgumentException}.
+ * </p>
+ * <p>
+ * Text appearing within single quotes is treated as a literal. A single quote is escaped by
+ * a preceeding single quote.
+ * </p>
+ * <p>
+ * Clients who wish to use the full substitution power of the <code>MessageFormat</code> class should
+ * call that class directly and not use these <code>#bind</code> methods.
+ * </p>
+ * <p>
+ * Clients may subclass this type.
+ * </p>
+ *
+ * @since 3.1
+ */
+public abstract class NLS {
+
+//     private static final Object[] EMPTY_ARGS = new Object[0];
+//     private static final String EXTENSION = ".properties"; //$NON-NLS-1$
+//     private static String[] nlSuffixes;
+//     /*
+//      * NOTE do not change the name of this field; it is set by the Framework using reflection
+//      */
+//     private static FrameworkLog frameworkLog;
+//
+//     static final int SEVERITY_ERROR = 0x04;
+//     static final int SEVERITY_WARNING = 0x02;
+//     /*
+//      * This object is assigned to the value of a field map to indicate
+//      * that a translated message has already been assigned to that field.
+//      */
+//     static final Object ASSIGNED = new Object();
+//
+//     /**
+//      * Creates a new NLS instance.
+//      */
+//     protected NLS() {
+//         super();
+//     }
+
+    /**
+     * Bind the given message's substitution locations with the given string value.
+     *
+     * @param message the message to be manipulated
+     * @param binding the object to be inserted into the message
+     * @return the manipulated String
+     * @throws IllegalArgumentException if the text appearing within curly braces in the given message does not map to an integer
+     */
+    public static String bind(String message, Object binding) {
+        implMissing( __FILE__, __LINE__ );
+        return null;
+//         return internalBind(message, null, String.valueOf(binding), null);
+    }
+    public static String bind(String message, String binding) {
+        implMissing( __FILE__, __LINE__ );
+        return null;
+//         return internalBind(message, null, String.valueOf(binding), null);
+    }
+
+    /**
+     * Bind the given message's substitution locations with the given string values.
+     *
+     * @param message the message to be manipulated
+     * @param binding1 An object to be inserted into the message
+     * @param binding2 A second object to be inserted into the message
+     * @return the manipulated String
+     * @throws IllegalArgumentException if the text appearing within curly braces in the given message does not map to an integer
+     */
+    public static String bind(String message, Object binding1, Object binding2) {
+        implMissing( __FILE__, __LINE__ );
+        return null;
+//         return internalBind(message, null, String.valueOf(binding1), String.valueOf(binding2));
+    }
+    public static String bind(String message, String binding1, String binding2) {
+        implMissing( __FILE__, __LINE__ );
+        return null;
+//         return internalBind(message, null, String.valueOf(binding1), String.valueOf(binding2));
+    }
+
+    /**
+     * Bind the given message's substitution locations with the given string values.
+     *
+     * @param message the message to be manipulated
+     * @param bindings An array of objects to be inserted into the message
+     * @return the manipulated String
+     * @throws IllegalArgumentException if the text appearing within curly braces in the given message does not map to an integer
+     */
+    public static String bind(String message, Object[] bindings) {
+        implMissing( __FILE__, __LINE__ );
+        return null;
+//         return internalBind(message, bindings, null, null);
+    }
+    public static String bind(String message, String[] bindings) {
+        implMissing( __FILE__, __LINE__ );
+        return null;
+//         return internalBind(message, bindings, null, null);
+    }
+
+//     /**
+//      * Initialize the given class with the values from the specified message bundle.
+//      *
+//      * @param bundleName fully qualified path of the class name
+//      * @param clazz the class where the constants will exist
+//      */
+//     public static void initializeMessages(final String bundleName, final Class clazz) {
+//         if (System.getSecurityManager() is null) {
+//             load(bundleName, clazz);
+//             return;
+//         }
+//         AccessController.doPrivileged(new PrivilegedAction() {
+//             public Object run() {
+//                 load(bundleName, clazz);
+//                 return null;
+//             }
+//         });
+//     }
+//
+//     /*
+//      * Perform the string substitution on the given message with the specified args.
+//      * See the class comment for exact details.
+//      */
+//     private static String internalBind(String message, Object[] args, String argZero, String argOne) {
+//         if (message is null)
+//             return "No message available."; //$NON-NLS-1$
+//         if (args is null || args.length is 0)
+//             args = EMPTY_ARGS;
+//
+//         int length = message.length();
+//         //estimate correct size of string buffer to avoid growth
+//         int bufLen = length + (args.length * 5);
+//         if (argZero !is null)
+//             bufLen += argZero.length() - 3;
+//         if (argOne !is null)
+//             bufLen += argOne.length() - 3;
+//         StringBuffer buffer = new StringBuffer(bufLen < 0 ? 0 : bufLen);
+//         for (int i = 0; i < length; i++) {
+//             char c = message.charAt(i);
+//             switch (c) {
+//                 case '{' :
+//                     int index = message.indexOf('}', i);
+//                     // if we don't have a matching closing brace then...
+//                     if (index is -1) {
+//                         buffer.append(c);
+//                         break;
+//                     }
+//                     i++;
+//                     if (i >= length) {
+//                         buffer.append(c);
+//                         break;
+//                     }
+//                     // look for a substitution
+//                     int number = -1;
+//                     try {
+//                         number = Integer.parseInt(message.substring(i, index));
+//                     } catch (NumberFormatException e) {
+//                         throw new IllegalArgumentException();
+//                     }
+//                     if (number is 0 && argZero !is null)
+//                         buffer.append(argZero);
+//                     else if (number is 1 && argOne !is null)
+//                         buffer.append(argOne);
+//                     else {
+//                         if (number >= args.length || number < 0) {
+//                             buffer.append("<missing argument>"); //$NON-NLS-1$
+//                             i = index;
+//                             break;
+//                         }
+//                         buffer.append(args[number]);
+//                     }
+//                     i = index;
+//                     break;
+//                 case '\'' :
+//                     // if a single quote is the last char on the line then skip it
+//                     int nextIndex = i + 1;
+//                     if (nextIndex >= length) {
+//                         buffer.append(c);
+//                         break;
+//                     }
+//                     char next = message.charAt(nextIndex);
+//                     // if the next char is another single quote then write out one
+//                     if (next is '\'') {
+//                         i++;
+//                         buffer.append(c);
+//                         break;
+//                     }
+//                     // otherwise we want to read until we get to the next single quote
+//                     index = message.indexOf('\'', nextIndex);
+//                     // if there are no more in the string, then skip it
+//                     if (index is -1) {
+//                         buffer.append(c);
+//                         break;
+//                     }
+//                     // otherwise write out the chars inside the quotes
+//                     buffer.append(message.substring(nextIndex, index));
+//                     i = index;
+//                     break;
+//                 default :
+//                     buffer.append(c);
+//             }
+//         }
+//         return buffer.toString();
+//     }
+//
+//     /*
+//      * Build an array of property files to search.  The returned array contains
+//      * the property fields in order from most specific to most generic.
+//      * So, in the FR_fr locale, it will return file_fr_FR.properties, then
+//      * file_fr.properties, and finally file.properties.
+//      */
+//     private static String[] buildVariants(String root) {
+//         if (nlSuffixes is null) {
+//             //build list of suffixes for loading resource bundles
+//             String nl = Locale.getDefault().toString();
+//             ArrayList result = new ArrayList(4);
+//             int lastSeparator;
+//             while (true) {
+//                 result.add('_' + nl + EXTENSION);
+//                 lastSeparator = nl.lastIndexOf('_');
+//                 if (lastSeparator is -1)
+//                     break;
+//                 nl = nl.substring(0, lastSeparator);
+//             }
+//             //add the empty suffix last (most general)
+//             result.add(EXTENSION);
+//             nlSuffixes = (String[]) result.toArray(new String[result.size()]);
+//         }
+//         root = root.replace('.', '/');
+//         String[] variants = new String[nlSuffixes.length];
+//         for (int i = 0; i < variants.length; i++)
+//             variants[i] = root + nlSuffixes[i];
+//         return variants;
+//     }
+//
+//     private static void computeMissingMessages(String bundleName, Class clazz, Map fieldMap, Field[] fieldArray, bool isAccessible) {
+//         // iterate over the fields in the class to make sure that there aren't any empty ones
+//         final int MOD_EXPECTED = Modifier.PUBLIC | Modifier.STATIC;
+//         final int MOD_MASK = MOD_EXPECTED | Modifier.FINAL;
+//         final int numFields = fieldArray.length;
+//         for (int i = 0; i < numFields; i++) {
+//             Field field = fieldArray[i];
+//             if ((field.getModifiers() & MOD_MASK) !is MOD_EXPECTED)
+//                 continue;
+//             //if the field has a a value assigned, there is nothing to do
+//             if (fieldMap.get(field.getName()) is ASSIGNED)
+//                 continue;
+//             try {
+//                 // Set a value for this empty field. We should never get an exception here because
+//                 // we know we have a public static non-final field. If we do get an exception, silently
+//                 // log it and continue. This means that the field will (most likely) be un-initialized and
+//                 // will fail later in the code and if so then we will see both the NPE and this error.
+//                 String value = "NLS missing message: " + field.getName() + " in: " + bundleName; //$NON-NLS-1$ //$NON-NLS-2$
+//                 if (Debug.DEBUG_MESSAGE_BUNDLES)
+//                     System.out.println(value);
+//                 log(SEVERITY_WARNING, value, null);
+//                 if (!isAccessible)
+//                     field.setAccessible(true);
+//                 field.set(null, value);
+//             } catch (Exception e) {
+//                 log(SEVERITY_ERROR, "Error setting the missing message value for: " + field.getName(), e); //$NON-NLS-1$
+//             }
+//         }
+//     }
+//
+//     /*
+//      * Load the given resource bundle using the specified class loader.
+//      */
+//     static void load(final String bundleName, Class clazz) {
+//         long start = System.currentTimeMillis();
+//         final Field[] fieldArray = clazz.getDeclaredFields();
+//         ClassLoader loader = clazz.getClassLoader();
+//
+//         bool isAccessible = (clazz.getModifiers() & Modifier.PUBLIC) !is 0;
+//
+//         //build a map of field names to Field objects
+//         final int len = fieldArray.length;
+//         Map fields = new HashMap(len * 2);
+//         for (int i = 0; i < len; i++)
+//             fields.put(fieldArray[i].getName(), fieldArray[i]);
+//
+//         // search the variants from most specific to most general, since
+//         // the MessagesProperties.put method will mark assigned fields
+//         // to prevent them from being assigned twice
+//         final String[] variants = buildVariants(bundleName);
+//         for (int i = 0; i < variants.length; i++) {
+//             // loader is null if we're launched off the Java boot classpath
+//             final InputStream input = loader is null ? ClassLoader.getSystemResourceAsStream(variants[i]) : loader.getResourceAsStream(variants[i]);
+//             if (input is null)
+//                 continue;
+//             try {
+//                 final MessagesProperties properties = new MessagesProperties(fields, bundleName, isAccessible);
+//                 properties.load(input);
+//             } catch (IOException e) {
+//                 log(SEVERITY_ERROR, "Error loading " + variants[i], e); //$NON-NLS-1$
+//             } finally {
+//                 if (input !is null)
+//                     try {
+//                         input.close();
+//                     } catch (IOException e) {
+//                         // ignore
+//                     }
+//             }
+//         }
+//         computeMissingMessages(bundleName, clazz, fields, fieldArray, isAccessible);
+//         if (Debug.DEBUG_MESSAGE_BUNDLES)
+//             System.out.println("Time to load message bundle: " + bundleName + " was " + (System.currentTimeMillis() - start) + "ms."); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$
+//     }
+//
+//     /*
+//      * The method adds a log entry based on the error message and exception.
+//      * The output is written to the System.err.
+//      *
+//      * This method is only expected to be called if there is a problem in
+//      * the NLS mechanism. As a result, translation facility is not available
+//      * here and messages coming out of this log are generally not translated.
+//      *
+//      * @param severity - severity of the message (SEVERITY_ERROR or SEVERITY_WARNING)
+//      * @param message - message to log
+//      * @param e - exception to log
+//      */
+//     static void log(int severity, String message, Exception e) {
+//         if (frameworkLog !is null) {
+//             frameworkLog.log(new FrameworkLogEntry("org.eclipse.osgi", severity, 1, message, 0, e, null)); //$NON-NLS-1$
+//             return;
+//         }
+//         String statusMsg;
+//         switch (severity) {
+//             case SEVERITY_ERROR :
+//                 statusMsg = "Error: "; //$NON-NLS-1$
+//                 break;
+//             case SEVERITY_WARNING :
+//                 // intentionally fall through:
+//             default :
+//                 statusMsg = "Warning: "; //$NON-NLS-1$
+//         }
+//         if (message !is null)
+//             statusMsg += message;
+//         if (e !is null)
+//             statusMsg += ": " + e.getMessage(); //$NON-NLS-1$
+//         System.err.println(statusMsg);
+//         if (e !is null)
+//             e.printStackTrace();
+//     }
+//
+//     /*
+//      * Class which sub-classes java.util.Properties and uses the #put method
+//      * to set field values rather than storing the values in the table.
+//      */
+//     private static class MessagesProperties extends Properties {
+//
+//         private static final int MOD_EXPECTED = Modifier.PUBLIC | Modifier.STATIC;
+//         private static final int MOD_MASK = MOD_EXPECTED | Modifier.FINAL;
+//         private static final long serialVersionUID = 1L;
+//
+//         private final String bundleName;
+//         private final Map fields;
+//         private final bool isAccessible;
+//
+//         public MessagesProperties(Map fieldMap, String bundleName, bool isAccessible) {
+//             super();
+//             this.fields = fieldMap;
+//             this.bundleName = bundleName;
+//             this.isAccessible = isAccessible;
+//         }
+//
+//         /* (non-Javadoc)
+//          * @see java.util.Hashtable#put(java.lang.Object, java.lang.Object)
+//          */
+//         public synchronized Object put(Object key, Object value) {
+//             Object fieldObject = fields.put(key, ASSIGNED);
+//             // if already assigned, there is nothing to do
+//             if (fieldObject is ASSIGNED)
+//                 return null;
+//             if (fieldObject is null) {
+//                 final String msg = "NLS unused message: " + key + " in: " + bundleName;//$NON-NLS-1$ //$NON-NLS-2$
+//                 if (Debug.DEBUG_MESSAGE_BUNDLES)
+//                     System.out.println(msg);
+//                 log(SEVERITY_WARNING, msg, null);
+//                 return null;
+//             }
+//             final Field field = (Field) fieldObject;
+//             //can only set value of public static non-final fields
+//             if ((field.getModifiers() & MOD_MASK) !is MOD_EXPECTED)
+//                 return null;
+//             try {
+//                 // Check to see if we are allowed to modify the field. If we aren't (for instance
+//                 // if the class is not public) then change the accessible attribute of the field
+//                 // before trying to set the value.
+//                 if (!isAccessible)
+//                     field.setAccessible(true);
+//                 // Set the value into the field. We should never get an exception here because
+//                 // we know we have a public static non-final field. If we do get an exception, silently
+//                 // log it and continue. This means that the field will (most likely) be un-initialized and
+//                 // will fail later in the code and if so then we will see both the NPE and this error.
+//                 field.set(null, value);
+//             } catch (Exception e) {
+//                 log(SEVERITY_ERROR, "Exception setting field value.", e); //$NON-NLS-1$
+//             }
+//             return null;
+//         }
+//     }
+}
diff -r b2d6122fa189 -r 0628aaa2996c org.eclipse.osgi/supplement/src/org/osgi/util/NLS.d
--- a/org.eclipse.osgi/supplement/src/org/osgi/util/NLS.d	Tue Apr 14 12:11:09 2009 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,446 +0,0 @@
-/*******************************************************************************
- * Copyright (c) 2005, 2008 IBM Corporation and others.
- * All rights reserved. This program and the accompanying materials
- * are made available under the terms of the Eclipse Public License v1.0
- * which accompanies this distribution, and is available at
- * http://www.eclipse.org/legal/epl-v10.html
- *
- * Contributors:
- *     IBM - Initial API and implementation
- * Port to the D programming language:
- *     Frank Benoit <benoit@tionex.de>
- *******************************************************************************/
-module org.osgi.util.NLS;
-
-import java.lang.all;
-
-// import java.io.IOException;
-// import java.io.InputStream;
-// import java.lang.reflect.Field;
-// import java.lang.reflect.Modifier;
-// import java.security.AccessController;
-// import java.security.PrivilegedAction;
-// import java.util.ArrayList;
-// import java.util.HashMap;
-// import java.util.Locale;
-// import java.util.Map;
-// import java.util.Properties;
-//
-// import org.eclipse.osgi.framework.debug.Debug;
-// import org.eclipse.osgi.framework.log.FrameworkLog;
-// import org.eclipse.osgi.framework.log.FrameworkLogEntry;
-
-/**
- * Common superclass for all message bundle classes.  Provides convenience
- * methods for manipulating messages.
- * <p>
- * The <code>#bind</code> methods perform string substitution and should be considered a
- * convenience and <em>not</em> a full substitute replacement for <code>MessageFormat#format</code>
- * method calls.
- * </p>
- * <p>
- * Text appearing within curly braces in the given message, will be interpreted
- * as a numeric index to the corresponding substitution object in the given array. Calling
- * the <code>#bind</code> methods with text that does not map to an integer will result in an
- * {@link IllegalArgumentException}.
- * </p>
- * <p>
- * Text appearing within single quotes is treated as a literal. A single quote is escaped by
- * a preceeding single quote.
- * </p>
- * <p>
- * Clients who wish to use the full substitution power of the <code>MessageFormat</code> class should
- * call that class directly and not use these <code>#bind</code> methods.
- * </p>
- * <p>
- * Clients may subclass this type.
- * </p>
- *
- * @since 3.1
- */
-public abstract class NLS {
-
-//     private static final Object[] EMPTY_ARGS = new Object[0];
-//     private static final String EXTENSION = ".properties"; //$NON-NLS-1$
-//     private static String[] nlSuffixes;
-//     /*
-//      * NOTE do not change the name of this field; it is set by the Framework using reflection
-//      */
-//     private static FrameworkLog frameworkLog;
-//
-//     static final int SEVERITY_ERROR = 0x04;
-//     static final int SEVERITY_WARNING = 0x02;
-//     /*
-//      * This object is assigned to the value of a field map to indicate
-//      * that a translated message has already been assigned to that field.
-//      */
-//     static final Object ASSIGNED = new Object();
-//
-//     /**
-//      * Creates a new NLS instance.
-//      */
-//     protected NLS() {
-//         super();
-//     }
-
-    /**
-     * Bind the given message's substitution locations with the given string value.
-     *
-     * @param message the message to be manipulated
-     * @param binding the object to be inserted into the message
-     * @return the manipulated String
-     * @throws IllegalArgumentException if the text appearing within curly braces in the given message does not map to an integer
-     */
-    public static String bind(String message, Object binding) {
-        implMissing( __FILE__, __LINE__ );
-        return null;
-//         return internalBind(message, null, String.valueOf(binding), null);
-    }
-    public static String bind(String message, String binding) {
-        implMissing( __FILE__, __LINE__ );
-        return null;
-//         return internalBind(message, null, String.valueOf(binding), null);
-    }
-
-    /**
-     * Bind the given message's substitution locations with the given string values.
-     *
-     * @param message the message to be manipulated
-     * @param binding1 An object to be inserted into the message
-     * @param binding2 A second object to be inserted into the message
-     * @return the manipulated String
-     * @throws IllegalArgumentException if the text appearing within curly braces in the given message does not map to an integer
-     */
-    public static String bind(String message, Object binding1, Object binding2) {
-        implMissing( __FILE__, __LINE__ );
-        return null;
-//         return internalBind(message, null, String.valueOf(binding1), String.valueOf(binding2));
-    }
-    public static String bind(String message, String binding1, String binding2) {
-        implMissing( __FILE__, __LINE__ );
-        return null;
-//         return internalBind(message, null, String.valueOf(binding1), String.valueOf(binding2));
-    }
-
-    /**
-     * Bind the given message's substitution locations with the given string values.
-     *
-     * @param message the message to be manipulated
-     * @param bindings An array of objects to be inserted into the message
-     * @return the manipulated String
-     * @throws IllegalArgumentException if the text appearing within curly braces in the given message does not map to an integer
-     */
-    public static String bind(String message, Object[] bindings) {
-        implMissing( __FILE__, __LINE__ );
-        return null;
-//         return internalBind(message, bindings, null, null);
-    }
-    public static String bind(String message, String[] bindings) {
-        implMissing( __FILE__, __LINE__ );
-        return null;
-//         return internalBind(message, bindings, null, null);
-    }
-
-//     /**
-//      * Initialize the given class with the values from the specified message bundle.
-//      *
-//      * @param bundleName fully qualified path of the class name
-//      * @param clazz the class where the constants will exist
-//      */
-//     public static void initializeMessages(final String bundleName, final Class clazz) {
-//         if (System.getSecurityManager() is null) {
-//             load(bundleName, clazz);
-//             return;
-//         }
-//         AccessController.doPrivileged(new PrivilegedAction() {
-//             public Object run() {
-//                 load(bundleName, clazz);
-//                 return null;
-//             }
-//         });
-//     }
-//
-//     /*
-//      * Perform the string substitution on the given message with the specified args.
-//      * See the class comment for exact details.
-//      */
-//     private static String internalBind(String message, Object[] args, String argZero, String argOne) {
-//         if (message is null)
-//             return "No message available."; //$NON-NLS-1$
-//         if (args is null || args.length is 0)
-//             args = EMPTY_ARGS;
-//
-//         int length = message.length();
-//         //estimate correct size of string buffer to avoid growth
-//         int bufLen = length + (args.length * 5);
-//         if (argZero !is null)
-//             bufLen += argZero.length() - 3;
-//         if (argOne !is null)
-//             bufLen += argOne.length() - 3;
-//         StringBuffer buffer = new StringBuffer(bufLen < 0 ? 0 : bufLen);
-//         for (int i = 0; i < length; i++) {
-//             char c = message.charAt(i);
-//             switch (c) {
-//                 case '{' :
-//                     int index = message.indexOf('}', i);
-//                     // if we don't have a matching closing brace then...
-//                     if (index is -1) {
-//                         buffer.append(c);
-//                         break;
-//                     }
-//                     i++;
-//                     if (i >= length) {
-//                         buffer.append(c);
-//                         break;
-//                     }
-//                     // look for a substitution
-//                     int number = -1;
-//                     try {
-//                         number = Integer.parseInt(message.substring(i, index));
-//                     } catch (NumberFormatException e) {
-//                         throw new IllegalArgumentException();
-//                     }
-//                     if (number is 0 && argZero !is null)
-//                         buffer.append(argZero);
-//                     else if (number is 1 && argOne !is null)
-//                         buffer.append(argOne);
-//                     else {
-//                         if (number >= args.length || number < 0) {
-//                             buffer.append("<missing argument>"); //$NON-NLS-1$
-//                             i = index;
-//                             break;
-//                         }
-//                         buffer.append(args[number]);
-//                     }
-//                     i = index;
-//                     break;
-//                 case '\'' :
-//                     // if a single quote is the last char on the line then skip it
-//                     int nextIndex = i + 1;
-//                     if (nextIndex >= length) {
-//                         buffer.append(c);
-//                         break;
-//                     }
-//                     char next = message.charAt(nextIndex);
-//                     // if the next char is another single quote then write out one
-//                     if (next is '\'') {
-//                         i++;
-//                         buffer.append(c);
-//                         break;
-//                     }
-//                     // otherwise we want to read until we get to the next single quote
-//                     index = message.indexOf('\'', nextIndex);
-//                     // if there are no more in the string, then skip it
-//                     if (index is -1) {
-//                         buffer.append(c);
-//                         break;
-//                     }
-//                     // otherwise write out the chars inside the quotes
-//                     buffer.append(message.substring(nextIndex, index));
-//                     i = index;
-//                     break;
-//                 default :
-//                     buffer.append(c);
-//             }
-//         }
-//         return buffer.toString();
-//     }
-//
-//     /*
-//      * Build an array of property files to search.  The returned array contains
-//      * the property fields in order from most specific to most generic.
-//      * So, in the FR_fr locale, it will return file_fr_FR.properties, then
-//      * file_fr.properties, and finally file.properties.
-//      */
-//     private static String[] buildVariants(String root) {
-//         if (nlSuffixes is null) {
-//             //build list of suffixes for loading resource bundles
-//             String nl = Locale.getDefault().toString();
-//             ArrayList result = new ArrayList(4);
-//             int lastSeparator;
-//             while (true) {
-//                 result.add('_' + nl + EXTENSION);
-//                 lastSeparator = nl.lastIndexOf('_');
-//                 if (lastSeparator is -1)
-//                     break;
-//                 nl = nl.substring(0, lastSeparator);
-//             }
-//             //add the empty suffix last (most general)
-//             result.add(EXTENSION);
-//             nlSuffixes = (String[]) result.toArray(new String[result.size()]);
-//         }
-//         root = root.replace('.', '/');
-//         String[] variants = new String[nlSuffixes.length];
-//         for (int i = 0; i < variants.length; i++)
-//             variants[i] = root + nlSuffixes[i];
-//         return variants;
-//     }
-//
-//     private static void computeMissingMessages(String bundleName, Class clazz, Map fieldMap, Field[] fieldArray, bool isAccessible) {
-//         // iterate over the fields in the class to make sure that there aren't any empty ones
-//         final int MOD_EXPECTED = Modifier.PUBLIC | Modifier.STATIC;
-//         final int MOD_MASK = MOD_EXPECTED | Modifier.FINAL;
-//         final int numFields = fieldArray.length;
-//         for (int i = 0; i < numFields; i++) {
-//             Field field = fieldArray[i];
-//             if ((field.getModifiers() & MOD_MASK) !is MOD_EXPECTED)
-//                 continue;
-//             //if the field has a a value assigned, there is nothing to do
-//             if (fieldMap.get(field.getName()) is ASSIGNED)
-//                 continue;
-//             try {
-//                 // Set a value for this empty field. We should never get an exception here because
-//                 // we know we have a public static non-final field. If we do get an exception, silently
-//                 // log it and continue. This means that the field will (most likely) be un-initialized and
-//                 // will fail later in the code and if so then we will see both the NPE and this error.
-//                 String value = "NLS missing message: " + field.getName() + " in: " + bundleName; //$NON-NLS-1$ //$NON-NLS-2$
-//                 if (Debug.DEBUG_MESSAGE_BUNDLES)
-//                     System.out.println(value);
-//                 log(SEVERITY_WARNING, value, null);
-//                 if (!isAccessible)
-//                     field.setAccessible(true);
-//                 field.set(null, value);
-//             } catch (Exception e) {
-//                 log(SEVERITY_ERROR, "Error setting the missing message value for: " + field.getName(), e); //$NON-NLS-1$
-//             }
-//         }
-//     }
-//
-//     /*
-//      * Load the given resource bundle using the specified class loader.
-//      */
-//     static void load(final String bundleName, Class clazz) {
-//         long start = System.currentTimeMillis();
-//         final Field[] fieldArray = clazz.getDeclaredFields();
-//         ClassLoader loader = clazz.getClassLoader();
-//
-//         bool isAccessible = (clazz.getModifiers() & Modifier.PUBLIC) !is 0;
-//
-//         //build a map of field names to Field objects
-//         final int len = fieldArray.length;
-//         Map fields = new HashMap(len * 2);
-//         for (int i = 0; i < len; i++)
-//             fields.put(fieldArray[i].getName(), fieldArray[i]);
-//
-//         // search the variants from most specific to most general, since
-//         // the MessagesProperties.put method will mark assigned fields
-//         // to prevent them from being assigned twice
-//         final String[] variants = buildVariants(bundleName);
-//         for (int i = 0; i < variants.length; i++) {
-//             // loader is null if we're launched off the Java boot classpath
-//             final InputStream input = loader is null ? ClassLoader.getSystemResourceAsStream(variants[i]) : loader.getResourceAsStream(variants[i]);
-//             if (input is null)
-//                 continue;
-//             try {
-//                 final MessagesProperties properties = new MessagesProperties(fields, bundleName, isAccessible);
-//                 properties.load(input);
-//             } catch (IOException e) {
-//                 log(SEVERITY_ERROR, "Error loading " + variants[i], e); //$NON-NLS-1$
-//             } finally {
-//                 if (input !is null)
-//                     try {
-//                         input.close();
-//                     } catch (IOException e) {
-//                         // ignore
-//                     }
-//             }
-//         }
-//         computeMissingMessages(bundleName, clazz, fields, fieldArray, isAccessible);
-//         if (Debug.DEBUG_MESSAGE_BUNDLES)
-//             System.out.println("Time to load message bundle: " + bundleName + " was " + (System.currentTimeMillis() - start) + "ms."); //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$
-//     }
-//
-//     /*
-//      * The method adds a log entry based on the error message and exception.
-//      * The output is written to the System.err.
-//      *
-//      * This method is only expected to be called if there is a problem in
-//      * the NLS mechanism. As a result, translation facility is not available
-//      * here and messages coming out of this log are generally not translated.
-//      *
-//      * @param severity - severity of the message (SEVERITY_ERROR or SEVERITY_WARNING)
-//      * @param message - message to log
-//      * @param e - exception to log
-//      */
-//     static void log(int severity, String message, Exception e) {
-//         if (frameworkLog !is null) {
-//             frameworkLog.log(new FrameworkLogEntry("org.eclipse.osgi", severity, 1, message, 0, e, null)); //$NON-NLS-1$
-//             return;
-//         }
-//         String statusMsg;
-//         switch (severity) {
-//             case SEVERITY_ERROR :
-//                 statusMsg = "Error: "; //$NON-NLS-1$
-//                 break;
-//             case SEVERITY_WARNING :
-//                 // intentionally fall through:
-//             default :
-//                 statusMsg = "Warning: "; //$NON-NLS-1$
-//         }
-//         if (message !is null)
-//             statusMsg += message;
-//         if (e !is null)
-//             statusMsg += ": " + e.getMessage(); //$NON-NLS-1$
-//         System.err.println(statusMsg);
-//         if (e !is null)
-//             e.printStackTrace();
-//     }
-//
-//     /*
-//      * Class which sub-classes java.util.Properties and uses the #put method
-//      * to set field values rather than storing the values in the table.
-//      */
-//     private static class MessagesProperties extends Properties {
-//
-//         private static final int MOD_EXPECTED = Modifier.PUBLIC | Modifier.STATIC;
-//         private static final int MOD_MASK = MOD_EXPECTED | Modifier.FINAL;
-//         private static final long serialVersionUID = 1L;
-//
-//         private final String bundleName;
-//         private final Map fields;
-//         private final bool isAccessible;
-//
-//         public MessagesProperties(Map fieldMap, String bundleName, bool isAccessible) {
-//             super();
-//             this.fields = fieldMap;
-//             this.bundleName = bundleName;
-//             this.isAccessible = isAccessible;
-//         }
-//
-//         /* (non-Javadoc)
-//          * @see java.util.Hashtable#put(java.lang.Object, java.lang.Object)
-//          */
-//         public synchronized Object put(Object key, Object value) {
-//             Object fieldObject = fields.put(key, ASSIGNED);
-//             // if already assigned, there is nothing to do
-//             if (fieldObject is ASSIGNED)
-//                 return null;
-//             if (fieldObject is null) {
-//                 final String msg = "NLS unused message: " + key + " in: " + bundleName;//$NON-NLS-1$ //$NON-NLS-2$
-//                 if (Debug.DEBUG_MESSAGE_BUNDLES)
-//                     System.out.println(msg);
-//                 log(SEVERITY_WARNING, msg, null);
-//                 return null;
-//             }
-//             final Field field = (Field) fieldObject;
-//             //can only set value of public static non-final fields
-//             if ((field.getModifiers() & MOD_MASK) !is MOD_EXPECTED)
-//                 return null;
-//             try {
-//                 // Check to see if we are allowed to modify the field. If we aren't (for instance
-//                 // if the class is not public) then change the accessible attribute of the field
-//                 // before trying to set the value.
-//                 if (!isAccessible)
-//                     field.setAccessible(true);
-//                 // Set the value into the field. We should never get an exception here because
-//                 // we know we have a public static non-final field. If we do get an exception, silently
-//                 // log it and continue. This means that the field will (most likely) be un-initialized and
-//                 // will fail later in the code and if so then we will see both the NPE and this error.
-//                 field.set(null, value);
-//             } catch (Exception e) {
-//                 log(SEVERITY_ERROR, "Exception setting field value.", e); //$NON-NLS-1$
-//             }
-//             return null;
-//         }
-//     }
-}