Bug 227409 Convert org.eclipse.osgi to use api tooling

12 files changed, 27 insertions, 8 deletions

diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventListeners.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventListeners.java
index b99172b87..c7f7702b4 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventListeners.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventListeners.java
@@ -15,6 +15,7 @@ package org.eclipse.osgi.framework.eventmgr;
  * This class manages a list of listeners.
  * Listeners may be added or removed as necessary.
  * @since 3.1
+ * @noextend This class is not intended to be subclassed by clients.
  */
 public class EventListeners {
 	/**
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventManager.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventManager.java
index 38d4e010a..0b605e5be 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventManager.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/eventmgr/EventManager.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2003, 2007 IBM Corporation and others.
+ * Copyright (c) 2003, 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
@@ -94,6 +94,7 @@ import org.eclipse.osgi.framework.eventmgr.EventListeners.ListElement;
  * <p> The highly dynamic nature of the OSGi framework had necessitated these features for 
  * proper and efficient event delivery.  
  * @since 3.1
+ * @noextend This class is not intended to be subclassed by clients.
  */
 
 public class EventManager {
@@ -143,6 +144,7 @@ public class EventManager {
 	 * this EventManager.  A <code>null</code> value is allowed.
 	 * @param threadGroup The thread group to use for the asynchronous event
 	 * thread associated with this EventManager. A <code>null</code> value is allowed.
+	 * @since 3.4
 	 */
 	public EventManager(String threadName, ThreadGroup threadGroup) {
 		thread = null;
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLog.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLog.java
index ca0b7f0b4..123894ae0 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLog.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLog.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2004, 2005 IBM Corporation and others.
+ * 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
@@ -19,6 +19,7 @@ import org.osgi.framework.FrameworkEvent;
  * 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 {
 	/**
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLogEntry.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLogEntry.java
index 18005b7dd..d64a4226e 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLogEntry.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/framework/log/FrameworkLogEntry.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2004, 2006 IBM Corporation and others.
+ * 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
@@ -14,6 +14,7 @@ package org.eclipse.osgi.framework.log;
 /**
  * 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 {
 	/**
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/datalocation/Location.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/datalocation/Location.java
index a86504844..3c24442cc 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/datalocation/Location.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/datalocation/Location.java
@@ -21,6 +21,7 @@ import java.net.URL;
  * </p>
  * 
  * @since 3.0
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface Location {
 
@@ -168,6 +169,7 @@ public interface Location {
 	 * otherwise.
 	 * @return boolean value indicating whether or not this location is locked
 	 * @throws IOException if there was an unexpected problem reading the lock
+	 * @since 3.4
 	 */
 	public boolean isLocked() throws IOException;
 
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/Constants.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/Constants.java
index 9ea62b4b7..e8871b55b 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/Constants.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/Constants.java
@@ -11,10 +11,12 @@
 package org.eclipse.osgi.service.environment;
 
 /**
+ * Constants used with the {@link EnvironmentInfo} service.
  * @since 3.0
  * <p>
  * This interface is not intended to be implemented by clients.
  * </p>
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface Constants {
 	//TODO These constants need to be aligned with the OSGi ones. See page 64-588 of the spec
@@ -64,6 +66,7 @@ public interface Constants {
 	/**
 	 * Constant string (value "epoc32") indicating the platform is running on a
 	 * Epoc 32-bit Symbian operating system.
+	 * @since 3.4
 	 */
 	public static final String OS_EPOC32 = "epoc32";//$NON-NLS-1$
 
@@ -167,6 +170,7 @@ public interface Constants {
 	/**
 	 * Constant string (value "s60") indicating the platform is running on a
 	 * machine using the S60 windowing system.
+	 * @since 3.4
 	 */
 	public static final String WS_S60 = "s60";//$NON-NLS-1$
 
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/EnvironmentInfo.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/EnvironmentInfo.java
index 6c3c85b94..bbb058857 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/EnvironmentInfo.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/environment/EnvironmentInfo.java
@@ -20,9 +20,10 @@ package org.eclipse.osgi.service.environment;
  * </p>
  * 
  * @since 3.0
- * XXX Need to add a method that gets the real application args.
- * We might also want to explain how the command line is organized: fwk / non fwk. Non-fwk is rt args and app args.
+ * @noimplement This interface is not intended to be implemented by clients.
  */
+// TODO  Need to add a method that gets the real application args.
+//We might also want to explain how the command line is organized: fwk / non fwk. Non-fwk is rt args and app args.
 public interface EnvironmentInfo {
 
 	/**
@@ -116,6 +117,7 @@ public interface EnvironmentInfo {
 	 * </p>
 	 * @param key the property key
 	 * @return the value of the property, or null
+	 * @since 3.4
 	 */
 	public String getProperty(String key);
 
@@ -131,6 +133,7 @@ public interface EnvironmentInfo {
 	 * @param key the property key
 	 * @param value the value of the property
 	 * @return the old value of the property, or null
+	 * @since 3.4
 	 */
 	public String setProperty(String key, String value);
 }
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/localization/BundleLocalization.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/localization/BundleLocalization.java
index 31b4ff3d9..ceda998c6 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/localization/BundleLocalization.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/localization/BundleLocalization.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2004, 2006 IBM Corporation and others.
+ * 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
@@ -20,6 +20,7 @@ import org.osgi.framework.Bundle;
  * This interface is not intended to be implemented by clients.
  * </p>
  * @since 3.1
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface BundleLocalization {
 
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/runnable/ApplicationLauncher.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/runnable/ApplicationLauncher.java
index e08e1ebde..b1be943d3 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/runnable/ApplicationLauncher.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/service/runnable/ApplicationLauncher.java
@@ -19,6 +19,7 @@ package org.eclipse.osgi.service.runnable;
  * </p>
  * 
  * @since 3.2
+ * @noimplement This interface is not intended to be implemented by clients.
  */
 public interface ApplicationLauncher {
 	/**
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/ManagedOutputStream.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/ManagedOutputStream.java
index 4c4cf045d..e0fc40338 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/ManagedOutputStream.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/ManagedOutputStream.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2006 IBM Corporation and others.
+ * 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
@@ -19,6 +19,7 @@ import java.io.*;
  * <p>
  * Clients may not extend this class.
  * </p>
+ * @noextend This class is not intended to be subclassed by clients.
  * @since 3.2
  */
 // Note the implementation of this class originated from the following deprecated classes:
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/StorageManager.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/StorageManager.java
index 54906d843..d96a8fd15 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/StorageManager.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/storagemanager/StorageManager.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2004, 2006 IBM Corporation and others.
+ * 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
@@ -78,6 +78,7 @@ import org.eclipse.osgi.framework.util.SecureAction;
  * content as it was when the instance was first opened.
  * </p>
  * @since 3.2
+ * @noextend This class is not intended to be subclassed by clients.
  */
 
 // Note the implementation of this class originated from the following deprecated classes: 
diff --git a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/util/ManifestElement.java b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/util/ManifestElement.java
index bc30abb96..9e103a7c2 100644
--- a/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/util/ManifestElement.java
+++ b/bundles/org.eclipse.osgi/supplement/src/org/eclipse/osgi/util/ManifestElement.java
@@ -64,6 +64,7 @@ import org.osgi.framework.BundleException;
  * </p>
  * 
  * @since 3.0
+ * @noextend This class is not intended to be subclassed by clients.
  */
 public class ManifestElement {