diff --git a/annotations/src/main/java/com/google/errorprone/annotations/RestrictedApi.java b/annotations/src/main/java/com/google/errorprone/annotations/RestrictedApi.java
index 1df27f7d3cf..547f50a84a1 100644
--- a/annotations/src/main/java/com/google/errorprone/annotations/RestrictedApi.java
+++ b/annotations/src/main/java/com/google/errorprone/annotations/RestrictedApi.java
@@ -38,15 +38,15 @@
  * example through code review, could be marked {@code @ReviewedFooBar}.
  *
  * <pre>{@code
- * public {@literal @}interface LegacyUnsafeFooBar{}
+ * public @interface LegacyUnsafeFooBar{}
  *
- * public {@literal @}interface ReviewedFooBar{
+ * public @interface ReviewedFooBar{
  *  public string reviewer();
  *  public string comments();
  * }
  *
  * public class Foo {
- *   {@literal @}RestrictedApi(
+ *   @RestrictedApi(
  *      explanation="You could shoot yourself in the foot with Foo.bar if you aren't careful",
  *      link="http://edsger.dijkstra/foo_bar_consider_harmful.html",
  *      allowedOnPath="testsuite/.*", // Unsafe behavior in tests is ok.
@@ -61,7 +61,7 @@
  *   }
  *   boolean complicatedCondition = true;
  *
- *   {@literal @}ReviewedFooBar(
+ *   @ReviewedFooBar(
  *      reviewer="bangert",
  *      comments="Makes sure complicatedCondition isn't true, so bar is safe!"
  *   )
@@ -71,7 +71,7 @@
  *      }
  *   }
  *
- *   {@literal @}LegacyUnsafeFooBar
+ *   @LegacyUnsafeFooBar
  *   public void someOldCode() {
  *      // ...
  *      bar()