Decide on a unified Javadoc style

[tgregg]

See this comment on #355: #355 (comment)

The dilemma concerns parameter descriptions formatted like the following:

     * @param initialBufferSize the initial size of the buffer. When full, the buffer will grow by this
     *                          many bytes. 

versus the following

     * @param initialBufferSize the initial size of the buffer. When full, the buffer will grow by
     *     this many bytes.