HADOOP-18889. javadocs and line endings

...i understand now. @see must come last in the javadocs

Change-Id: If7464a7d13bbd29fd5a000b2068a2aa536df2d66

Author: steveloughran

hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/S3ARetryPolicy.java

@@ -54,7 +54,7 @@
 
 /**
  * The S3A request retry policy.
- *
+ * <p>
  * This uses the retry options in the configuration file to determine retry
  * count and delays for "normal" retries and separately, for throttling;
  * the latter is best handled for longer with an exponential back-off.
@@ -69,7 +69,7 @@
  * For non-idempotent operations, only failures due to throttling or
  * from failures which are known to only arise prior to talking to S3
  * are retried.
- *
+ * <p>
  * The retry policy is all built around that of the normal IO exceptions,
  * particularly those extracted from
  * {@link S3AUtils#translateException(String, Path, SdkException)}.
@@ -79,13 +79,13 @@
  * <p>
  * Put differently: this retry policy aims to work for handlers of the
  * untranslated exceptions, as well as the translated ones.
- * @see <a href="http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html">S3 Error responses</a>
- * @see <a href="http://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html"> Amazon S3 Error Best Practices </a>
  * <p>
  * Note that because delete is considered idempotent, all s3a operations currently
  * declare themselves idempotent.
  * This means the retry policy here is more complex than it needs to be -but it
  * does force us to consider when retrying operations would not be safe.
+ * @see <a href="http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html">S3 Error responses</a>
+ * @see <a href="http://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html"> Amazon S3 Error Best Practices</a>
  */
 @SuppressWarnings("visibilitymodifier")  // we want a struct of finals, for real.
 public class S3ARetryPolicy implements RetryPolicy {

hadoop-tools/hadoop-aws/src/site/markdown/tools/hadoop-aws/troubleshooting_s3a.md

@@ -915,7 +915,6 @@ org.apache.hadoop.fs.s3a.AWSS3IOException: innerMkdirs on /test:
    Request ID: CA89F276B3394565),
    S3 Extended Request ID: ncz0LWn8zor1cUO2fQ7gc5eyqOk3YfyQLDn2OQNoe5Zj/GqDLggUYz9QY7JhdZHdBaDTh+TL5ZQ=:
    Invalid arn (Service: Amazon S3; Status Code: 400; Error Code: KMS.NotFoundException; Request ID: CA89F276B3394565)
- 
 ```
 
 Possible causes:
@@ -1055,7 +1054,6 @@ able to generate unique data key for encryption.
 Caused by: software.amazon.awssdk.services.kms.mode.InvalidKeyUsageException:
 You cannot generate a data key with an asymmetric CMK
 (Service: AWSKMS; Status Code: 400; Error Code: InvalidKeyUsageException; Request ID: 93609c15-e490-4035-8390-f4396f0d90bf; Proxy: null)
-  
 ```
 
 Generate a Symmetric Key in the same region as your S3 storage for CSE-KMS to
@@ -1141,7 +1139,6 @@ org.apache.hadoop.fs.s3a.UnknownStoreException: `s3a://random-bucket-7d9217b0-b4
     (Service: S3, Status Code: 404, Request ID: RD254TC8EVDV98AK): null
     (Service: S3, Status Code: 404, Request ID: RD254TC8EVDV98AK, Extended Request ID: 49F5CO1IKavFsz+VBecf2uwZeNVar3InHkdIrONvAK5yQ73gqZ1hFoAEMo8/x5wRNe3OXO3aebvZkev2bS81kw==)
     (Service: S3, Status Code: 404, Request ID: RD254TC8EVDV98AK)
-
 ```
 
 Check the URI is correct, and that the bucket actually exists.
@@ -1368,15 +1365,12 @@ connections more frequently.
    The unspecified location constraint is incompatible for the region specific
     endpoint this request was sent to.
     (Service: Amazon S3; Status Code: 400; Error Code: IllegalLocationConstraintException;
-
-
   ...
   Cause: S3Exception:
    The unspecified location constraint is incompatible for the region specific endpoint
    this request was sent to. (Service: Amazon S3; Status Code: 400; Error Code: IllegalLocationConstraintException;
    Request ID: EEBC5A08BCB3A645)
 
-  ...
 ```
 
 Something has been trying to write data to "/".