Formatting for Spec Doc.

Author: gregrluck

Diff for: src/main/java/javax/cache/annotation/CachePut.java

@@ -117,7 +117,8 @@
   /**
    * Defines zero (0) or more exception {@link Class classes}, that must be a
    * subclass of {@link Throwable}, indicating the exception types that <b>must</b>
-   * cause the parameter to be cached. Only used if {@link #afterInvocation()} is true.
+   * cause the parameter to be cached. Only used if {@link #afterInvocation()} is
+   * true.
    */
   @Nonbinding Class<? extends Throwable>[] cacheFor() default {};
 

Diff for: src/main/java/javax/cache/annotation/CacheRemove.java

@@ -19,9 +19,8 @@
 
 /**
  * When a method annotated with {@link CacheRemove} is invoked a {@link
- * GeneratedCacheKey} will be generated and
- * {@link Cache#remove(Object)} will be invoked on the specified
- * cache.
+ * GeneratedCacheKey} will be generated and {@link Cache#remove(Object)} will be
+ * invoked on the specified cache.
  * <p>
  * The default behavior is to call {@link Cache#remove(Object)} after
  * the annotated method is invoked, this behavior can be changed by setting
@@ -50,12 +49,10 @@
  * exceptions prevent the remove</li>
  * <li>If {@link #evictFor()} is specified and {@link #noEvictFor()} is not
  * specified then only exceptions that pass an instanceof check against the
- * evictFor list result in a
- * remove</li>
+ * evictFor list result in a remove</li>
  * <li>If {@link #noEvictFor()} is specified and {@link #evictFor()} is not
  * specified then all exceptions that do not pass an instanceof check against the
- * noEvictFor result in a
- * remove</li>
+ * noEvictFor result in a remove</li>
  * <li>If {@link #evictFor()} and {@link #noEvictFor()} are both specified then
  * exceptions that pass an instanceof check against the evictFor list but do not
  * pass an instanceof check against the noEvictFor list result in a remove</li>

Diff for: src/main/java/javax/cache/annotation/CacheRemoveAll.java

@@ -105,7 +105,8 @@
   /**
    * Defines zero (0) or more exception {@link Class Classes}, that must be a
    * subclass of {@link Throwable}, indicating the exception types that must
-   * <b>not</b> cause a cache eviction. Only used if {@link #afterInvocation()} is true.
+   * <b>not</b> cause a cache eviction. Only used if {@link #afterInvocation()} is
+   * true.
    */
   @Nonbinding Class<? extends Throwable>[] noEvictFor() default {};
 }

Diff for: src/main/java/javax/cache/annotation/CacheResult.java

@@ -18,12 +18,11 @@
 
 /**
  * When a method annotated with {@link CacheResult} is invoked a
- * {@link GeneratedCacheKey} will be generated and
- * {@link Cache#get(Object)} is called before the annotated method
- * actually executes. If a value is found in the cache it is returned and the
- * annotated method is never actually executed. If no value is found the
- * annotated method is invoked and the returned value is stored in the cache
- * with the generated key.
+ * {@link GeneratedCacheKey} will be generated and {@link Cache#get(Object)} is
+ * called before the annotated method actually executes. If a value is found in the
+ * cache it is returned and the annotated method is never actually executed. If no
+ * value is found the annotated method is invoked and the returned value is stored
+ * in the cache with the generated key.
  * <p>
  * Exceptions are not cached by default. Caching of exceptions can be enabled by
  * specifying an {@link #exceptionCacheName()}. If an exception cache is specified