Add javadoc to Subsegment.close() method.

This method should not be used to end subsegments for segments using multiple threads as this can result in a deadlock. See #318 for details.

Author: Kurru

aws-xray-recorder-sdk-core/src/main/java/com/amazonaws/xray/entities/Subsegment.java

@@ -87,7 +87,7 @@ static Subsegment noOp(Segment parent, AWSXRayRecorder recorder) {
     /**
      * Serializes the subsegment as a standalone String with enough information for the subsegment to be streamed on its own.
      * @return
-     *  the string representation of the subsegment with enouogh information for it to be streamed
+     *  the string representation of the subsegment with enough information for it to be streamed
      */
     String streamSerialize();
 
@@ -96,10 +96,16 @@ static Subsegment noOp(Segment parent, AWSXRayRecorder recorder) {
      * own. Only used for debugging.
      *
      * @return
-     *  the pretty string representation of the subsegment with enouogh information for it to be streamed
+     *  the pretty string representation of the subsegment with enough information for it to be streamed
      */
     String prettyStreamSerialize();
 
+    /**
+     * Implements the {@link AutoCloseable} interface.
+     *
+     * <p>Warning. Avoid using this to end subsegments in asynchronous methods or other threads as this can cause
+     * deadlocks. Instead, use {@link com.amazonaws.xray.AWSXRay#endSubsegment(Subsegment)}.
+     */
     @Override
     void close();
 }