When you write a shell script in Solaris to run javadoc
(let's name it "run-javadoc"), such as the following:
/usr/local/java/jdk1.3/solaris/bin/javadoc -d docs \
java.applet
and if you mistakenly put a space after a continuation character (\),
such as at the end of the second line, you get this misleading
error message:
% run-javadoc
javadoc: No package, class, or source file found named .
1 error
run-minimal: java.applet: not found
The error message always says that the statement following the extra space
is not found. It took me about 20 minutes to figure out the extra space
was causing this problem. What we need is a message that is not misleading,
and can better pinpoint the problem.