src/java.base/share/classes/java/lang/reflect/Modifier.java

*** 129,10 ***
--- 129,13 ---
  
      /**
       * Return {@code true} if the integer argument includes the
       * {@code synchronized} modifier, {@code false} otherwise.
       *
+      * @apiNote {@code isSynchronized} should only be called with the modifiers
+      * of a {@linkplain Method#getModifiers() method}.
+      *
       * @param   mod a set of modifiers
       * @return {@code true} if {@code mod} includes the
       * {@code synchronized} modifier; {@code false} otherwise.
       */
      public static boolean isSynchronized(int mod) {

*** 213,11 ***
  
      /**
       * Return a string describing the access modifier flags in
       * the specified modifier. For example:
       * <blockquote><pre>
!      *    public final synchronized strictfp
       * </pre></blockquote>
       * The modifier names are returned in an order consistent with the
       * suggested modifier orderings given in sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1 of
       * <cite>The Java Language Specification</cite>.
       * The full modifier ordering used by this method is:
--- 216,11 ---
  
      /**
       * Return a string describing the access modifier flags in
       * the specified modifier. For example:
       * <blockquote><pre>
!      *    public final synchronized
       * </pre></blockquote>
       * The modifier names are returned in an order consistent with the
       * suggested modifier orderings given in sections 8.1.1, 8.3.1, 8.4.3, 8.8.3, and 9.1.1 of
       * <cite>The Java Language Specification</cite>.
       * The full modifier ordering used by this method is: