It is suggested that the preferrred way of creating the information for a Java package, such that the javadoc tool recognizes it as such, while creating the javadoc documentation.

I decided to take this advice and immediately landed into problem of inconsistency with it. I could not create this file as a Java source file, using the NetBeans IDE because it is not a proper java class name! So, I wonder why Java SE decided to take such a name. Wouldn't just packageinfo.java serve the purpose?

Am I missing something obvious?