Because that's not recognized by the javadoc compiler.
http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#principles
Specifically:
- The first line contains the begin-comment delimiter ( /**).
- The last line contains the end-comment delimiter ( */) Note that unlike the begin-comment delimiter, the end-comment contains only a single asterisk.
This is why the second bit is turned into Javadoc.
Edit from comments: You can't have two blocks at the top of the class; only one is going to get used. Also, the spec states that comments before imports are ignored.
http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/javadoc.html#documentationcomments
Placement of comments - Documentation comments are recognized only when placed immediately before class, interface, constructor, method, or field declarations -- see the class example, method example, and field example. Documentation comments placed in the body of a method are ignored. Only one documentation comment per declaration statement is recognized by the Javadoc tool.
A common mistake is to put an import statement between the class comment and the class declaration. Avoid this, as the Javadoc tool will ignore the class comment.
The class should look like:
import java.text.DecimalFormat;
/**
* Contains data for each Item to be tallied. Item name and price are
* stored in private variables.
* @author Namfuak
* @version 1.0, Spring 2014
*/
public class MyClass {