refactor: fix lint check (#863)

Fixing the lint problem in this repository by running `mvn com.coveo:fmt-maven-plugin:format`.

Author: suztomo

google-oauth-client-servlet/src/main/java/com/google/api/client/extensions/servlet/auth/AbstractCallbackServlet.java

@@ -99,13 +99,19 @@ protected final HttpTransport getHttpTransport() {
    */
   protected abstract PersistenceManagerFactory getPersistenceManagerFactory();
 
-  /** @return Specific ThreeLeggedFlow type that this callback should retreieve and complete. */
+  /**
+   * @return Specific ThreeLeggedFlow type that this callback should retreieve and complete.
+   */
   protected abstract Class<? extends ThreeLeggedFlow> getConcreteFlowType();
 
-  /** @return Url to redirect the user to upon a successful credential exchange. */
+  /**
+   * @return Url to redirect the user to upon a successful credential exchange.
+   */
   protected abstract String getSuccessRedirectUrl();
 
-  /** @return Url to redirect the user to upon failure. */
+  /**
+   * @return Url to redirect the user to upon failure.
+   */
   protected abstract String getDeniedRedirectUrl();
 
   /**

google-oauth-client/src/main/java/com/google/api/client/auth/oauth/AbstractOAuthGetToken.java

@@ -50,7 +50,9 @@ public abstract class AbstractOAuthGetToken extends GenericUrl {
   /** {@code true} for POST request or the default {@code false} for GET request. */
   protected boolean usePost;
 
-  /** @param authorizationServerUrl encoded authorization server URL */
+  /**
+   * @param authorizationServerUrl encoded authorization server URL
+   */
   protected AbstractOAuthGetToken(String authorizationServerUrl) {
     super(authorizationServerUrl);
   }

google-oauth-client/src/main/java/com/google/api/client/auth/oauth/OAuthAuthorizeTemporaryTokenUrl.java

@@ -43,7 +43,9 @@ public class OAuthAuthorizeTemporaryTokenUrl extends GenericUrl {
   @Key("oauth_token")
   public String temporaryToken;
 
-  /** @param encodedUserAuthorizationUrl encoded user authorization URL */
+  /**
+   * @param encodedUserAuthorizationUrl encoded user authorization URL
+   */
   public OAuthAuthorizeTemporaryTokenUrl(String encodedUserAuthorizationUrl) {
     super(encodedUserAuthorizationUrl);
   }

google-oauth-client/src/main/java/com/google/api/client/auth/oauth/OAuthGetAccessToken.java

@@ -43,7 +43,9 @@ public class OAuthGetAccessToken extends AbstractOAuthGetToken {
    */
   public String verifier;
 
-  /** @param authorizationServerUrl encoded authorization server URL */
+  /**
+   * @param authorizationServerUrl encoded authorization server URL
+   */
   public OAuthGetAccessToken(String authorizationServerUrl) {
     super(authorizationServerUrl);
   }

google-oauth-client/src/main/java/com/google/api/client/auth/oauth/OAuthGetTemporaryToken.java

@@ -38,7 +38,9 @@ public class OAuthGetTemporaryToken extends AbstractOAuthGetToken {
    */
   public String callback;
 
-  /** @param authorizationServerUrl encoded authorization server URL */
+  /**
+   * @param authorizationServerUrl encoded authorization server URL
+   */
   public OAuthGetTemporaryToken(String authorizationServerUrl) {
     super(authorizationServerUrl);
   }

google-oauth-client/src/main/java/com/google/api/client/auth/oauth2/AuthorizationCodeResponseUrl.java

@@ -83,7 +83,9 @@ public class AuthorizationCodeResponseUrl extends GenericUrl {
   @Key("error_uri")
   private String errorUri;
 
-  /** @param encodedResponseUrl encoded authorization code response URL */
+  /**
+   * @param encodedResponseUrl encoded authorization code response URL
+   */
   public AuthorizationCodeResponseUrl(String encodedResponseUrl) {
     super(encodedResponseUrl);
     // either error or code but not both

google-oauth-client/src/main/java/com/google/api/client/auth/oauth2/StoredCredential.java

@@ -55,7 +55,9 @@ public final class StoredCredential implements Serializable {
 
   public StoredCredential() {}
 
-  /** @param credential existing credential to copy from */
+  /**
+   * @param credential existing credential to copy from
+   */
   public StoredCredential(Credential credential) {
     setAccessToken(credential.getAccessToken());
     setRefreshToken(credential.getRefreshToken());

google-oauth-client/src/main/java/com/google/api/client/auth/openidconnect/IdTokenVerifier.java

@@ -74,7 +74,9 @@ public IdTokenVerifier() {
     this(new Builder());
   }
 
-  /** @param builder builder */
+  /**
+   * @param builder builder
+   */
   protected IdTokenVerifier(Builder builder) {
     clock = builder.clock;
     acceptableTimeSkewSeconds = builder.acceptableTimeSkewSeconds;

samples/dailymotion-cmdline-sample/src/main/java/com/google/api/services/samples/dailymotion/cmdline/DailyMotionUrl.java

@@ -30,12 +30,16 @@ public DailyMotionUrl(String encodedUrl) {
     super(encodedUrl);
   }
 
-  /** @return the fields */
+  /**
+   * @return the fields
+   */
   public String getFields() {
     return fields;
   }
 
-  /** @param fields the fields to set */
+  /**
+   * @param fields the fields to set
+   */
   public void setFields(String fields) {
     this.fields = fields;
   }

samples/dailymotion-cmdline-sample/src/main/java/com/google/api/services/samples/dailymotion/cmdline/Video.java

@@ -17,7 +17,9 @@
 import com.google.api.client.util.Key;
 import java.util.List;
 
-/** @author Yaniv Inbar */
+/**
+ * @author Yaniv Inbar
+ */
 public class Video {
 
   @Key public String id;