I have created a small java project with maven. The javadoc is included in the pom.xml as needed.
But when I use the generated jar file in another project, the comments made using annotation such as @param and others are missing. When 
Add unimplemented methods (from eclipse)
, the parameters are named agr0, arg1, etc... and not usersame, password.
I don't know how it should be done to get the javadoc documentation right when using an IDE such as Eclipse or IntelliJ
I did add the javadoc plugin as follows:
<plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <executions>
                <!-- JavaDoc Plugin to generate a JAR containing documentation from 
                    the project. -->
                <execution>
                    <id>attach-javadocs</id>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
           </executions>
</plugin>
Best regards.