See the following link
How to Write Doc Comments for the Javadoc Tool
Its a bit text heavy, but provides the standard practice for commenting classes, methods, etc...and when followed allows the...