Improve java.util.Locale documentation.

The key change here is adding "honeycomb" to the table. The other
changes are just targets of opportunity.

I've also raised doclava bugs, because this page still looks awful
after doclava's mangled it. (javadoc does a better job.)

Change-Id: I5a8a9e7b2df8ec792f4d191729f8d30b8306cd6e