Name: rlT66838 Date: 08/13/97


The java doc for java.text.Format#format(Object, StringBuffer, FieldPosition)
is incorrect.

It describes a status parameter

status - On input: an alignment field, if desired. On output: the offsets of the alignment field.

There is no status parameter, but there is an undocumented fieldPosition parameter.
The description of the non-existant status parameter
cannot be relevant to the fieldPosition parameter
since it implies that fieldPosition is altered by the
method but FieldPosition has no public "set" methods
so that any user derived class outside of the java.text
package will not be able to use the fieldPosition parameter.

The error is repeated in all derived classes such
as NumberFormat, DateFormat etc.


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