Javadoc cleanup for java.xml and org/xml packages

There are lots of other cleanup of the javadoc, using @code around true, false,
missing periods at the end of first sentences, etc.

The javax.xml.stream changes have really odd formatting, some of the sources are a mix of 2 and 4-space indentation. Also they have an really odd "@author Copyright (c) 2009 Oracle Corporation".