edgent-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (QUARKS-205) Create gradle Javadoc task
Date Fri, 24 Jun 2016 05:31:16 GMT

    [ https://issues.apache.org/jira/browse/QUARKS-205?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15347746#comment-15347746
] 

ASF GitHub Bot commented on QUARKS-205:
---------------------------------------

Github user Cazen commented on a diff in the pull request:

    https://github.com/apache/incubator-quarks/pull/147#discussion_r68355123
  
    --- Diff: build.gradle ---
    @@ -28,6 +28,14 @@ ext.ext_classpath = ['com.google.code.gson:gson:2.2.4',
       'io.dropwizard.metrics:metrics-core:3.1.2']
     ext.target_dir = "$distsDir"
     ext.target_java8_dir = "${ext.target_dir}/java8"
    +ext.target_javadoc_dir = "${ext.target_dir}/docs/javadoc"
    +
    +if (JavaVersion.current().isJava8Compatible()) {
    +  tasks.withType(Javadoc) {
    +    options.addStringOption('Xdoclint:none', '-quiet')
    --- End diff --
    
    Hi @dlaboss Thank you for review!
    It looks only few warning in javadoc. I removed Xdoclint:none option.
    I will create another jira issue for remove these warnings
    
    And, except for a few differences, the results of Javadoc of ant and gradle are almost
matches.(compare with ```diff -r build/distributions/docs/javadoc/ target/docs/javadoc/```)
    The only thing I worry about is we could not see the JavaDoc that inherited from interface
    (e.g ```diff -r build/distributions/docs/javadoc/quarks/connectors/file/FileWriterPolicy.html
target/docs/javadoc/quarks/connectors/file/FileWriterPolicy.html``` 
    And the ant output added description from interface like ```Description copied from interface:
quarks.connectors.file.runtime.IFileWriterPolicy``` but gradle is not)
    
    Unfortunately, I still have not found a way to solve this problem. I am still looking
for a solution, but could you tell me if you know the related javadoc options?


> Create gradle Javadoc task
> --------------------------
>
>                 Key: QUARKS-205
>                 URL: https://issues.apache.org/jira/browse/QUARKS-205
>             Project: Quarks
>          Issue Type: Task
>            Reporter: Cazen Lee
>            Assignee: Cazen Lee
>            Priority: Minor
>              Labels: build, newbie
>
> Javadoc parity with ant javadoc task



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message