Merge pull request #1537 from smartdevicelink/bugfix/issue_1536

Add missing `Use @link` annotations to some deprecated APIs

Author: JulianKast

base/src/main/java/com/smartdevicelink/proxy/rpc/OnSystemRequest.java

@@ -311,7 +311,7 @@ public OnSystemRequest setFileType(FileType fileType) {
 
     /**
      * @param offset of the data attached
-     * @deprecated as of SmartDeviceLink 4.0
+     * @deprecated as of SmartDeviceLink 4.0. Use {@link #setOffset(Long)} instead.
      */
     public OnSystemRequest setOffset(Integer offset) {
         if (offset == null) {
@@ -377,7 +377,7 @@ public Long getLength() {
 
     /**
      * @param length of the data attached
-     * @deprecated as of SmartDeviceLink 4.0
+     * @deprecated as of SmartDeviceLink 4.0. Use {@link #setLength(Long)} instead.
      */
     public OnSystemRequest setLength(Integer length) {
         if (length == null) {

base/src/main/java/com/smartdevicelink/proxy/rpc/PutFile.java

@@ -268,7 +268,7 @@ public byte[] getFileData() {
 
     /**
      * @param offset Optional offset in bytes for resuming partial data chunks
-     * @deprecated as of SmartDeviceLink 4.0
+     * @deprecated as of SmartDeviceLink 4.0. Use {@link #setOffset(Long)} instead.
      */
     public PutFile setOffset(Integer offset) {
         if (offset == null) {
@@ -305,7 +305,7 @@ public Long getOffset() {
     /**
      * @param length Optional length in bytes for resuming partial data chunks. If offset is set to 0, then length is
      *               the total length of the file to be downloaded
-     * @deprecated as of SmartDeviceLink 4.0
+     * @deprecated as of SmartDeviceLink 4.0. Use {@link #setLength(Long)} instead.
      */
     public PutFile setLength(Integer length) {
         if (length == null) {

base/src/main/java/com/smartdevicelink/proxy/rpc/TouchEvent.java

@@ -132,7 +132,7 @@ public Integer getId() {
      * Use getTimestamps
      *
      * @return
-     * @deprecated 4.0.2
+     * @deprecated in 4.0.2. Use {@link #getTimestamps()}()} instead.
      */
     @Deprecated
     public List<Long> getTs() {
@@ -170,7 +170,7 @@ public TouchEvent setTimestamps(@NonNull List<Long> ts) {
      * Use setTimestamps.
      *
      * @param ts
-     * @deprecated 4.0.2
+     * @deprecated in 4.0.2. Use {@link #setTimestamps(List)} instead.
      */
     @Deprecated
     public TouchEvent setTs(List<Long> ts) {
@@ -182,7 +182,7 @@ public TouchEvent setTs(List<Long> ts) {
      * Use getTouchCoordinates
      *
      * @return
-     * @deprecated 4.0.2
+     * @deprecated in 4.0.2. Use {@link #getTouchCoordinates()} instead.
      */
     @Deprecated
     public List<TouchCoord> getC() {
@@ -198,7 +198,7 @@ public List<TouchCoord> getTouchCoordinates() {
      * Use setTouchCoordinates
      *
      * @return
-     * @deprecated 4.0.2
+     * @deprecated in 4.0.2. Use {@link #setTouchCoordinates(List)} instead.
      */
     @Deprecated
     public TouchEvent setC(List<TouchCoord> c) {