I spent 7 hours to debug why doubles in Java classes brick my class file parser only to discover the following small print in the specification after I read the corresponding OpenJDK source code: In retrospect, making 8-byte constants take two constant pool entries was a poor choice. Yeah no shit. I chose to write a custom user stylesheet for Oracle specifications to enlarge notes since they're obviously critical to the implementation of JVMs. I guess the technical writers at Oracle didn't want to offend the developers who wrote the JVM originally at the expense of developers who write JVMs today.