LUCENE-4011: fix most broken links in solr javadocs

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1329235 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Robert Muir 2012-04-23 13:44:03 +00:00
parent 7fbe52c74b
commit ab3f63d279
14 changed files with 38 additions and 31 deletions

View File

@ -161,6 +161,15 @@ def checkAll(dirName):
elif link.find('lucene.apache.org/java/docs/discussion.html') != -1:
# OK
pass
elif link.find('lucene.apache.org/solr/mirrors-solr-latest-redir.html') != -1:
# OK
pass
elif link.find('lucene.apache.org/solr/discussion.html') != -1:
# OK
pass
elif link.find('lucene.apache.org/solr/features.html') != -1:
# OK
pass
elif link.find('svn.apache.org') != -1 or link.find('lucene.apache.org') != -1:
if not printed:
printed = True

View File

@ -233,6 +233,7 @@
<link offline="true" href="${lucene.javadoc.url}/analyzers-phonetic" packagelistloc="${lucenedocs}/analyzers-phonetic"/>
<link offline="true" href="${lucene.javadoc.url}/analyzers-smartcn" packagelistloc="${lucenedocs}/analyzers-smartcn"/>
<link offline="true" href="${lucene.javadoc.url}/analyzers-stempel" packagelistloc="${lucenedocs}/analyzers-stempel"/>
<link offline="true" href="${lucene.javadoc.url}/analyzers-uima" packagelistloc="${lucenedocs}/analyzers-uima"/>
<link offline="true" href="${lucene.javadoc.url}/suggest" packagelistloc="${lucenedocs}/suggest"/>
<link offline="true" href="${lucene.javadoc.url}/grouping" packagelistloc="${lucenedocs}/grouping"/>
<link offline="true" href="${lucene.javadoc.url}/queries" packagelistloc="${lucenedocs}/queries"/>

View File

