You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jclouds.apache.org by na...@apache.org on 2018/01/17 08:07:49 UTC

[22/50] [abbrv] jclouds git commit: Normalize deprecation messages to make them easier to find

Normalize deprecation messages to make them easier to find


Project: http://git-wip-us.apache.org/repos/asf/jclouds/repo
Commit: http://git-wip-us.apache.org/repos/asf/jclouds/commit/b02114bd
Tree: http://git-wip-us.apache.org/repos/asf/jclouds/tree/b02114bd
Diff: http://git-wip-us.apache.org/repos/asf/jclouds/diff/b02114bd

Branch: refs/heads/master
Commit: b02114bdaf5cb96d16f95c85a573489027ff0aa0
Parents: cc6ff3b
Author: Everett Toews <ev...@apache.org>
Authored: Wed Jan 21 10:34:48 2015 -0600
Committer: Everett Toews <ev...@apache.org>
Committed: Wed Jan 21 11:02:14 2015 -0600

----------------------------------------------------------------------
 .../jclouds/openstack/neutron/v2_0/NeutronApi.java   | 15 +++++++--------
 .../openstack/neutron/v2_0/NeutronApiMetadata.java   |  1 +
 .../openstack/neutron/v2_0/extensions/RouterApi.java |  4 ++--
 .../openstack/neutron/v2_0/features/NetworkApi.java  |  3 ++-
 .../openstack/neutron/v2_0/features/PortApi.java     |  3 ++-
 .../openstack/neutron/v2_0/features/SubnetApi.java   |  3 ++-
 6 files changed, 16 insertions(+), 13 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/jclouds/blob/b02114bd/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApi.java b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApi.java
index a5ff027..d39bc3c 100644
--- a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApi.java
+++ b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApi.java
@@ -39,8 +39,7 @@ import com.google.inject.Provides;
  * Provides access to the OpenStack Networking (Neutron) v2 API.
  * <p/>
  *
- * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.NeutronApi} as this
- *             interface will be removed in jclouds 3.0.
+ * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.NeutronApi} instead. To be removed in jclouds 2.0.
  */
 @Deprecated
 public interface NeutronApi extends Closeable {
@@ -84,7 +83,7 @@ public interface NeutronApi extends Closeable {
 
    /**
     * @return the Zone codes configured
-    * @deprecated Please use {@link #getConfiguredRegions()} as this method will be removed in jclouds 3.0.
+    * @deprecated Please use {@link #getConfiguredRegions()} instead. To be removed in jclouds 2.0.
     */
    @Deprecated
    @Provides
@@ -93,7 +92,7 @@ public interface NeutronApi extends Closeable {
 
    /**
     * Provides access to Extension features.
-    * @deprecated Please use {@link #getExtensionApi(String)} as this method will be removed in jclouds 3.0.
+    * @deprecated Please use {@link #getExtensionApi(String)} instead. To be removed in jclouds 2.0.
     */
    @Deprecated
    @Delegate
@@ -102,7 +101,7 @@ public interface NeutronApi extends Closeable {
 
    /**
     * Provides access to Network features.
-    * @deprecated Please use {@link #getNetworkApi(String)} as this method will be removed in jclouds 3.0.
+    * @deprecated Please use {@link #getNetworkApi(String)} instead. To be removed in jclouds 2.0.
     */
    @Deprecated
    @Delegate
@@ -110,7 +109,7 @@ public interface NeutronApi extends Closeable {
 
    /**
     * Provides access to Subnet features.
-    * @deprecated Please use {@link #getSubnetApi(String)} as this method will be removed in jclouds 3.0.
+    * @deprecated Please use {@link #getSubnetApi(String)} instead. To be removed in jclouds 2.0.
     */
    @Deprecated
    @Delegate
@@ -118,7 +117,7 @@ public interface NeutronApi extends Closeable {
 
    /**
     * Provides access to Port features.
-    * @deprecated Please use {@link #getPortApi(String)} as this method will be removed in jclouds 3.0.
+    * @deprecated Please use {@link #getPortApi(String)} instead. To be removed in jclouds 2.0.
     */
    @Deprecated
    @Delegate
@@ -126,7 +125,7 @@ public interface NeutronApi extends Closeable {
 
    /**
     * Provides access to Router features.
-    * @deprecated Please use {@link #getRouterApi(String)} as this method will be removed in jclouds 3.0.
+    * @deprecated Please use {@link #getRouterApi(String)} instead. To be removed in jclouds 2.0.
     */
    @Deprecated
    @Delegate

http://git-wip-us.apache.org/repos/asf/jclouds/blob/b02114bd/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApiMetadata.java
----------------------------------------------------------------------
diff --git a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApiMetadata.java b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApiMetadata.java
index 8d5e51c..f333647 100644
--- a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApiMetadata.java
+++ b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/NeutronApiMetadata.java
@@ -38,6 +38,7 @@ import com.google.inject.Module;
 
 /**
  * Implementation of {@link org.jclouds.apis.ApiMetadata} for Neutron 2.0 API
+ * @deprecated To be removed in jclouds 2.0.
  */
 @Deprecated
 @AutoService(ApiMetadata.class)

http://git-wip-us.apache.org/repos/asf/jclouds/blob/b02114bd/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/extensions/RouterApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/extensions/RouterApi.java b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/extensions/RouterApi.java
index dca4427..3da0e34 100644
--- a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/extensions/RouterApi.java
+++ b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/extensions/RouterApi.java
@@ -56,8 +56,8 @@ import org.jclouds.rest.annotations.Transform;
  * A logical entity for forwarding packets across internal subnets and NATting them on external
  * networks through an appropriate external gateway.
  *
- * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.extensions.RouterApi} as this
- *             interface will be removed in jclouds 3.0.
+ * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.extensions.RouterApi} instead.
+ *             To be removed in jclouds 2.0.
  */
 @Deprecated
 @Path("/v2.0/routers")

http://git-wip-us.apache.org/repos/asf/jclouds/blob/b02114bd/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/NetworkApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/NetworkApi.java b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/NetworkApi.java
index c2b4aa5..dc7b005 100644
--- a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/NetworkApi.java
+++ b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/NetworkApi.java
@@ -59,7 +59,8 @@ import static org.jclouds.openstack.keystone.v2_0.KeystoneFallbacks.EmptyPaginat
  *
  * @see <a href=
  *      "http://docs.openstack.org/api/openstack-network/2.0/content/Networks.html">api doc</a>
- * @deprecated Use v2 instead of v2_0
+ * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.features.NetworkApi} instead.
+ *             To be removed in jclouds 2.0.
  */
 @Deprecated
 @Path("/v2.0/networks")

http://git-wip-us.apache.org/repos/asf/jclouds/blob/b02114bd/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/PortApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/PortApi.java b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/PortApi.java
index 7390131..4aef5cd 100644
--- a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/PortApi.java
+++ b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/PortApi.java
@@ -62,7 +62,8 @@ import static org.jclouds.openstack.keystone.v2_0.KeystoneFallbacks.EmptyPaginat
 
  * @see <a href=
  *      "http://docs.openstack.org/api/openstack-network/2.0/content/Ports.html">api doc</a>
- * @deprecated Use v2 instead of v2_0
+ * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.features.PortApi} instead.
+ *             To be removed in jclouds 2.0.
  */
 @Deprecated
 @Path("/v2.0/ports")

http://git-wip-us.apache.org/repos/asf/jclouds/blob/b02114bd/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/SubnetApi.java
----------------------------------------------------------------------
diff --git a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/SubnetApi.java b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/SubnetApi.java
index 5c2acc5..24ce4b3 100644
--- a/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/SubnetApi.java
+++ b/apis/openstack-neutron/src/main/java/org/jclouds/openstack/neutron/v2_0/features/SubnetApi.java
@@ -58,7 +58,8 @@ import static org.jclouds.openstack.keystone.v2_0.KeystoneFallbacks.EmptyPaginat
 
  * @see <a href=
  *      "http://docs.openstack.org/api/openstack-network/2.0/content/Subnets.html">api doc</a>
- * @deprecated Use v2 instead of v2_0
+ * @deprecated Please use {@link org.jclouds.openstack.neutron.v2.features.SubnetApi} instead.
+ *             To be removed in jclouds 2.0.
  */
 @Deprecated
 @Path("/v2.0/subnets")