/*
 * Copyright (C) 2009 The Guava Authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.common.annotations;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * The presence of this annotation on a method indicates that the method may
 * <em>not</em> be used with the
 * <a href="http://code.google.com/webtoolkit/">Google Web Toolkit</a> (GWT),
 * even though its type is annotated as {@link GwtCompatible} and accessible in
 * GWT.  They can cause GWT compilation errors or simply unexpected exceptions
 * when used in GWT.
 *
 * <p>Note that this annotation should only be applied to methods, fields, or
 * inner classes of types which are annotated as {@link GwtCompatible}.
 *
 * @author Charles Fry
 */
@Retention(RetentionPolicy.CLASS)
@Target({
    ElementType.TYPE, ElementType.METHOD,
    ElementType.CONSTRUCTOR, ElementType.FIELD })
@Documented
@GwtCompatible
public @interface GwtIncompatible {
  /**
   * Describes why the annotated element is incompatible with GWT. Since this is
   * generally due to a dependence on a type/method which GWT doesn't support,
   * it is sufficient to simply reference the unsupported type/method. E.g.
   * "Class.isInstance".
   */
  String value();
}

@@ -105,19 +105,16 @@
 cense%22);
-%0A *
  you may
@@ -138,16 +138,19 @@
 e except
+%0A *
  in comp
@@ -173,19 +173,16 @@
 License.
-%0A *
  You may
@@ -336,19 +336,16 @@
 software
-%0A *
  distrib
@@ -366,16 +366,19 @@
  License
+%0A *
  is dist
@@ -405,19 +405,16 @@
 %22 BASIS,
-%0A *
  WITHOUT
@@ -466,16 +466,19 @@
  express
+%0A *
  or impl
@@ -481,19 +481,16 @@
 implied.
-%0A *
  See the
@@ -549,19 +549,16 @@
 ions and
-%0A *
  limitat
@@ -563,24 +563,27 @@
 ations under
+%0A *
  the License
@@ -874,23 +874,21 @@
 ion on a
- method
+n API
  indicat
@@ -909,19 +909,16 @@
 thod may
-%0A *
  %3Cem%3Enot
@@ -939,15 +939,15 @@
 with
+%0A *
  the
-%0A *
  %3Ca 
@@ -963,34 +963,26 @@
 p://
-code.google.com/webtoolkit
+www.gwtproject.org
 /%22%3EG
@@ -1012,341 +1012,218 @@
 GWT)
-,%0A * even though its type is annotated as %7B@link GwtCompatible%7D and accessible in%0A * GWT.  They can cause GWT compilation errors or simply unexpected exceptions%0A * when used in GWT.%0A *%0A * %3Cp%3ENote that this annotation should only be applied to methods, fields, or%0A * inner classes of types which are annotated as %7B@l
+.%0A *%0A * %3Cp%3EThis annotation behaves identically to %3Ca%0A * href=%22http://www.gwtproject.org/javadoc/latest/com/google/gwt/core/shared/GwtIncompatible.html%22%3Ethe%0A * %7B@code @GwtCompatible%7D annotation 
 in
-k
  G
-wtCompatible%7D
+WT itself%3C/a%3E
 .%0A *
@@ -1293,21 +1293,16 @@
 Target(%7B
-%0A    
 ElementT
@@ -1330,20 +1330,16 @@
 .METHOD,
-%0A   
  Element
@@ -1373,17 +1373,16 @@
 pe.FIELD
- 
 %7D)%0A@Docu
@@ -1525,21 +1525,16 @@
  this is
-%0A   *
  general
@@ -1544,16 +1544,21 @@
 due to a
+%0A   *
  depende
@@ -1604,21 +1604,16 @@
 support,
-%0A   *
  it is s
@@ -1645,16 +1645,21 @@
 ence the
+%0A   *
  unsuppo
@@ -1680,21 +1680,16 @@
 od. E.g.
-%0A   *
  %22Class.
@@ -1699,16 +1699,201 @@
 nstance%22
+.%0A   *%0A   * %3Cp%3EAs of Guava 20.0, this value is optional. We encourage authors who wish to describe why%0A   * an API is %7B@code @GwtIncompatible%7D to instead leave an implementation comment
 .%0A   */%0A
@@ -1908,12 +1908,23 @@
  value()
+ default %22%22
 ;%0A%7D%0A

Make @GwtIncompatible.reason optional. While there, redocument and reformat the file. ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=110482560