lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Steven Rowe (Commented) (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading
Date Fri, 25 Nov 2011 19:03:40 GMT

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

Steven Rowe commented on LUCENE-3228:
-------------------------------------

bq. I don't think there's anything left here but to resolve as Won't Fix

I disagree.

bq. 1) we don't distribute dev-tools in our releases, so at a minimum we'd need to find a
new home for any package-list files we wanted to ship.

How does {{lucene/src/tools/javadoc/}} grab you?

bq. 2) the Java documentation from Oracle has some licensing/restrictions that affect redistribution
which don't seem to be compatible with ASF 3rd party licensing policy so we can't include
the java package-list files in our releases

Here is a direct link to the Sun/Oracle documentation redistribution restrictions: [http://java.sun.com/docs/redist.html].

We can include the Java javadoc package-list file in Subversion but exclude it from our source
releases, and include a mechanism to download it when it's absent (i.e., in the source release).

There is an ASF precedent for redistributing Java javadoc package-list files in the Maven
project's javadoc plugin: http://jira.codehaus.org/browse/MJAVADOC-315 and https://jira.codehaus.org/browse/MJAVADOC-327
- in Subversion at [http://svn.apache.org/viewvc/maven/plugins/trunk/maven-javadoc-plugin/src/main/resources/org/apache/maven/plugin/javadoc/].
 I can't find any associated discussion of legal ramifications, though.

I'll put up a patch shortly implementing these ideas.
                
> build should allow you (especially hudson) to refer to a local javadocs installation
instead of downloading
> -----------------------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-3228
>                 URL: https://issues.apache.org/jira/browse/LUCENE-3228
>             Project: Lucene - Java
>          Issue Type: Task
>            Reporter: Robert Muir
>            Assignee: Robert Muir
>         Attachments: LUCENE-3228.patch
>
>
> Currently, we fail on all javadocs warnings.
> However, you get a warning if it cannot download the package-list from sun.com
> So I think we should allow you optionally set a sysprop using linkoffline.
> Then we would get much less hudson "fake failures"
> I feel like Mike opened an issue for this already but I cannot find it.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Mime
View raw message