Name: gm110360 Date: 04/18/2002


FULL PRODUCT VERSION :
Java 2 Enterprise Edition version 1.3.1, build 1.3.1-b17

A DESCRIPTION OF THE PROBLEM :
The Javadoc documentation for javax.activation.DataSource
as provided online at
http://java.sun.com/products/javabeans/glasgow/javadocs/java
x/activation/DataSource.html and in the JavaBeans
Activation Framework 1.0.1 distribution (jaf1_0_1.zip)
needs regenerating to include the extra details found in
the J2EE 1.3 Javadocs (see
http://java.sun.com/j2ee/sdk_1.3/techdocs/api/javax/activati
on/DataSource.html).

The J2EE 1.3 Javadocs contain the following statements in
the documentation of getInputStream() and getOutputStream()
respectively:

---
Note that a new InputStream object must be returned each
time this method is called, and the stream must be
positioned at the beginning of the data.

Note that a new OutputStream object must be returned each
time this method is called, and the stream must be
positioned at the location the data is to be written.
---

These statements are missing from the Javadoc API
documentation that is supplied with the JavaBeans
Activation Framework distribution.


This bug can be reproduced always.
(Review ID: 144734)
======================================================================