Javadoc does not remove the initial asterisks or interpret
the javadoc tags, but otherwise works properly. Here is an
example of the source and output using 1.4.2 on the attached file.

From Date.java

/**
* Constructs a new <code>Date</code> initialized
* to the date specified by the parameters.
* <p>
* Precondition: the specified date is valid.
*
* @param m the month of the desired date
* @param d the date of the desired date
* @param y the year of the desired date
* @throws InvalidDateException if the parameters specify an invalid date
* @see Date#setDate(int m,int d,int y)
*/
*/
public Date(int m, int d, int y)
{
setDate(m, d, y);
}

From Date.html

<DL>
<DD>Constructs a new <code>Date</code> initialized
  * to the date specified by the parameters.
* <p>
* Precondition: the specified date is valid.
*
* @param m the month of the desired date
* @param d the date of the desired date
* @param y the year of the desired date
* @throws InvalidDateException if the parameters specify an invalid date
* @see Date#setDate(int m,int d,int y)
<P>
</DL>