Regard the release when the APIs became deprecated as Cardinal

Change-Id: I072fa33a2a70baa7466d7a0dc5067191476be0f3

@@ -57,6 +57,7 @@ import static org.onosproject.net.DeviceId.deviceId;
  * optical links and any other state that needs to be configured for correct network
  * operations.
  *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 @JsonIgnoreProperties(ignoreUnknown = true)

@@ -21,6 +21,8 @@ import org.onlab.util.HexString;
 
 /**
  * Public class corresponding to JSON described data model.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 public class OpticalLinkDescription {

@@ -23,6 +23,8 @@ import org.slf4j.LoggerFactory;
 
 /**
  * Public class corresponding to JSON described data model.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 public class OpticalNetworkConfig {

@@ -22,6 +22,8 @@ import org.onlab.util.HexString;
 
 /**
  * Public class corresponding to JSON described data model.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 public class OpticalSwitchDescription {

@@ -17,6 +17,8 @@ package org.onosproject.optical.cfg;
 
 /**
  * Packet-optical link Java data object.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 class PktOptLink {

@@ -17,6 +17,8 @@ package org.onosproject.optical.cfg;
 
 /**
  * ROADM java data object converted from a JSON file.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 class Roadm {

@@ -17,6 +17,8 @@ package org.onosproject.optical.cfg;
 
 /**
  * WDM Link Java data object converted from a JSON file.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 class WdmLink {

@@ -199,6 +199,7 @@ public class OnosXOSIntegrationManager implements VoltTenantService {
      * with no additional URI.
      *
      * @return web resource builder
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     private WebResource.Builder getClientBuilder() {
@@ -210,6 +211,7 @@ public class OnosXOSIntegrationManager implements VoltTenantService {
      * with an optional additional URI.
      *
      * @return web resource builder
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     private WebResource.Builder getClientBuilder(String uri) {
@@ -227,6 +229,7 @@ public class OnosXOSIntegrationManager implements VoltTenantService {
      * Performs a REST GET operation on the base XOS REST URI.
      *
      * @return JSON string fetched by the GET operation
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     private String getRest() {
@@ -238,6 +241,7 @@ public class OnosXOSIntegrationManager implements VoltTenantService {
      * an optional additional URI.
      *
      * @return JSON string fetched by the GET operation
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     private String getRest(String uri) {
@@ -259,6 +263,7 @@ public class OnosXOSIntegrationManager implements VoltTenantService {
      * XOS REST URI with an optional additional URI.
      *
      * @param json JSON string to post
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     private String postRest(String json) {
@@ -284,6 +289,7 @@ public class OnosXOSIntegrationManager implements VoltTenantService {
      * XOS REST URI with an optional additional URI.
      *
      * @param uri optional additional URI
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     private void deleteRest(String uri) {

@@ -32,6 +32,8 @@ public interface FlowRule {
      * The FlowRule type is used to determine in which table the flow rule needs
      * to be put for multi-table support switch. For single table switch,
      * Default is used.
+     *
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     static enum Type {

@@ -51,6 +51,7 @@ public interface FlowRuleStore extends Store<FlowRuleBatchEvent, FlowRuleStoreDe
      * Stores a new flow rule without generating events.
      *
      * @param rule the flow rule to add
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     void storeFlowRule(FlowRule rule);

@@ -284,6 +284,7 @@ public final class Instructions {
      *
      * @param etherType Ethernet type to set
      * @return a L2 modification.
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     public static Instruction popMpls(int etherType) {

@@ -57,7 +57,7 @@ implements GraphDescription {
      * @param links collection of infrastructure links
      *
      * @param annotations optional key/value annotations map
-     *
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     public DefaultGraphDescription(long nanos, Iterable<Device> devices,

@@ -35,6 +35,7 @@ public interface ClusterCommunicationService {
      * @param subject    message subject
      * @param subscriber message subscriber
      * @param executor executor to use for running handler.
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     void addSubscriber(MessageSubject subject, ClusterMessageHandler subscriber, ExecutorService executor);

@@ -38,6 +38,7 @@ public final class JsonUtils {
      * @param sid     sequence ID
      * @param payload event payload
      * @return the object node representation
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     public static ObjectNode envelope(String type, long sid, ObjectNode payload) {

@@ -105,6 +105,10 @@ public final class MastershipBasedTimestamp implements Timestamp {
     }
 
     // Default constructor for serialization
+
+    /**
+     * @deprecated in Cardinal Release
+     */
     @Deprecated
     protected MastershipBasedTimestamp() {
         this.termNumber = -1;

@@ -108,6 +108,9 @@ public final class Timestamped<T> {
     }
 
     // Default constructor for serialization
+    /**
+     * @deprecated in Cardinal Release
+     */
     @Deprecated
     private Timestamped() {
         this.value = null;

@@ -75,6 +75,7 @@ public interface IPacket {
      * @param length
      *            length of the data to deserialize
      * @return the deserialized data
+     * @deprecated in Cardinal Release
      */
     @Deprecated
     IPacket deserialize(byte[] data, int offset, int length);

@@ -197,6 +197,9 @@ public class TopologyViewMessageHandler extends TopologyViewMessageHandlerBase {
 
     // ==================================================================
 
+    /**
+     * @deprecated in Cardinal Release
+     */
     @Deprecated
     private final class TopoStart extends RequestHandler {
         private TopoStart() {
@@ -213,6 +216,9 @@ public class TopologyViewMessageHandler extends TopologyViewMessageHandlerBase {
         }
     }
 
+    /**
+     * @deprecated in Cardinal Release
+     */
     @Deprecated
     private final class TopoHeartbeat extends RequestHandler {
         private TopoHeartbeat() {
@@ -225,6 +231,9 @@ public class TopologyViewMessageHandler extends TopologyViewMessageHandlerBase {
         }
     }
 
+    /**
+     * @deprecated in Cardinal Release
+     */
     @Deprecated
     private final class TopoStop extends RequestHandler {
         private TopoStop() {
@@ -238,6 +247,9 @@ public class TopologyViewMessageHandler extends TopologyViewMessageHandlerBase {
         }
     }
 
+    /**
+     * @deprecated in Cardinal Release
+     */
     @Deprecated
     private final class ReqSummary extends RequestHandler {
         private ReqSummary() {

@@ -109,6 +109,8 @@ import static org.onosproject.ui.impl.TopologyViewMessageHandlerBase.StatsType.P
 
 /**
  * Facility for creating messages bound for the topology viewer.
+ *
+ * @deprecated in Cardinal Release
  */
 @Deprecated
 public abstract class TopologyViewMessageHandlerBase extends UiMessageHandler {