Normalize deprecation messages to make them easier to find

This commit is contained in:
Everett Toews 2015-01-21 10:34:48 -06:00
parent cc6ff3b84e
commit b02114bdaf
6 changed files with 16 additions and 13 deletions

View File

@ -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

View File

@ -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)

View File

@ -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")

View File

@ -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")

View File

@ -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")

View File

@ -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")