You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by ct...@apache.org on 2017/05/05 14:44:02 UTC
[1/4] lucene-solr:jira/solr-10290: SOLR-10295: typos
Repository: lucene-solr
Updated Branches:
refs/heads/jira/solr-10290 35e1acbfb -> 4dca53bf5
SOLR-10295: typos
Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/7bd15b90
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/7bd15b90
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/7bd15b90
Branch: refs/heads/jira/solr-10290
Commit: 7bd15b902a78756e333aa9db8363d7178aa53ac3
Parents: 35e1acb
Author: Cassandra Targett <ct...@apache.org>
Authored: Wed May 3 08:38:44 2017 -0500
Committer: Cassandra Targett <ct...@apache.org>
Committed: Wed May 3 08:38:44 2017 -0500
----------------------------------------------------------------------
solr/solr-ref-guide/meta-docs/publish.adoc | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/7bd15b90/solr/solr-ref-guide/meta-docs/publish.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/meta-docs/publish.adoc b/solr/solr-ref-guide/meta-docs/publish.adoc
index 25d288e..2d2ed18 100644
--- a/solr/solr-ref-guide/meta-docs/publish.adoc
+++ b/solr/solr-ref-guide/meta-docs/publish.adoc
@@ -184,7 +184,7 @@ You can use the CMS system for this since it is a small change, or you can edit
If you need to re-publish an existing online copy of the Guide, you will need to checkout the production website repository and use `svn add` and `svn commit` to overwrite the existing files:
. Chekcout the production repo: `svn co https://svn.apache.org/repos/infra/websites/production/lucene/content`
-. Copy the files from the build location to the correct sub-directory under `solr/guide`. For example, if we needed to replace the current Guide for Solr 6.5, we'd do `cp -r <checkoutroot>solr/build/html-site solr/guide/6_5`
+. Copy the files from the build location to the correct sub-directory under `solr/guide`. For example, if we needed to replace the current Guide for Solr 6.5, we'd do `cp -r <checkoutroot>/solr/build/html-site solr/guide/6_5`
. Add the files: `svn add`
. Commit the changes: `svn commit -m "Update production 6.5 Ref Guide"`
[3/4] lucene-solr:jira/solr-10290: SOLR-10295: Use index.html;
fix pub process; add nav for PDFs
Posted by ct...@apache.org.
SOLR-10295: Use index.html; fix pub process; add nav for PDFs
Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/72e0d34b
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/72e0d34b
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/72e0d34b
Branch: refs/heads/jira/solr-10290
Commit: 72e0d34bfdc3dbd8d0af51f1b55904d3b82fb215
Parents: 737464a
Author: Cassandra Targett <ct...@apache.org>
Authored: Wed May 3 13:35:24 2017 -0500
Committer: Cassandra Targett <ct...@apache.org>
Committed: Wed May 3 13:35:24 2017 -0500
----------------------------------------------------------------------
solr/solr-ref-guide/build.xml | 2 +-
solr/solr-ref-guide/meta-docs/publish.adoc | 14 +++++----
solr/solr-ref-guide/src/_includes/topnav.html | 11 ++++++-
.../src/apache-solr-reference-guide.adoc | 30 --------------------
4 files changed, 20 insertions(+), 37 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/72e0d34b/solr/solr-ref-guide/build.xml
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/build.xml b/solr/solr-ref-guide/build.xml
index 3e70ab5..98a69bc 100644
--- a/solr/solr-ref-guide/build.xml
+++ b/solr/solr-ref-guide/build.xml
@@ -44,7 +44,7 @@
<property name="lucene-javadocs" value="https://lucene.apache.org/core/${solr-docs-version-path}/" />
<property name="build.content.dir" location="${build.dir}/content" />
- <property name="main-page" value="apache-solr-reference-guide" />
+ <property name="main-page" value="index" />
<property name="pdf-filename" value="apache-solr-ref-guide-${solr-docs-version}.pdf" />
<!-- ====== TOOLS FOR GENERATING/VALIDATING BITS OF THE SITE / PDF ======= -->
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/72e0d34b/solr/solr-ref-guide/meta-docs/publish.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/meta-docs/publish.adoc b/solr/solr-ref-guide/meta-docs/publish.adoc
index 2d2ed18..5a8fccb 100644
--- a/solr/solr-ref-guide/meta-docs/publish.adoc
+++ b/solr/solr-ref-guide/meta-docs/publish.adoc
@@ -139,8 +139,8 @@ If you have the required dependencies on your local machine, you can build the H
//TODO update Jenkins link
If you do not have the required dependencies, and don't choose to install them, you can download the files from the Jenkins (https://builds.apache.org/job/Solr-reference-guide-jira-SOLR-10290/lastSuccessfulBuild/artifact/solr/build/solr-ref-guide/html-site/[Solr Reference Guide job]).
-// A lot of this was copied from https://wiki.apache.org/lucene-java/ReleaseTodo#Website_.2B-.3D_javadocs. See that section for explanations for why some steps are required.
=== Publish a New Guide
+// A lot of this was copied from https://wiki.apache.org/lucene-java/ReleaseTodo#Website_.2B-.3D_javadocs. See that section for explanations for why some steps are required.
==== Step 1: Update extpaths.txt in CMS Staging
@@ -181,11 +181,15 @@ You can use the CMS system for this since it is a small change, or you can edit
=== Update a Published Guide
-If you need to re-publish an existing online copy of the Guide, you will need to checkout the production website repository and use `svn add` and `svn commit` to overwrite the existing files:
+If you need to re-publish an existing online copy of the Guide, you will need to checkout the directory in production website repository and overwrite the existing files:
-. Chekcout the production repo: `svn co https://svn.apache.org/repos/infra/websites/production/lucene/content`
-. Copy the files from the build location to the correct sub-directory under `solr/guide`. For example, if we needed to replace the current Guide for Solr 6.5, we'd do `cp -r <checkoutroot>/solr/build/html-site solr/guide/6_5`
-. Add the files: `svn add`
+. Build the new HTML files locally (`ant clean build-site`), or download them from Jenkins.
+. Checkout the directory you need to update from the production repo: `svn co https://svn.apache.org/repos/infra/websites/production/lucene/content/solr/guide/<dir>`.
+* This command checks out the Guide version directory into a local subdirectory with the same name as the version (such as "6_5"). You can provide a better name locally if you prefer by adding it to the end of the command shown above.
+* Don't shortcut this and download the whole production website. It will take an incredibly long time and that will feel like _forever_.
+. Copy the files from the build location to the checked out Guide directory. For example, if we needed to replace the current Guide for Solr 6.5, we'd do `cp -r <checkoutroot>/solr/build/html-site 6_5/.`
+. Use `svn status` to see the files modified.
+. If there are any pages added or deleted, use `svn add <file>` or `svn rm <file>` as needed.
. Commit the changes: `svn commit -m "Update production 6.5 Ref Guide"`
// TODO:
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/72e0d34b/solr/solr-ref-guide/src/_includes/topnav.html
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/_includes/topnav.html b/solr/solr-ref-guide/src/_includes/topnav.html
index 82c18a1..bf97b1c 100755
--- a/solr/solr-ref-guide/src/_includes/topnav.html
+++ b/solr/solr-ref-guide/src/_includes/topnav.html
@@ -8,12 +8,21 @@
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
- <a class="fa fa-home fa-lg navbar-brand" href="apache-solr-reference-guide.html"> <span class="projectTitle"> {{site.topnav_title}} {{ site.solr-attributes.solr-docs-version }}</span></a>
+ <a class="fa fa-home fa-lg navbar-brand" href="index.html"> <span class="projectTitle"> {{site.topnav_title}} {{ site.solr-attributes.solr-docs-version }}</span></a>
</div>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
<ul class="nav navbar-nav navbar-right">
<!-- Link to Solr website -->
<li><a href="https://lucene.apache.org/solr/news" target="_blank">Solr News</a></li>
+ <!-- Other Guide Formats dropdown -->
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Other Formats<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="https://www.apache.org/dyn/closer.cgi/lucene/solr/ref-guide" target="_blank">PDF for Latest Release</a></li>
+ <li><a href="https://archive.apache.org/dist/lucene/solr/ref-guide/" target="_blank">Archived PDFs</a></li>
+ <li><a href="https://lucene.apache.org/solr/guide/" target="_blank">Other Versions Online</a></li>
+ </ul>
+ </li>
<!-- Solr Resources dropdown -->
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">Solr Resources<b class="caret"></b></a>
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/72e0d34b/solr/solr-ref-guide/src/apache-solr-reference-guide.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/apache-solr-reference-guide.adoc b/solr/solr-ref-guide/src/apache-solr-reference-guide.adoc
deleted file mode 100644
index 5491238..0000000
--- a/solr/solr-ref-guide/src/apache-solr-reference-guide.adoc
+++ /dev/null
@@ -1,30 +0,0 @@
-= Apache Solr Reference Guide
-:page-shortname: apache-solr-reference-guide
-:page-permalink: apache-solr-reference-guide.html
-:page-children: about-this-guide, getting-started, upgrading-solr, using-the-solr-administration-user-interface, documents-fields-and-schema-design, understanding-analyzers-tokenizers-and-filters, indexing-and-basic-data-operations, searching, the-well-configured-solr-instance, managing-solr, solrcloud, legacy-scaling-and-distribution, client-apis, major-changes-from-solr-5-to-solr-6, upgrading-a-solr-cluster, further-assistance, solr-glossary, errata
-
-This reference guide describes Apache Solr, the open source solution for search. You can download Apache Solr from the Solr website at http://lucene.apache.org/solr/.
-
-This Guide contains the following sections:
-
-**<<getting-started.adoc#getting-started,Getting Started>>**: This section guides you through the installation and setup of Solr.
-
-**<<using-the-solr-administration-user-interface.adoc#using-the-solr-administration-user-interface,Using the Solr Administration User Interface>>**: This section introduces the Solr Web-based user interface. From your browser you can view configuration files, submit queries, view logfile settings and Java environment settings, and monitor and control distributed configurations.
-
-**<<documents-fields-and-schema-design.adoc#documents-fields-and-schema-design,Documents, Fields, and Schema Design>>**: This section describes how Solr organizes its data for indexing. It explains how a Solr schema defines the fields and field types which Solr uses to organize data within the document files it indexes.
-
-**<<understanding-analyzers-tokenizers-and-filters.adoc#understanding-analyzers-tokenizers-and-filters,Understanding Analyzers, Tokenizers, and Filters>>**: This section explains how Solr prepares text for indexing and searching. Analyzers parse text and produce a stream of tokens, lexical units used for indexing and searching. Tokenizers break field data down into tokens. Filters perform other transformational or selective work on token streams.
-
-**<<indexing-and-basic-data-operations.adoc#indexing-and-basic-data-operations,Indexing and Basic Data Operations>>**: This section describes the indexing process and basic index operations, such as commit, optimize, and rollback.
-
-**<<searching.adoc#searching,Searching>>**: This section presents an overview of the search process in Solr. It describes the main components used in searches, including request handlers, query parsers, and response writers. It lists the query parameters that can be passed to Solr, and it describes features such as boosting and faceting, which can be used to fine-tune search results.
-
-**<<the-well-configured-solr-instance.adoc#the-well-configured-solr-instance,The Well-Configured Solr Instance>>**: This section discusses performance tuning for Solr. It begins with an overview of the `solrconfig.xml` file, then tells you how to configure cores with `solr.xml`, how to configure the Lucene index writer, and more.
-
-**<<managing-solr.adoc#managing-solr,Managing Solr>>**: This section discusses important topics for running and monitoring Solr. Other topics include how to back up a Solr instance, and how to run Solr with Java Management Extensions (JMX).
-
-**<<solrcloud.adoc#solrcloud,SolrCloud>>**: This section describes the newest and most exciting of Solr's new features, SolrCloud, which provides comprehensive distributed capabilities.
-
-**<<legacy-scaling-and-distribution.adoc#legacy-scaling-and-distribution,Legacy Scaling and Distribution>>**: This section tells you how to grow a Solr distribution by dividing a large index into sections called shards, which are then distributed across multiple servers, or by replicating a single index across multiple services.
-
-**<<client-apis.adoc#client-apis,Client APIs>>**: This section tells you how to access Solr through various client APIs, including JavaScript, JSON, and Ruby.
[2/4] lucene-solr:jira/solr-10290: SOLR-10295: Use index.html;
add nav for PDF versions
Posted by ct...@apache.org.
SOLR-10295: Use index.html; add nav for PDF versions
Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/737464ab
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/737464ab
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/737464ab
Branch: refs/heads/jira/solr-10290
Commit: 737464ab897a424c2f6677e13d794ab136043de3
Parents: 7bd15b9
Author: Cassandra Targett <ct...@apache.org>
Authored: Wed May 3 13:34:14 2017 -0500
Committer: Cassandra Targett <ct...@apache.org>
Committed: Wed May 3 13:34:14 2017 -0500
----------------------------------------------------------------------
solr/solr-ref-guide/src/index.adoc | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/737464ab/solr/solr-ref-guide/src/index.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/index.adoc b/solr/solr-ref-guide/src/index.adoc
new file mode 100644
index 0000000..f0d957e
--- /dev/null
+++ b/solr/solr-ref-guide/src/index.adoc
@@ -0,0 +1,30 @@
+= Apache Solr Reference Guide
+:page-shortname: index
+:page-permalink: index.html
+:page-children: about-this-guide, getting-started, upgrading-solr, using-the-solr-administration-user-interface, documents-fields-and-schema-design, understanding-analyzers-tokenizers-and-filters, indexing-and-basic-data-operations, searching, the-well-configured-solr-instance, managing-solr, solrcloud, legacy-scaling-and-distribution, client-apis, major-changes-from-solr-5-to-solr-6, upgrading-a-solr-cluster, further-assistance, solr-glossary, errata
+
+This reference guide describes Apache Solr, the open source solution for search. You can download Apache Solr from the Solr website at http://lucene.apache.org/solr/.
+
+This Guide contains the following sections:
+
+**<<getting-started.adoc#getting-started,Getting Started>>**: This section guides you through the installation and setup of Solr.
+
+**<<using-the-solr-administration-user-interface.adoc#using-the-solr-administration-user-interface,Using the Solr Administration User Interface>>**: This section introduces the Solr Web-based user interface. From your browser you can view configuration files, submit queries, view logfile settings and Java environment settings, and monitor and control distributed configurations.
+
+**<<documents-fields-and-schema-design.adoc#documents-fields-and-schema-design,Documents, Fields, and Schema Design>>**: This section describes how Solr organizes its data for indexing. It explains how a Solr schema defines the fields and field types which Solr uses to organize data within the document files it indexes.
+
+**<<understanding-analyzers-tokenizers-and-filters.adoc#understanding-analyzers-tokenizers-and-filters,Understanding Analyzers, Tokenizers, and Filters>>**: This section explains how Solr prepares text for indexing and searching. Analyzers parse text and produce a stream of tokens, lexical units used for indexing and searching. Tokenizers break field data down into tokens. Filters perform other transformational or selective work on token streams.
+
+**<<indexing-and-basic-data-operations.adoc#indexing-and-basic-data-operations,Indexing and Basic Data Operations>>**: This section describes the indexing process and basic index operations, such as commit, optimize, and rollback.
+
+**<<searching.adoc#searching,Searching>>**: This section presents an overview of the search process in Solr. It describes the main components used in searches, including request handlers, query parsers, and response writers. It lists the query parameters that can be passed to Solr, and it describes features such as boosting and faceting, which can be used to fine-tune search results.
+
+**<<the-well-configured-solr-instance.adoc#the-well-configured-solr-instance,The Well-Configured Solr Instance>>**: This section discusses performance tuning for Solr. It begins with an overview of the `solrconfig.xml` file, then tells you how to configure cores with `solr.xml`, how to configure the Lucene index writer, and more.
+
+**<<managing-solr.adoc#managing-solr,Managing Solr>>**: This section discusses important topics for running and monitoring Solr. Other topics include how to back up a Solr instance, and how to run Solr with Java Management Extensions (JMX).
+
+**<<solrcloud.adoc#solrcloud,SolrCloud>>**: This section describes the newest and most exciting of Solr's new features, SolrCloud, which provides comprehensive distributed capabilities.
+
+**<<legacy-scaling-and-distribution.adoc#legacy-scaling-and-distribution,Legacy Scaling and Distribution>>**: This section tells you how to grow a Solr distribution by dividing a large index into sections called shards, which are then distributed across multiple servers, or by replicating a single index across multiple services.
+
+**<<client-apis.adoc#client-apis,Client APIs>>**: This section tells you how to access Solr through various client APIs, including JavaScript, JSON, and Ruby.
[4/4] lucene-solr:jira/solr-10290: SOLR-10290: commit changed pages
since last Confluence export
Posted by ct...@apache.org.
SOLR-10290: commit changed pages since last Confluence export
Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/4dca53bf
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/4dca53bf
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/4dca53bf
Branch: refs/heads/jira/solr-10290
Commit: 4dca53bf59e138b90db7b89c7cf9ca37fcadbe46
Parents: 72e0d34
Author: Cassandra Targett <ct...@apache.org>
Authored: Fri May 5 09:43:37 2017 -0500
Committer: Cassandra Targett <ct...@apache.org>
Committed: Fri May 5 09:43:37 2017 -0500
----------------------------------------------------------------------
.../src/common-query-parameters.adoc | 4 +-
solr/solr-ref-guide/src/coreadmin-api.adoc | 8 +++
.../solr-ref-guide/src/filter-descriptions.adoc | 2 +-
solr/solr-ref-guide/src/function-queries.adoc | 21 ++++++-
solr/solr-ref-guide/src/other-parsers.adoc | 60 +++++++++++++++++++-
.../src/pagination-of-results.adoc | 8 +--
solr/solr-ref-guide/src/response-writers.adoc | 2 +-
.../src/rule-based-authorization-plugin.adoc | 2 +-
.../src/streaming-expressions.adoc | 9 +++
.../src/transforming-result-documents.adoc | 13 +++++
solr/solr-ref-guide/src/upgrading-solr.adoc | 2 +-
solr/solr-ref-guide/src/working-with-dates.adoc | 2 +-
12 files changed, 119 insertions(+), 14 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/common-query-parameters.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/common-query-parameters.adoc b/solr/solr-ref-guide/src/common-query-parameters.adoc
index 0e1dd03..1f4476d 100644
--- a/solr/solr-ref-guide/src/common-query-parameters.adoc
+++ b/solr/solr-ref-guide/src/common-query-parameters.adoc
@@ -118,7 +118,7 @@ fq=+popularity:[10 TO *] +section:0
The `fl` parameter limits the information included in a query response to a specified list of fields. The fields need to either be `stored="true"` or `docValues="true"``.`
-The field list can be specified as a space-separated or comma-separated list of field names. The string "score" can be used to indicate that the score of each document for the particular query should be returned as a field. The wildcard character "`*`" selects all the fields in the document which are either `stored="true"` or `docValues="true"` and` useDocValuesAsStored="true"` (which is the default when docValues are enabled). You can also add psuedo-fields, functions and transformers to the field list request.
+The field list can be specified as a space-separated or comma-separated list of field names. The string "score" can be used to indicate that the score of each document for the particular query should be returned as a field. The wildcard character "`*`" selects all the fields in the document which are either `stored="true"` or `docValues="true"` and` useDocValuesAsStored="true"` (which is the default when docValues are enabled). You can also add pseudo-fields, functions and transformers to the field list request.
This table shows some basic examples of how to use `fl`:
@@ -137,7 +137,7 @@ This table shows some basic examples of how to use `fl`:
[[CommonQueryParameters-FunctionValues]]
=== Function Values
-<<function-queries.adoc#function-queries,Functions>> can be computed for each document in the result and returned as a psuedo-field:
+<<function-queries.adoc#function-queries,Functions>> can be computed for each document in the result and returned as a pseudo-field:
[source,java]
----
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/coreadmin-api.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/coreadmin-api.adoc b/solr/solr-ref-guide/src/coreadmin-api.adoc
index 4c1821f..b3c99b2 100644
--- a/solr/solr-ref-guide/src/coreadmin-api.adoc
+++ b/solr/solr-ref-guide/src/coreadmin-api.adoc
@@ -52,6 +52,14 @@ When you are not running SolrCloud, if you have <<config-sets.adoc#config-sets,C
====
+.CREATE and the core.properties file
+[WARNING]
+====
+
+The core.properties file is built as part of the CREATE command. If you create a core.properties file yourself in a core directory and then try to use CREATE to add that core to Solr, you will get an error telling you that another core is already defined there. The core.properties file must NOT exist before calling the CoreAdmin API with the CREATE command.
+
+====
+
[[CoreAdminAPI-Input.1]]
=== *Input*
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/filter-descriptions.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/filter-descriptions.adoc b/solr/solr-ref-guide/src/filter-descriptions.adoc
index bd7840d..7106f0e 100644
--- a/solr/solr-ref-guide/src/filter-descriptions.adoc
+++ b/solr/solr-ref-guide/src/filter-descriptions.adoc
@@ -1438,7 +1438,7 @@ If you use this filter during indexing, you must follow it with a Flatten Graph
*Arguments:*
-`synonyms`: (required) The path of a file that contains a list of synonyms, one per line. In the (default) `solr` format - see the `format` argument below for alternatives - blank lines and lines that begin with "`#`" are ignored. This may be an absolute path, or path relative to the Solr config directory. There are two ways to specify synonym mappings:
+`synonyms`: (required) The path of a file that contains a list of synonyms, one per line. In the (default) `solr` format - see the `format` argument below for alternatives - blank lines and lines that begin with "`#`" are ignored. This may be a comma-separated list of absolute paths, or paths relative to the Solr config directory. There are two ways to specify synonym mappings:
* A comma-separated list of words. If the token matches any of the words, then all the words in the list are substituted, which will include the original token.
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/function-queries.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/function-queries.adoc b/solr/solr-ref-guide/src/function-queries.adoc
index 3c6d8ab..b69b15f 100644
--- a/solr/solr-ref-guide/src/function-queries.adoc
+++ b/solr/solr-ref-guide/src/function-queries.adoc
@@ -25,7 +25,7 @@ q={!func}div(popularity,price)&fq={!frange l=1000}customer_ratings
----
sort=div(popularity,price) desc, score desc
----
-* Add the results of functions as psuedo-fields to documents in query results. For instance, for:
+* Add the results of functions as pseudo-fields to documents in query results. For instance, for:
+
[source,java]
----
@@ -159,7 +159,24 @@ Returns the ordinal of the indexed field value within the indexed list of terms
See also `rord` below.
|`ord(myIndexedField)` Example: If there were only three values ("apple","banana","pear") for a particular field X, then: `ord(X) `would be 1 for documents containing "apple", 2 for documnts containing "banana", etc...
-|pow |Raises the specified base to the specified power. `pow(x,y)` raises x to the power of y. |`pow(x,y)` `pow(x,log(y))` `pow(x,0.5):` the same as `sqrt`
+|payload a|
+Returns the float value computed from the decoded payloads of the term specified. The return value is computed using the `min`, `max`, or `average` of the decoded payloads. A special `first` function can be used instead of the others, to short-circuit term enumeration and return only the decoded payload of the first term. The field specified must have float or integer payload encoding capability (via `DelimitedPayloadTokenFilter` or `NumericPayloadTokenFilter`). If no payload is found for the term, the default value is returned.
+
+* `payload(field_name,term)`: default value is 0.0, `average` function is used.
+* `payload(field_name,term,default_value)`: default value can be a constant, field name, or another float returning function. `average` function used.
+* `payload(field_name,term,default_value,function)`: function values can be `min`, `max`, `average`, or `first`.
+
+ a|
+....
+payload(payloaded_field_dpf,term,0.0,first)
+....
+
+a|
+....
+pow
+....
+
+ |Raises the specified base to the specified power. `pow(x,y)` raises x to the power of y. |`pow(x,y)` `pow(x,log(y))` `pow(x,0.5):` the same as `sqrt`
|product |Returns the product of multiple values or functions, which are specified in a comma-separated list. `mul(...)` may also be used as an alias for this function. |`product(x,y,...)` `product(x,2)` `product(x,y)mul(x,y)`
|query |Returns the score for the given subquery, or the default value for documents not matching the query. Any type of subquery is supported through either parameter de-referencing `$otherparam` or direct specification of the query string in the <<local-parameters-in-queries.adoc#local-parameters-in-queries,Local Parameters>> through the `v` key. |`query(subquery, default)` `q=product` `(popularity,` ` query({!dismax v='solr rocks'})`: returns the product of the popularity and the score of the DisMax query. `q=product` `(popularity,` ` query($qq))&qq={!dismax}solr rocks`: equivalent to the previous query, using parameter de-referencing. `q=product` `(popularity,` ` query($qq,0.1))` `&qq={!dismax}` `solr rocks`: specifies a default score of 0.1 for documents that don't match the DisMax query.
|recip a|
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/other-parsers.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/other-parsers.adoc b/solr/solr-ref-guide/src/other-parsers.adoc
index d8e4a96..0e8cdda 100644
--- a/solr/solr-ref-guide/src/other-parsers.adoc
+++ b/solr/solr-ref-guide/src/other-parsers.adoc
@@ -26,8 +26,9 @@ Query parsers discussed in this section:
* <<OtherParsers-OldLuceneQueryParser,Old Lucene Query Parser>>
* <<OtherParsers-PrefixQueryParser,Prefix Query Parser>>
* <<OtherParsers-RawQueryParser,Raw Query Parser>>
-* <<OtherParsers-Re-RankingQueryParser,Re-Ranking Query Parser>>
+* <<OtherParsers-PayloadQueryParsers,Payload Query Parsers>>
+* <<OtherParsers-Re-RankingQueryParser,Re-Ranking Query Parser>>
* <<OtherParsers-SimpleQueryParser,Simple Query Parser>>
* <<OtherParsers-SpatialQueryParsers,Spatial Query Parsers>>
* <<OtherParsers-SurroundQueryParser,Surround Query Parser>>
@@ -611,6 +612,63 @@ Example:
{!lucenePlusSort} myfield:foo +bar -baz;price asc
----
+[[OtherParsers-PayloadQueryParsers]]
+== Payload Query Parsers
+
+These query parsers utilize payloads encoded on terms during indexing. The main query, for both of these parsers, is parsed straightforwardly from the field type's query analysis into a `SpanQuery`. The generated `SpanQuery` will be either a `SpanTermQuery` or an ordered, zero slop `SpanNearQuery`, depending on how many tokens are emitted. Payloads can be encoded on terms using either the `DelimitedPayloadTokenFilter` or the `NumericPayloadTokenFilter`. The payload using parsers are:
+
+* `PayloadScoreQParser`
+* `PayloadCheckQParser`
+
+[[OtherParsers-PayloadScoreParser]]
+=== Payload Score Parser
+
+`PayloadScoreQParser` incorporates each matching term's numeric (integer or float) payloads into the scores.
+
+This parser accepts the following parameters:
+
+[width="100%",cols="50%,50%",options="header",]
+|===
+|Parameter |Description
+|`f` |Field to use (required)
+|`func` |Payload function: min, max, average (required)
+|`includeSpanScore` |If true, multiples computed payload factor by the score of the original query. If false, the computed payload factor is the score. (default: false)
+|===
+
+Example:
+
+[source,java]
+----
+{!payload_score f=my_field_dpf v=some_term func=max}
+----
+
+[[OtherParsers-PayloadCheckParser]]
+=== Payload Check Parser
+
+`PayloadCheckQParser` only matches when the matching terms also have the specified payloads.
+
+This parser accepts the following parameters:
+
+// TODO: This table has cells that won't work with PDF: https://github.com/ctargett/refguide-asciidoc-poc/issues/13
+
+[width="100%",cols="50%,50%",options="header",]
+|===
+|Parameter |Description
+|`f` |Field to use (required)
+|payloads a|
+space-separated list of payloads that must match the query terms (required)
+
+Each specified payload will be encoded using the encoder determined from the field type and encoded accordingly for matching.
+
+`DelimitedPayloadTokenFilter` 'identity' encoded payloads also work here, as well as float and integer encoded ones.
+
+|===
+
+[source,java]
+----
+{!payload_check f=words_dps payloads="VERB NOUN"}searching stuff
+----
+
[[OtherParsers-PrefixQueryParser]]
== Prefix Query Parser
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/pagination-of-results.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/pagination-of-results.adoc b/solr/solr-ref-guide/src/pagination-of-results.adoc
index cf13629..731dfce 100644
--- a/solr/solr-ref-guide/src/pagination-of-results.adoc
+++ b/solr/solr-ref-guide/src/pagination-of-results.adoc
@@ -10,7 +10,7 @@ In most search application usage, the "top" matching results (sorted by score, o
[[PaginationofResults-BasicPaginationExamples]]
=== Basic Pagination Examples
-The easiest way to think about simple pagination, is to simply multiply the page number you want (treating the "first" page number as "0") by the number of rows per page; such as in the following psuedo-code:
+The easiest way to think about simple pagination, is to simply multiply the page number you want (treating the "first" page number as "0") by the number of rows per page; such as in the following pseudo-code:
[source,plain]
----
@@ -99,7 +99,7 @@ Cursor mark values are computed based on the sort values of each document in the
[[PaginationofResults-FetchAllDocs]]
==== Fetch All Docs
-The psuedo-code shown here shows the basic logic involved in fetching all documents matching a query using a cursor:
+The pseudo-code shown here shows the basic logic involved in fetching all documents matching a query using a cursor:
[source,plain]
----
@@ -117,7 +117,7 @@ while (not $done) {
}
----
-Using SolrJ, this psuedo-code would be:
+Using SolrJ, this pseudo-code would be:
[source,java]
----
@@ -248,7 +248,7 @@ In this situation, you will be guaranteed that each document is only returned on
[[PaginationofResults-_Tailing_aCursor]]
=== "Tailing" a Cursor
-Because Cursor requests are stateless, and the `cursorMark` values encapsulate the *absolute* sort values of the last document returned from a search, it's possible to "continue" fetching additional results from a cursor that has already reached its end -- if new documents are added (or existing documents are updated) to the end of the results. You can think of this as similar to using something like "`tail -f"` in Unix. The most common examples of how this can be useful is when you have a "timestamp" field recording when a document has been added/updated in your index. Client applications can continuously poll a cursor using a `sort=timestamp asc, id asc` for documents matching a query, and always be notified when a document is added or updated matching the request criteria. Another common example is when you have uniqueKey values that always increase as new documents are created, and you can continuously poll a cursor using `sort=id asc` to be notified about new documents. The psu
edo-code for tailing a cursor is only a slight modification from our early example for processing all docs matching a query:
+Because Cursor requests are stateless, and the cursorMark values encapsulate the absolute sort values of the last document returned from a search, it's possible to "continue" fetching additional results from a cursor that has already reached its end -- if new documents are added (or existing documents are updated) to the end of the results. You can think of this as similar to using something like "tail -f" in Unix. The most common examples of how this can be useful is when you have a "timestamp" field recording when a document has been added/updated in your index. Client applications can continuously poll a cursor using a sort=timestamp asc, id asc for documents matching a query, and always be notified when a document is added or updated matching the request criteria. Another common example is when you have uniqueKey values that always increase as new documents are created, and you can continuously poll a cursor using sort=id asc to be notified about new documents. The pseudo-code f
or tailing a cursor is only a slight modification from our early example for processing all docs matching a query:
[source,java]
----
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/response-writers.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/response-writers.adoc b/solr/solr-ref-guide/src/response-writers.adoc
index 93ee107..6607d6c 100644
--- a/solr/solr-ref-guide/src/response-writers.adoc
+++ b/solr/solr-ref-guide/src/response-writers.adoc
@@ -252,7 +252,7 @@ rsp['response']['docs'].each { |doc| puts 'name field = ' + doc['name'\] }
The CSV response writer returns a list of documents in comma-separated values (CSV) format. Other information that would normally be included in a response, such as facet information, is excluded.
-The CSV response writer supports multi-valued fields, as well as<<transforming-result-documents.adoc#transforming-result-documents,psuedo-fields>>, and the output of this CSV format is compatible with Solr's https://wiki.apache.org/solr/UpdateCSV[CSV update format].
+The CSV response writer supports multi-valued fields, as well as<<transforming-result-documents.adoc#transforming-result-documents,pseudo-fields>>, and the output of this CSV format is compatible with Solr's https://wiki.apache.org/solr/UpdateCSV[CSV update format].
[[ResponseWriters-CSVParameters]]
=== CSV Parameters
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/rule-based-authorization-plugin.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/rule-based-authorization-plugin.adoc b/solr/solr-ref-guide/src/rule-based-authorization-plugin.adoc
index 06480cd..2366143 100644
--- a/solr/solr-ref-guide/src/rule-based-authorization-plugin.adoc
+++ b/solr/solr-ref-guide/src/rule-based-authorization-plugin.adoc
@@ -30,7 +30,7 @@ This example `security.json` shows how the <<basic-authentication-plugin.adoc#ba
"authorization":{
"class":"solr.RuleBasedAuthorizationPlugin",
"permissions":[{"name":"security-edit",
- "role":"admin"}]
+ "role":"admin"}],
"user-role":{"solr":"admin"}
}}
----
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/streaming-expressions.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/streaming-expressions.adoc b/solr/solr-ref-guide/src/streaming-expressions.adoc
index 7ea7d62..fed02af 100644
--- a/solr/solr-ref-guide/src/streaming-expressions.adoc
+++ b/solr/solr-ref-guide/src/streaming-expressions.adoc
@@ -475,6 +475,9 @@ stats(collection1,
count(*))
----
+[[StreamingExpressions-timeseries]]
+=== timeseries
+
[[StreamingExpressions-train]]
=== train
@@ -553,6 +556,9 @@ Stream decorators wrap other stream functions or perform operations on the strea
[[StreamingExpressions-cartesianProduct_6.6_]]
=== cartesianProduct (6.6)
+[[StreamingExpressions-cell]]
+=== cell
+
[[StreamingExpressions-classify]]
=== classify
@@ -1080,6 +1086,9 @@ merge(
on="fieldA asc")
----
+[[StreamingExpressions-list]]
+=== list
+
[[StreamingExpressions-null]]
=== null
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/transforming-result-documents.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/transforming-result-documents.adoc b/solr/solr-ref-guide/src/transforming-result-documents.adoc
index b1fdc9c..9af3ef6 100644
--- a/solr/solr-ref-guide/src/transforming-result-documents.adoc
+++ b/solr/solr-ref-guide/src/transforming-result-documents.adoc
@@ -256,6 +256,19 @@ Here is how it looks like in various formats:
SolrDocumentList subResults = (SolrDocumentList)doc.getFieldValue("children");
----
+[[TransformingResultDocuments-Subqueryresultfields]]
+==== Subquery result fields
+
+To appear in subquery document list, a field should be specified both fl parameters, in main one fl (despite the main result documents have no this field) and in subquery's one eg `foo.fl`. Of course, you can use wildcard in any or both of these parameters. For example, if field title should appear in categories subquery, it can be done via one of these ways.
+
+[source,java]
+----
+fl=...title,categories:[subquery]&categories.fl=title&categories.q=...
+fl=...title,categories:[subquery]&categories.fl=*&categories.q=...
+fl=...*,categories:[subquery]&categories.fl=*&categories.q=...
+fl=...*,categories:[subquery]&categories.fl=*&categories.q=...
+----
+
[[TransformingResultDocuments-SubqueryParametersShift]]
==== Subquery Parameters Shift
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/upgrading-solr.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/upgrading-solr.adoc b/solr/solr-ref-guide/src/upgrading-solr.adoc
index 8c60878..27faa14 100644
--- a/solr/solr-ref-guide/src/upgrading-solr.adoc
+++ b/solr/solr-ref-guide/src/upgrading-solr.adoc
@@ -13,7 +13,7 @@ If you are already using Solr 6.5, Solr 6.6 should not present any major problem
== Upgrading from earlier 6.x versions
* If you use historical dates, specifically on or before the year 1582, you should re-index after upgrading to this version.
-* If you use the https://cwiki.apache.org/confluence/display/solr/Faceted+Search[JSON Facet API] (json.facet) with `method=stream`, you must now set `sort='index asc'` to get the streaming behavior; otherwise it won't stream. Reminder: "method" is a hint that doesn't change defaults of other parameters.
+* If you use the <<faceted-search.adoc#faceted-search,JSON Facet API>> (json.facet) with `method=stream`, you must now set `sort='index asc'` to get the streaming behavior; otherwise it won't stream. Reminder: "method" is a hint that doesn't change defaults of other parameters.
* If you use the JSON Facet API (json.facet) to facet on a numeric field and if you use `mincount=0` or if you set the prefix, then you will now get an error as these options are incompatible with numeric faceting.
* Solr's logging verbosity at the INFO level has been greatly reduced, and you may need to update the log configs to use the DEBUG level to see all the logging messages you used to see at INFO level before.
* We are no longer backing up `solr.log` and `solr_gc.log` files in date-stamped copies forever. If you relied on the `solr_log_<date>` or `solr_gc_log_<date>` being in the logs folder that will no longer be the case. See the section <<configuring-logging.adoc#configuring-logging,Configuring Logging>> for details on how log rotation works as of Solr 6.3.
http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/4dca53bf/solr/solr-ref-guide/src/working-with-dates.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/working-with-dates.adoc b/solr/solr-ref-guide/src/working-with-dates.adoc
index 7fe8244..09cac9c 100644
--- a/solr/solr-ref-guide/src/working-with-dates.adoc
+++ b/solr/solr-ref-guide/src/working-with-dates.adoc
@@ -37,7 +37,7 @@ As you can see, the date format includes colon characters separating the hours,
This is normally an invalid query: `datefield:1972-05-20T17:33:18.772Z`
-These are valid queries: `datefield:1972-05-20T17\:33\:18.772Z` `datefield:"1972-05-20T17:33:18.772Z"` `datefield:[1972-05-20T17:33:18.772 TO *]`
+These are valid queries: `datefield:1972-05-20T17\:33\:18.772Z` `datefield:"1972-05-20T17:33:18.772Z"` `datefield:[1972-05-20T17:33:18.772Z TO *]`
====