> The `java.util.Formatter` format specifies support for field widths, argument > indexes, or precision lengths of a field > that relate to the variadic arguments supplied to the formatter. These > numbers are specified by integers, sometimes > negative. For argument index, it's specified in the documentation that the > highest allowed argument is limited by the > largest possible index of an array (ie the largest possible variadic index), > but for the other two it's not defined. > Moreover, what happens when a number field in a string is too large or too > small to be represented by a 32-bit integer > type is not defined. This fix adds documentation to specify what error > behavior occurs during these cases. > Additionally it adds an additional exception type to throw when an invalid > argument index is observed. A CSR will be > required for this PR.
Ian Graves has updated the pull request incrementally with one additional commit since the last revision: Tweaking verbiage ------------- Changes: - all: https://git.openjdk.java.net/jdk/pull/516/files - new: https://git.openjdk.java.net/jdk/pull/516/files/391449a8..9b07ef33 Webrevs: - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=516&range=03 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=516&range=02-03 Stats: 18 lines in 2 files changed: 0 ins; 5 del; 13 mod Patch: https://git.openjdk.java.net/jdk/pull/516.diff Fetch: git fetch https://git.openjdk.java.net/jdk pull/516/head:pull/516 PR: https://git.openjdk.java.net/jdk/pull/516