@ -60,7 +60,7 @@ public abstract class DataSource<T> {
* for HttpDataSource or a file location for FileDataSource or a custom
* format for your own custom DataSource.
* @return Depends on the implementation. For instance JdbcDataSource returns
* an Iterator<Map <String,Object>>
* an Iterator&lt;Map &lt;String,Object&gt;&gt;
*/
public abstract T getData(String query);

View File

@ -43,7 +43,7 @@ import org.slf4j.LoggerFactory;
* /a//b...
* /a/b/c
* </pre>
* A record is a Map<String,Object> . The key is the provided name
* A record is a Map&lt;String,Object&gt; . The key is the provided name
* and the value is a String or a List<String>
*
* This class is thread-safe for parsing xml. But adding fields is not
@ -98,7 +98,7 @@ public class XPathRecordReader {
}
/**
* A wrapper around {@link #addField0 addField0()} to create a series of
* A wrapper around <code>addField0</code> to create a series of
* Nodes based on the supplied Xpath and a given fieldName. The created
* nodes are inserted into a Node tree.
*
@ -113,7 +113,7 @@ public class XPathRecordReader {
}
/**
* A wrapper around {@link #addField0 addField0()} to create a series of
* A wrapper around <code>addField0</code> to create a series of
* Nodes based on the supplied Xpath and a given fieldName. The created
* nodes are inserted into a Node tree.
*

View File

@ -35,7 +35,7 @@ import java.util.regex.Pattern;
* &lt;charFilter class="solr.HTMLStripCharFilterFactory" escapedTags="a, title" /&gt;
* &lt;tokenizer class="solr.WhitespaceTokenizerFactory"/&gt;
* &lt;/analyzer&gt;
* &lt;/fieldType&gt;</pre
* &lt;/fieldType&gt;</pre>
*
*/
public class HTMLStripCharFilterFactory extends BaseCharFilterFactory {

View File

@ -1006,7 +1006,6 @@ public class CoreContainer
}
/** Gets a core by name and increase its refcount.
* @see SolrCore#open()
* @see SolrCore#close()
* @param name the core name
* @return the core if found

View File

@ -81,9 +81,9 @@ public class SearchHandler extends RequestHandlerBase implements SolrCoreAware ,
}
/**
* Initialize the components based on name. Note, if using {@link #INIT_FIRST_COMPONENTS} or {@link #INIT_LAST_COMPONENTS},
* Initialize the components based on name. Note, if using <code>INIT_FIRST_COMPONENTS</code> or <code>INIT_LAST_COMPONENTS</code>,
* then the {@link DebugComponent} will always occur last. If this is not desired, then one must explicitly declare all components using
* the {@link #INIT_COMPONENTS} syntax.
* the <code>INIT_COMPONENTS</code> syntax.
*/
@SuppressWarnings("unchecked")
public void inform(SolrCore core)

View File

@ -25,7 +25,7 @@ import org.apache.solr.request.SolrQueryRequest;
/**
* Implementations of <code>BinaryQueryResponseWriter</code> are used to
* write response in binary format
* Functionality is exactly same as its parent class <code>QueryResponseWriter</code
* Functionality is exactly same as its parent class <code>QueryResponseWriter</code>
* But it may not implement the <code>write(Writer writer, SolrQueryRequest request, SolrQueryResponse response)</code>
* method
*

View File

@ -56,7 +56,7 @@ import org.apache.solr.request.SolrQueryRequest;
* </li>
* <li> mm - (Minimum Match) this supports a wide variety of
* complex expressions.
* read {@link org.apache.solr.util.SolrPluginUtils#setMinShouldMatch SolrPluginUtils.setMinShouldMatch} and <a href="http://lucene.apache.org/solr/api/org/apache/solr/util/doc-files/min-should-match.html">mm expression format</a> for details.
* read {@link org.apache.solr.util.SolrPluginUtils#setMinShouldMatch SolrPluginUtils.setMinShouldMatch} and <a href="{@docRoot}/org/apache/solr/util/doc-files/min-should-match.html">mm expression format</a> for details.
* </li>
* <li> pf - (Phrase Fields) fields/boosts to make phrase queries out
* of, to boost the users query for exact matches on the specified fields.

View File

@ -70,7 +70,7 @@ public class DirectSolrConnection
* For example:
*
* String json = solr.request( "/select?qt=dismax&wt=json&q=...", null );
* String xml = solr.request( "/update", "&lt;add><doc><field ..." );
* String xml = solr.request( "/update", "&lt;add&gt;&lt;doc&gt;&lt;field ..." );
*/
public String request( String pathAndParams, String body ) throws Exception
{

View File

@ -20,7 +20,7 @@ package org.apache.solr.util.plugin;
import java.util.Map;
/**
* A plugin that can be initialized with a Map<String,String>
* A plugin that can be initialized with a Map&lt;String,String&gt;
*
*
* @since solr 1.3

View File

@ -126,17 +126,8 @@ public class HttpSolrServer extends SolrServer {
private final HttpClient httpClient;
/**
* This defaults to false under the assumption that if you are following a
* redirect to get to a Solr installation, something is misconfigured
* somewhere.
*/
private boolean followRedirects = false;
/**
* Maximum number of retries to attempt in the event of transient errors.
* Default: 0 (no) retries. No more than 1 recommended.
*/
private int maxRetries = 0;
private ThreadSafeClientConnManager ccm;
@ -517,8 +508,11 @@ public class HttpSolrServer extends SolrServer {
/**
* HttpClientParams.setRedirecting
*
* @see #followRedirects
* <p>
* This defaults to false under the assumption that if you are following a
* redirect to get to a Solr installation, something is misconfigured
* somewhere.
* </p>
*/
public void setFollowRedirects(boolean followRedirects) {
this.followRedirects = followRedirects;
@ -613,10 +607,12 @@ public class HttpSolrServer extends SolrServer {
/**
* Set maximum number of retries to attempt in the event of transient errors.
*
* <p>
* Maximum number of retries to attempt in the event of transient errors.
* Default: 0 (no) retries. No more than 1 recommended.
* </p>
* @param maxRetries
* No more than 1 recommended
* @see #maxRetries
*/
public void setMaxRetries(int maxRetries) {
if (maxRetries > 1) {

View File

@ -180,7 +180,8 @@ public class ClientUtils
/**
* See: <a href="http://lucene.apache.org/java/docs/nightly/queryparsersyntax.html#Escaping%20Special%20Characters">Escaping Special Characters</a>
* See: {@link org.apache.lucene.queryparser.classic queryparser syntax}
* for more information on Escaping Special Characters
*/
public static String escapeQueryChars(String s) {
StringBuilder sb = new StringBuilder();

View File

@ -44,14 +44,15 @@
<target name="javadocs"
depends="compile-core,lucene-javadocs,javadocs-test-framework,define-lucene-javadoc-url">
<sequential>
<solr-invoke-javadoc>
<solrsources>
<mkdir dir="${javadoc.dir}"/>
<invoke-javadoc destdir="${javadoc.dir}"
title="${Name}" overview="${src.dir}/overview.html">
<sources>
<link offline="true" href="${javadoc.link.junit}"
packagelistLoc="${javadoc.packagelist.dir}/junit"/>
<link offline="true" href="${lucene.javadoc.url}/test-framework" packagelistloc="${lucenedocs}/test-framework"/>
<packageset dir="${src.dir}"/>
</solrsources>
</solr-invoke-javadoc>
</sources>
</invoke-javadoc>
<solr-jarify basedir="${javadoc.dir}" destfile="${build.dir}/${final.name}-javadoc.jar"/>
<mkdir dir="${dest}/docs/api/test-framework"/>
<copy todir="${dest}/docs/api/test-framework">