Create a @noinline annotation: currently a noop

Followup changes will modify inlining passes to honor this annotation.

Related to #2751

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=179756574

Author: brad4d

Diff for: src/com/google/javascript/jscomp/parsing/Annotation.java

@@ -63,6 +63,7 @@ enum Annotation {
   NO_ALIAS,
   NO_COLLAPSE,
   NO_COMPILE,
+  NO_INLINE,
   NO_SIDE_EFFECTS,
   NOT_IMPLEMENTED,
   OVERRIDE,
@@ -133,6 +134,7 @@ enum Annotation {
           .put("noalias", Annotation.NO_ALIAS)
           .put("nocollapse", Annotation.NO_COLLAPSE)
           .put("nocompile", Annotation.NO_COMPILE)
+          .put("noinline", Annotation.NO_INLINE)
           .put("nosideeffects", Annotation.NO_SIDE_EFFECTS)
           .put("override", Annotation.OVERRIDE)
           .put("owner", Annotation.AUTHOR)

Diff for: src/com/google/javascript/jscomp/parsing/JsDocInfoParser.java

@@ -720,6 +720,12 @@ private JsDocToken parseAnnotation(JsDocToken token,
           }
           return eatUntilEOLIfNotAnnotation();
 
+        case NO_INLINE:
+          if (!jsdocBuilder.recordNoInline()) {
+            addParserWarning("msg.jsdoc.noinline");
+          }
+          return eatUntilEOLIfNotAnnotation();
+
         case NOT_IMPLEMENTED:
           return eatUntilEOLIfNotAnnotation();
 

Diff for: src/com/google/javascript/jscomp/resources.json

@@ -503,8 +503,7 @@ private static boolean areEquivalent(Marker m1, Marker m2) {
   private static final int MASK_DEPRECATED    = 0x00000100; // @deprecated
   private static final int MASK_INTERFACE     = 0x00000200; // @interface
   private static final int MASK_EXPORT        = 0x00000400; // @export
-  @SuppressWarnings("unused")
-  private static final int MASK_UNUSED_2      = 0x00000800; //
+  private static final int MASK_NOINLINE      = 0x00000800; // @noinline
   private static final int MASK_FILEOVERVIEW  = 0x00001000; // @fileoverview
   private static final int MASK_IMPLICITCAST  = 0x00002000; // @implicitCast
   private static final int MASK_NOSIDEEFFECTS = 0x00004000; // @nosideeffects
@@ -732,6 +731,10 @@ void setNoCollapse(boolean value) {
     setFlag(value, MASK_NOCOLLAPSE);
   }
 
+  void setNoInline(boolean value) {
+    setFlag(value, MASK_NOINLINE);
+  }
+
   private void setFlag(boolean value, int mask) {
     if (value) {
       bitset |= mask;
@@ -957,13 +960,21 @@ public boolean isNoCompile() {
   }
 
   /**
-   * Returns whether the {@code @nocompile} annotation is present on this
+   * Returns whether the {@code @nocollapse} annotation is present on this
    * {@link JSDocInfo}.
    */
   public boolean isNoCollapse() {
     return getFlag(MASK_NOCOLLAPSE);
   }
 
+  /**
+   * Returns whether the {@code @noinline} annotation is present on this
+   * {@link JSDocInfo}.
+   */
+  public boolean isNoInline() {
+    return getFlag(MASK_NOINLINE);
+  }
+
   /**
    * @return Whether there is a declaration present on this {@link JSDocInfo}.
    */

Diff for: src/com/google/javascript/rhino/JSDocInfo.java

@@ -887,6 +887,23 @@ public boolean recordNoCollapse() {
     }
   }
 
+  /**
+   * Records that the {@link JSDocInfo} being built should have its
+   * {@link JSDocInfo#isNoInline()} flag set to {@code true}.
+   *
+   * @return {@code true} if the no inline flag was recorded and {@code false}
+   *     if it was already recorded
+   */
+  public boolean recordNoInline() {
+    if (!currentInfo.isNoInline()) {
+      currentInfo.setNoInline(true);
+      populated = true;
+      return true;
+    } else {
+      return false;
+    }
+  }
+
   /**
    * Records that the {@link JSDocInfo} being built should have its
    * {@link JSDocInfo#isConstructor()} flag set to {@code true}.

Diff for: src/com/google/javascript/rhino/JSDocInfoBuilder.java

@@ -247,6 +247,9 @@ msg.jsdoc.nocompile =\
 msg.jsdoc.nocollapse =\
     extra @nocollapse tag
 
+msg.jsdoc.noinline =\
+    extra @noinline tag
+
 msg.jsdoc.seemissing =\
     @see tag missing description