[ https://issues.apache.org/jira/browse/OFBIZ-9144?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15759339#comment-15759339 ]
Jacques Le Roux commented on OFBIZ-9144: ---------------------------------------- I'm now used to see Taher doing the hardest tasks, so I stopped to congratulate him ;) > refactor javadocs in OFBiz to be standards compliant > ---------------------------------------------------- > > Key: OFBIZ-9144 > URL: https://issues.apache.org/jira/browse/OFBIZ-9144 > Project: OFBiz > Issue Type: Improvement > Components: ALL COMPONENTS > Affects Versions: Upcoming Release > Reporter: Taher Alkhateeb > Assignee: Michael Brohl > Priority: Minor > Fix For: 16.11.02 > > Attachments: OFBIZ-9144_xdoclint_off.patch > > > The OFBiz javadocs are not standard compliant and not legally correct which > means that generating javadocs would fail. As a temporary workaround we added > to the gradle build script: > {code} javadoc.failOnError = false{code} > However, the root solution would be to fix all the errors in javadocs and > eventually remove the above code snippet from gradle. For more about > compliance with javadocs you can read [javadoc style > document|http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html] > The best way to fix this issue is by: > # running "./gradlew javadoc" > # fixing the javadoc errors > # running "./gradlew javadoc" again and ensuring the errors are gone > This is a large task (might need to be broken down to many sub-tasks). Any > help is greatly appreciated! -- This message was sent by Atlassian JIRA (v6.3.4#6332)