src/java.base/share/classes/java/text/NumberFormat.java

*** 1,7 ****
  /*
!  * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 172,181 ****
--- 172,188 ----
   * Number formats are generally not synchronized.
   * It is recommended to create separate format instances for each thread.
   * If multiple threads access a format concurrently, it must be synchronized
   * externally.
   *
+  * @implSpec The {@link #format(double, StringBuffer, FieldPosition)},
+  * {@link #format(long, StringBuffer, FieldPosition)} and
+  * {@link #parse(String, ParsePosition)} methods may throw
+  * {@code NullPointerException}, if any of their parameter is {@code null}.
+  * The subclass may provide its own implementation and specification about
+  * {@code NullPointerException}.
+  *
   * @see          DecimalFormat
   * @see          ChoiceFormat
   * @author       Mark Davis
   * @author       Helena Shih
   */