One often problem is a reference to a Unknown or not visible class in a @throws or @exception tag in javadoc.