You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Steven Rowe (Commented) (JIRA)" <ji...@apache.org> on 2012/04/05 21:56:25 UTC

[jira] [Commented] (SOLR-3323) fix solr javadocs to link to local lucene javadocs w/relative links when users build locally

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

Steven Rowe commented on SOLR-3323:
-----------------------------------

bq. 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/"

+1.

Separately, in trunk right now:

{code:xml}
<target name="define-lucene-javadoc-url-SNAPSHOT" if="version.contains.SNAPSHOT">
  <property name="lucene.javadoc.url"
            value="https://builds.apache.org/job/Lucene-3.x/javadoc/all/"/>
</target>
{code}

That is, Solr trunk javadocs point to the branch_3x Lucene javadocs :(.
                
> 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