lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Hoss Man (Updated) (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (SOLR-3323) fix solr javadocs to link to local lucene javadocs w/relative links when users build locally
Date Thu, 05 Apr 2012 19:34:24 GMT

     [ https://issues.apache.org/jira/browse/SOLR-3323?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Hoss Man updated SOLR-3323:
---------------------------

      Description: 
SOLR-2439 changed how javadoc linkages are handled between solr javadocs and lucene javadocs
-- but i think there is still an improvement to be made.

currently if you are building a "SNAPSHOT" of solr, it links to builds.apache.org for the
lucene docs -- but if you are building solr from src, you must have a full copy of the entire
lucene+solr tree, so we should just use a relative link up to the local copy of the lucene
javadocs (if you are compiling your own solr, you are probably not using precompiled lucene
jars, so you may want to update the lucene javadocs as well)

  was:
Now that solr/lucene are in lock step development, and solr releases include the entire lucene-java
release, the solr ant targets for building javadocs should depend on the lucene (and module)
targets for building javadocs and link directly to the local copies of those docs (using relative
paths)

(currently, the links point to https://hudson.apache.org/hudson/job/Lucene-trunk/javadoc/all/)

    Fix Version/s:     (was: 3.6)

updating summary.

i'm pretty sure this is as simple as changing the default value of lucene.javadoc.url set
in target "define-lucene-javadoc-url-SNAPSHOT" to something like "../lucene/build/docs/api/all/"
                
> fix solr javadocs to link to local lucene javadocs w/relative links when users build
locally
> --------------------------------------------------------------------------------------------
>
>                 Key: SOLR-3323
>                 URL: https://issues.apache.org/jira/browse/SOLR-3323
>             Project: Solr
>          Issue Type: Task
>          Components: documentation
>            Reporter: Hoss Man
>            Assignee: Steven Rowe
>             Fix For: 4.0
>
>
> SOLR-2439 changed how javadoc linkages are handled between solr javadocs and lucene javadocs
-- but i think there is still an improvement to be made.
> currently if you are building a "SNAPSHOT" of solr, it links to builds.apache.org for
the lucene docs -- but if you are building solr from src, you must have a full copy of the
entire lucene+solr tree, so we should just use a relative link up to the local copy of the
lucene javadocs (if you are compiling your own solr, you are probably not using precompiled
lucene jars, so you may want to update the lucene javadocs as well)

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