Constructors:

1. For null input parameters must throw NullPointerException unless
    otherwise documented. The parameters text, caret, and visiblePosition
    do not throw exceptions. The parameter source throws an IllegalArgumentException
    for a null input parameter.
    
2. Must define exception thrown for out of range id parameter and under what conditions the
    exception is thrown. Same for committedCharacterCount.

3. Suggestion: for the "source" parameter description, say "component" instead
    of "object", since the parameter is of type Component.

Methods:

getText(): define when null is returned, so we can enforce compatibility in this case,
           versus returning "empty" text

getText(): typo, add "()" to first getCommittedCharacterCount.
           
paramString(): must be fully specified. See JLS book page 594 for an example using
               Thread.toString. I have filed a bug against the lack of specification
               in AWTEvent.paramString() and AWTEvent.toString().
               

Introduction in paragraph #1:
"Whenever the text changes, the input method sends an event
to the text editing component that uses it." This is not correct for the root
window editing. This sentence should be reworked or otherwise deleted.


Paragraph #2:
"Committed text always precedes composed text." Would be more clear to say:
"A committed text part always precedes a composed text part."