Given the command
% javadoc -sourcepath /foo/bar com.sun.baz
Javadoc will try to parse every file in the directory /foo/bar/com/sun/baz
whose name ends with ".java", regardless of whether the name, stripped of that
suffix, is actually a legal class name. This causes problems with files that
are used as templates for source files that are generated during the build.
Such files are typically named using characters such as '-' in order to
distinguish them from ordinary class files, and the contents of such files
are not quite legal Java code.
-- mr@eng 2000/12/15