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 <[email protected]> Authored: Wed Jan 21 10:34:48 2015 -0600 Committer: Everett Toews <[email protected]> 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")
