You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Robert Muir (JIRA)" <ji...@apache.org> on 2011/06/22 13:31:47 UTC

[jira] [Created] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

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


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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158485#comment-13158485 ] 

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

If there are no objections I will commit this tomorrow.
                
> 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.branch_3x.patch, LUCENE-3228.patch, LUCENE-3228.trunk.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


[jira] [Assigned] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Muir reassigned LUCENE-3228:
-----------------------------------

    Assignee: Robert Muir

> 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
>
> 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.
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


[jira] [Assigned] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (Assigned) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Steven Rowe reassigned LUCENE-3228:
-----------------------------------

    Assignee: Steven Rowe  (was: Robert Muir)
    
> 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: Steven Rowe
>         Attachments: LUCENE-3228.branch_3x.patch, LUCENE-3228.patch, LUCENE-3228.trunk.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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13053200#comment-13053200 ] 

Robert Muir commented on LUCENE-3228:
-------------------------------------

I noticed also that solr uses an online link for junit javadocs... we should download this one and do the same, too.
I'll look at this if the link for the sun javadocs "takes" for the 30 minute builds.

> 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
>
> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13059709#comment-13059709 ] 

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

I propose switching to the oracle.com link [suggested by Chris Male|http://www.lucidimagination.com/search/document/7383ed7c64de027e/jenkins_solr_3_x_build_394_failure]:

bq. http://download.oracle.com/javase/6/docs/api/package-list apparently works reliably.

This would be lots simpler than trying to figure out dev-tools etc., assuming that this link is indeed reliable.


> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Uwe Schindler (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13059894#comment-13059894 ] 

Uwe Schindler commented on LUCENE-3228:
---------------------------------------

Sorry, you are right. I have it here, but the README.html in JDK's root folder says:

{quote}
JDK(TM) Documentation

The on-line JavaTM Platform, Standard Edition (Java SE) Documentation contains API specifications, feature descriptions, developer guides, reference pages for JDKTM tools and utilities, demos, and links to related information. This documentation is also available in a download bundle which you can install on your machine. To obtain the documentation bundle, see the download page. For API documentation, refer to the The JavaTM Platform, Standard Edition API Specification This provides brief descriptions of the API with an emphasis on specifications, not on code examples.
{quote}

> 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.
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


[jira] [Updated] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Steven Rowe updated LUCENE-3228:
--------------------------------

    Attachment: LUCENE-3228.trunk.patch

Trunk for patch with the same changes.
                
> 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.branch_3x.patch, LUCENE-3228.patch, LUCENE-3228.trunk.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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13053194#comment-13053194 ] 

Robert Muir commented on LUCENE-3228:
-------------------------------------

as a start, i installed the two freebsd ports for java doc on hudson into /usr/local/share/doc/jdk1.5 and jdk1.6

I'll see if i can add the hooks to the build scripts now


> 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
>
> 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.
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


[jira] [Updated] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Steven Rowe updated LUCENE-3228:
--------------------------------

    Attachment: LUCENE-3228.branch_3x.patch

Patch for branch_3x.  Features:

# Adds package-list files for Oracle Java javadocs and JUnit javadocs to subversion.
# When building Lucene and Solr source releases, the Oracle Java javadocs package-list file is removed.
# When connected or disconnected from the network, javadocs built from a subversion checkout contain links to Oracle javadocs.
# When connected to the network, javadocs built from a source release will attempt to download the Oracle Java package-list file.
# When the Oracle Java package-list file is not present, either because the user is building from a source release while disconnected from the network, or because the package-list file for Oracle Java javadocs is not downloadable for some other reason, javadocs will be built and the build will not fail, though an error will appear in the build log.
# Links from Solr javadocs to Lucene's javadocs are enabled.  When building a non-release version, the links are to the most recently built nightly Jenkins javadocs, as in Hoss's patch on this issue.  When building a release version, links are to the same-versioned Lucene release javadocs.
                
> 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.branch_3x.patch, 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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13054679#comment-13054679 ] 

Hoss Man commented on LUCENE-3228:
----------------------------------

+1

bq. I think we should allow you optionally set a sysprop using linkoffline

hell, why bother with the sysprop? .. lets just commit the package-list files for all third party libs we use into dev-tools and completely eliminate the need for net when building javadocs.



> 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
>
> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13055071#comment-13055071 ] 

Robert Muir commented on LUCENE-3228:
-------------------------------------

I agree with hossman too. I'm just a javadocs dummy and was doing what I could to stop the 30minute builds.

I cant figure out this linkoffline (at least with my experiments its confusing)... but this sounds great.

> 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
>
> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Michael McCandless (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13059818#comment-13059818 ] 

Michael McCandless commented on LUCENE-3228:
--------------------------------------------

+1 let's try this and see if it is indeed reliable.

> 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.
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


[jira] [Updated] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Hoss Man (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Hoss Man updated LUCENE-3228:
-----------------------------

    Attachment: LUCENE-3228.patch

rmuir: here's a rough patch showing how the link offline stuff works. (as far as i understand it anyway)

some quick testing didn't turn up any problems, but i didn't test the where modules/contribs usage of invoke-javadoc.  

there may be cleanup we want to do to - for now i avoided adding more sys properties for the package-list dirs, but maybe we want them? i dunno.  there 's also some existing instances of the "<link>" tag that look totally bogus and broken (see the WTF comments i added) but i didn't test what changes if i remove them

this patch should also fix SOLR-2439 (use relative links for lucene jdocs from solr jdocs.

> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13056084#comment-13056084 ] 

Robert Muir commented on LUCENE-3228:
-------------------------------------

I am glad you had the same "WTF", although ant docs say its ok to use both, the current tasks in e.g. lucene have both the link attribute and nested link-without-href-wtf, and as i tried mixing linkoffline in different ways, it would appear to work, until i changed the link to javaBROKENURL.sun.com/...., etc.

I think we should go with this patch so we aren't downloading this junk anymore, it causes false build failures, the only trick I can think of is how to ensure lucene source releases build by themself without reaching back to dev-tools (i think this is broken on trunk at the moment, but it does work on 3.x right now)

> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Chris Male (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13059712#comment-13059712 ] 

Chris Male commented on LUCENE-3228:
------------------------------------

+1

> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (Commented) (JIRA)" <ji...@apache.org>.
    [ 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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13059883#comment-13059883 ] 

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

bq. The Javadocs are always at same location in $JAVA_HOME

I looked at JAVA_HOME on Windows for 1.5.0_22 and 1.6.0_23 (both 64 bit JDKs), and neither included Javadocs.  Maybe they're separately downloadable?

> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Uwe Schindler (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13059820#comment-13059820 ] 

Uwe Schindler commented on LUCENE-3228:
---------------------------------------

Just one other idea:
- We already have JAVA_HOME set (direct or implicitely set by ANT)
- The Javadocs are always at same location in $JAVA_HOME

Could we not use this to point to the package list (at least fpr the JDK part). I don't like the hardcoded package list.

> 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.
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


[jira] [Resolved] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Steven Rowe (Resolved) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Steven Rowe resolved LUCENE-3228.
---------------------------------

       Resolution: Fixed
    Fix Version/s: 4.0
                   3.6
    Lucene Fields:   (was: New)

Committed:

- r1210020: trunk
- r1210022: branch_3x
                
> 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: Steven Rowe
>             Fix For: 3.6, 4.0
>
>         Attachments: LUCENE-3228.branch_3x.patch, LUCENE-3228.patch, LUCENE-3228.trunk.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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Robert Muir (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13053198#comment-13053198 ] 

Robert Muir commented on LUCENE-3228:
-------------------------------------

As a partial solution, I setup the 30 minute builds to just directly override javadoc.link (and javadoc.link.java for Solr) for our 30 minute builds... we don't care about the actual javadoc artifacts or where the links actually point to, only that there are no warnings.

This is in r1138418

> 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
>
> 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.
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


[jira] [Commented] (LUCENE-3228) build should allow you (especially hudson) to refer to a local javadocs installation instead of downloading

Posted by "Michael McCandless (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/LUCENE-3228?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13055069#comment-13055069 ] 

Michael McCandless commented on LUCENE-3228:
--------------------------------------------

bq.  lets just commit the package-list files for all third party libs we use into dev-tools and completely eliminate the need for net when building javadocs.

+1

Hitting build failures because we can't download these package lists is silly.

> 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
>
> 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.
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