SPEC: description of events and methods switching state is incomplete

Name: dkR10031 Date: 12/10/2002



The J2SE 1.4 API specification proposes the following events for detecting
a dataline state switching: OPEN, CLOSE, START, STOP. Also
specification proposes the following methods for the dataline state
switching: open(), close(),start(), stop(). As well, dataline state
can be switched if write() or read() methods has been called.

However, the description is incomplete since the specification does not
specify which methods are synchronous and which are not synchronous and
this ambiguity makes difficult to interpret received events and results of
the dataline state checking methods( isActive(), isRunning(), isOpen()).
If this depends on an implementation then all such cases should be
described in specification.

======================================================================