lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Steven Rowe (Commented) (JIRA)" <>
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


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: [].

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: and
- in Subversion at [].
 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:
>             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
> 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:!default.jspa
For more information on JIRA, see:


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message