You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Ramkumar Aiyengar (JIRA)" <ji...@apache.org> on 2015/06/23 00:08:01 UTC

[jira] [Commented] (LUCENE-6598) `ant documentation-lint` fails on a checkout with spaces in it

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

Ramkumar Aiyengar commented on LUCENE-6598:
-------------------------------------------

>From the html:

{code}
$ less solr/build/docs/solr-core/org/apache/solr/search/facet/SumAgg.html | grep %2520
<li><a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true" title="class or interface in org.apache.lucene.queries.function">org.apache.lucene.queries.function.ValueSource</a></li>
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../org/apache/solr/search/facet/SumAgg.html#SumAgg-org.apache.lucene.queries.function.ValueSource-">SumAgg</a></span>(<a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true" title="class or interface in org.apache.lucene.queries.function">ValueSource</a>&nbsp;vs)</code>&nbsp;</td>
<h3>Methods inherited from class&nbsp;org.apache.lucene.queries.function.<a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true" title="class or interface in org.apache.lucene.queries.function">ValueSource</a></h3>
<code><a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true#createWeight-java.util.Map-org.apache.lucene.search.IndexSearcher-" title="class or interface in org.apache.lucene.queries.function">createWeight</a>, <a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true#getSortField-boolean-" title="class or interface in org.apache.lucene.queries.function">getSortField</a>, <a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true#newContext-org.apache.lucene.search.IndexSearcher-" title="class or interface in org.apache.lucene.queries.function">newContext</a>, <a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true#toString--" title="class or interface in org.apache.lucene.queries.function">toString</a></code></li>
<pre>public&nbsp;SumAgg(<a href="file:/home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html?is-external=true" title="class or interface in org.apache.lucene.queries.function">ValueSource</a>&nbsp;vs)</pre>
{code}


> `ant documentation-lint` fails on a checkout with spaces in it
> --------------------------------------------------------------
>
>                 Key: LUCENE-6598
>                 URL: https://issues.apache.org/jira/browse/LUCENE-6598
>             Project: Lucene - Core
>          Issue Type: Bug
>            Reporter: Ramkumar Aiyengar
>            Priority: Minor
>
> I haven't yet been able to figure out the cause here, but looks like documentation-lint (and hence precommit) fails on a checkout with spaces in it..
> Lots of errors due to checkJavadocLinks.py
> {code}
> ...
>      [exec] file:///home/ramkrithi/projects/lucene-solr/tr%20unk/solr/build/docs/solr-core/org/apache/solr/search/facet/SumAgg.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
>      [exec]   BROKEN LINK: file:///home/ramkrithi/projects/lucene-solr/tr%2520unk/lucene/build/docs/queries/org/apache/lucene/queries/function/ValueSource.html
> ...
> {code}
> The complaint is actually valid, notice the double escape in the URLs. This seems to affect Solr documentation-lint (Lucene passes) because this problem seems to occur only with the links Javadoc considers "external" (links from Solr to Lucene) and hence puts the full path. Lucene links all have relative paths which don't have this issue.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

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