RubyGems - rroonga - Versions diffs - 4.0.1-x86-mingw32 → 4.0.2-x86-mingw32 - Mend

rroonga 4.0.1-x86-mingw32 → 4.0.2-x86-mingw32

Files changed (477) hide show

data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>8.3.24. select &mdash; Groonga v4.0.1 documentation</title>
+    <title>8.3.25. select &mdash; Groonga v4.0.1-127-g9422d50 documentation</title>
     <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../../',
-        VERSION:     '4.0.1',
+        VERSION:     '4.0.1-127-g9422d50',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -25,10 +25,10 @@
     <script type="text/javascript" src="../../_static/underscore.js"></script>
     <script type="text/javascript" src="../../_static/doctools.js"></script>
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
-    <link rel="top" title="Groonga v4.0.1 documentation" href="../../index.html" />
+    <link rel="top" title="Groonga v4.0.1-127-g9422d50 documentation" href="../../index.html" />
     <link rel="up" title="8.3. Command" href="../command.html" />
-    <link rel="next" title="8.3.25. shutdown" href="shutdown.html" />
-    <link rel="prev" title="8.3.23. ruby_load" href="ruby_load.html" />
+    <link rel="next" title="8.3.26. shutdown" href="shutdown.html" />
+    <link rel="prev" title="8.3.24. ruby_load" href="ruby_load.html" />
   </head>
   <body role="document">
 <div class="header">
@@ -55,12 +55,12 @@
           <a href="../../genindex.html" title="General Index"
              accesskey="I">index</a></li>
         <li class="right" >
-          <a href="shutdown.html" title="8.3.25. shutdown"
+          <a href="shutdown.html" title="8.3.26. shutdown"
              accesskey="N">next</a> |</li>
         <li class="right" >
-          <a href="ruby_load.html" title="8.3.23. ruby_load"
+          <a href="ruby_load.html" title="8.3.24. ruby_load"
              accesskey="P">previous</a> |</li>
-        <li><a href="../../index.html">Groonga v4.0.1 documentation</a> &raquo;</li>
+        <li><a href="../../index.html">Groonga v4.0.1-127-g9422d50 documentation</a> &raquo;</li>
           <li><a href="../../reference.html" >8. Reference manual</a> &raquo;</li>
           <li><a href="../command.html" accesskey="U">8.3. Command</a> &raquo;</li>
       </ul>
@@ -72,16 +72,16 @@
           <div class="body" role="main">
   <div class="section" id="select">
-<h1>8.3.24. <tt class="docutils literal"><span class="pre">select</span></tt><a class="headerlink" href="#select" title="Permalink to this headline">¶</a></h1>
+<h1>8.3.25. <tt class="docutils literal"><span class="pre">select</span></tt><a class="headerlink" href="#select" title="Permalink to this headline">¶</a></h1>
 <div class="section" id="summary">
-<h2>8.3.24.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
+<h2>8.3.25.1. Summary<a class="headerlink" href="#summary" title="Permalink to this headline">¶</a></h2>
 <p><tt class="docutils literal"><span class="pre">select</span></tt> searches records that are matched to specified conditions
 from a table and then outputs them.</p>
 <p><tt class="docutils literal"><span class="pre">select</span></tt> is the most important command in groonga. You need to
 understand <tt class="docutils literal"><span class="pre">select</span></tt> to use the full power of groonga.</p>
 </div>
 <div class="section" id="syntax">
-<h2>8.3.24.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
+<h2>8.3.25.2. Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
 <p><tt class="docutils literal"><span class="pre">select</span></tt> has many parameters. The required parameter is only
 <tt class="docutils literal"><span class="pre">table</span></tt> and others are optional:</p>
 <div class="highlight-none"><div class="highlight"><pre>select table
@@ -95,7 +95,7 @@ understand <tt class="docutils literal"><span class="pre">select</span></tt> to
        [limit=10]
        [drilldown=null]
        [drilldown_sortby=null]
-       [drilldown_output_columns=null]
+       [drilldown_output_columns=&quot;_key, _nsubrecs&quot;]
        [drilldown_offset=0]
        [drilldown_limit=10]
        [cache=yes]
@@ -108,7 +108,7 @@ understand <tt class="docutils literal"><span class="pre">select</span></tt> to
 </div>
 </div>
 <div class="section" id="usage">
-<h2>8.3.24.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
+<h2>8.3.25.3. Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
 <p>Let's learn about <tt class="docutils literal"><span class="pre">select</span></tt> usage with examples. This section shows
 many popular usages.</p>
 <p>Here are a schema definition and sample data to show usage.</p>
@@ -155,7 +155,7 @@ using <tt class="docutils literal"><span class="pre">TokenBigram</span></tt> tok
 <tt class="docutils literal"><span class="pre">Entries.content</span></tt> are fulltext search ready.</p>
 <p>OK. The schema and data for examples are ready.</p>
 <div class="section" id="simple-usage">
-<h3>8.3.24.3.1. Simple usage<a class="headerlink" href="#simple-usage" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.3.1. Simple usage<a class="headerlink" href="#simple-usage" title="Permalink to this headline">¶</a></h3>
 <p>Here is the most simple usage with the above schema and data. It outputs
 all records in <tt class="docutils literal"><span class="pre">Entries</span></tt> table.</p>
 <p>Execution example:</p>
@@ -232,12 +232,12 @@ command outputs 10 records at a maximum by default. There are only 5
 records. It is less than 10. So the command outputs all records.</p>
 </div>
 <div class="section" id="search-conditions">
-<h3>8.3.24.3.2. Search conditions<a class="headerlink" href="#search-conditions" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.3.2. Search conditions<a class="headerlink" href="#search-conditions" title="Permalink to this headline">¶</a></h3>
 <p>Search conditions are specified by <tt class="docutils literal"><span class="pre">query</span></tt> or <tt class="docutils literal"><span class="pre">filter</span></tt>. You can
 also specify both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt>. It means that selected
 records must be matched against both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt>.</p>
 <div class="section" id="search-condition-query">
-<h4>8.3.24.3.2.1. Search condition: <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#search-condition-query" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.3.2.1. Search condition: <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#search-condition-query" title="Permalink to this headline">¶</a></h4>
 <p><tt class="docutils literal"><span class="pre">query</span></tt> is designed for search box in Web page. Imagine a search box
 in google.com. You specify search conditions for <tt class="docutils literal"><span class="pre">query</span></tt> as space
 separated keywords. For example, <tt class="docutils literal"><span class="pre">search</span> <span class="pre">engine</span></tt> means a matched
@@ -304,7 +304,7 @@ in <tt class="docutils literal"><span class="pre">content</span></tt> column val
 <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for datails.</p>
 </div>
 <div class="section" id="search-condition-filter">
-<h4>8.3.24.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#search-condition-filter" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#search-condition-filter" title="Permalink to this headline">¶</a></h4>
 <p><tt class="docutils literal"><span class="pre">filter</span></tt> is designed for complex search conditions. You specify
 search conditions for <tt class="docutils literal"><span class="pre">filter</span></tt> as ECMAScript like syntax.</p>
 <p>Here is a simple <tt class="docutils literal"><span class="pre">filter</span></tt> usage example.</p>
@@ -362,7 +362,7 @@ datails.</p>
 </div>
 </div>
 <div class="section" id="paging">
-<h3>8.3.24.3.3. Paging<a class="headerlink" href="#paging" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.3.3. Paging<a class="headerlink" href="#paging" title="Permalink to this headline">¶</a></h3>
 <p>You can specify range of outputted records by <tt class="docutils literal"><span class="pre">offset</span></tt> and <tt class="docutils literal"><span class="pre">limit</span></tt>.
 Here is an example to output only the 2nd record.</p>
 <p>Execution example:</p>
@@ -414,7 +414,7 @@ means the number of output records is 1 at a maximium. If no records
 are matched, <tt class="docutils literal"><span class="pre">select</span></tt> command outputs no records.</p>
 </div>
 <div class="section" id="the-total-number-of-records">
-<h3>8.3.24.3.4. The total number of records<a class="headerlink" href="#the-total-number-of-records" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.3.4. The total number of records<a class="headerlink" href="#the-total-number-of-records" title="Permalink to this headline">¶</a></h3>
 <p>You can use <tt class="docutils literal"><span class="pre">--limit</span> <span class="pre">0</span></tt> to retrieve the total number of recrods
 without any contents of records.</p>
 <p>Execution example:</p>
@@ -458,13 +458,13 @@ records.</p>
 </div>
 </div>
 <div class="section" id="parameters">
-<h2>8.3.24.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
+<h2>8.3.25.4. Parameters<a class="headerlink" href="#parameters" title="Permalink to this headline">¶</a></h2>
 <p>This section describes all parameters. Parameters are categorized.</p>
 <div class="section" id="required-parameter">
-<h3>8.3.24.4.1. Required parameter<a class="headerlink" href="#required-parameter" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.1. Required parameter<a class="headerlink" href="#required-parameter" title="Permalink to this headline">¶</a></h3>
 <p>There is a required parameter, <tt class="docutils literal"><span class="pre">table</span></tt>.</p>
 <div class="section" id="table">
-<span id="select-table"></span><h4>8.3.24.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt><a class="headerlink" href="#table" title="Permalink to this headline">¶</a></h4>
+<span id="select-table"></span><h4>8.3.25.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt><a class="headerlink" href="#table" title="Permalink to this headline">¶</a></h4>
 <p>It specifies a table to be searched. <tt class="docutils literal"><span class="pre">table</span></tt> must be specified.</p>
 <p>If nonexistent table is specified, an error is returned.</p>
 <p>Execution example:</p>
@@ -489,7 +489,7 @@ records.</p>
 </div>
 </div>
 <div class="section" id="search-related-parameters">
-<h3>8.3.24.4.2. Search related parameters<a class="headerlink" href="#search-related-parameters" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.2. Search related parameters<a class="headerlink" href="#search-related-parameters" title="Permalink to this headline">¶</a></h3>
 <p>There are search related parameters. Typically, <tt class="docutils literal"><span class="pre">match_columns</span></tt> and
 <tt class="docutils literal"><span class="pre">query</span></tt> parameters are used for implementing a search
 box. <tt class="docutils literal"><span class="pre">filter</span></tt> parameters is used for implementing complex search
@@ -498,7 +498,7 @@ feature.</p>
 be matched against both <tt class="docutils literal"><span class="pre">query</span></tt> and <tt class="docutils literal"><span class="pre">filter</span></tt>. If both <tt class="docutils literal"><span class="pre">query</span></tt>
 and <tt class="docutils literal"><span class="pre">filter</span></tt> aren't specified, all records are selected.</p>
 <div class="section" id="match-columns">
-<span id="select-match-columns"></span><h4>8.3.24.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt><a class="headerlink" href="#match-columns" title="Permalink to this headline">¶</a></h4>
+<span id="select-match-columns"></span><h4>8.3.25.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt><a class="headerlink" href="#match-columns" title="Permalink to this headline">¶</a></h4>
 <p>It specifies the default target column for fulltext search by
 <tt class="docutils literal"><span class="pre">query</span></tt> parameter value. A target column for fulltext search can be
 specified in <tt class="docutils literal"><span class="pre">query</span></tt> parameter. The difference between
@@ -646,7 +646,7 @@ important rather than <tt class="docutils literal"><span class="pre">content</sp
 of blog entry is more important rather thatn content of blog entry.</p>
 </div>
 <div class="section" id="query">
-<span id="select-query"></span><h4>8.3.24.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#query" title="Permalink to this headline">¶</a></h4>
+<span id="select-query"></span><h4>8.3.25.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt><a class="headerlink" href="#query" title="Permalink to this headline">¶</a></h4>
 <p>It specifies the query text. Normally, it is used for fulltext search
 with <tt class="docutils literal"><span class="pre">match_columns</span></tt> parameter. <tt class="docutils literal"><span class="pre">query</span></tt> parameter is designed for
 a fulltext search form in a Web page. A query text should be formatted
@@ -869,7 +869,7 @@ is less than <tt class="docutils literal"><span class="pre">11</span></tt> from
 <p>See <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a> for other operations.</p>
 </div>
 <div class="section" id="filter">
-<span id="select-filter"></span><h4>8.3.24.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#filter" title="Permalink to this headline">¶</a></h4>
+<span id="select-filter"></span><h4>8.3.25.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt><a class="headerlink" href="#filter" title="Permalink to this headline">¶</a></h4>
 <p>It specifies the filter text. Normally, it is used for complex search
 conditions. <tt class="docutils literal"><span class="pre">filter</span></tt> can be used with <tt class="docutils literal"><span class="pre">query</span></tt> parameter. If both
 <tt class="docutils literal"><span class="pre">filter</span></tt> and <tt class="docutils literal"><span class="pre">query</span></tt> are specified, there are conbined with
@@ -993,9 +993,9 @@ is less than <tt class="docutils literal"><span class="pre">11</span></tt> from
 </div>
 </div>
 <div class="section" id="advanced-search-parameters">
-<h3>8.3.24.4.3. Advanced search parameters<a class="headerlink" href="#advanced-search-parameters" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.3. Advanced search parameters<a class="headerlink" href="#advanced-search-parameters" title="Permalink to this headline">¶</a></h3>
 <div class="section" id="match-escalation-threshold">
-<span id="id1"></span><h4>8.3.24.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt><a class="headerlink" href="#match-escalation-threshold" title="Permalink to this headline">¶</a></h4>
+<span id="id1"></span><h4>8.3.25.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt><a class="headerlink" href="#match-escalation-threshold" title="Permalink to this headline">¶</a></h4>
 <p>It specifies threshold to determine whether search storategy
 escalation is used or not. The threshold is compared against the
 number of matched records. If the number of matched records is equal
@@ -1110,11 +1110,11 @@ records (0) is larger than <tt class="docutils literal"><span class="pre">match_
 more searches aren't executed. And no records are matched.</p>
 </div>
 <div class="section" id="query-expansion">
-<span id="id2"></span><h4>8.3.24.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt><a class="headerlink" href="#query-expansion" title="Permalink to this headline">¶</a></h4>
+<span id="id2"></span><h4>8.3.25.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt><a class="headerlink" href="#query-expansion" title="Permalink to this headline">¶</a></h4>
 <p>Deprecated. Use <a class="reference internal" href="#query-expander"><em>query_expander</em></a> instead.</p>
 </div>
 <div class="section" id="query-flags">
-<span id="id3"></span><h4>8.3.24.4.3.3. <tt class="docutils literal"><span class="pre">query_flags</span></tt><a class="headerlink" href="#query-flags" title="Permalink to this headline">¶</a></h4>
+<span id="id3"></span><h4>8.3.25.4.3.3. <tt class="docutils literal"><span class="pre">query_flags</span></tt><a class="headerlink" href="#query-flags" title="Permalink to this headline">¶</a></h4>
 <p>It customs <tt class="docutils literal"><span class="pre">query</span></tt> parameter syntax. You cannot update column value
 by <tt class="docutils literal"><span class="pre">query</span></tt> parameter by default. But if you specify
 <tt class="docutils literal"><span class="pre">ALLOW_COLUMN|ALLOW_UPDATE</span></tt> as <tt class="docutils literal"><span class="pre">query_flags</span></tt>, you can update
@@ -1398,7 +1398,7 @@ specified.</p>
 <p>See also <a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a>.</p>
 </div>
 <div class="section" id="query-expander">
-<span id="id4"></span><h4>8.3.24.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt><a class="headerlink" href="#query-expander" title="Permalink to this headline">¶</a></h4>
+<span id="id4"></span><h4>8.3.25.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt><a class="headerlink" href="#query-expander" title="Permalink to this headline">¶</a></h4>
 <p>It's for query expansion. Query expansion substitutes specific words
 to another words in query. Nomally, it's used for synonym search.</p>
 <p>It specifies a column that is used to substitute <tt class="docutils literal"><span class="pre">query</span></tt> parameter
@@ -1652,9 +1652,9 @@ is equal to or more than <tt class="docutils literal"><span class="pre">10</span
 </div>
 </div>
 <div class="section" id="output-related-parameters">
-<h3>8.3.24.4.4. Output related parameters<a class="headerlink" href="#output-related-parameters" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.4. Output related parameters<a class="headerlink" href="#output-related-parameters" title="Permalink to this headline">¶</a></h3>
 <div class="section" id="output-columns">
-<span id="id5"></span><h4>8.3.24.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt><a class="headerlink" href="#output-columns" title="Permalink to this headline">¶</a></h4>
+<span id="id5"></span><h4>8.3.25.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt><a class="headerlink" href="#output-columns" title="Permalink to this headline">¶</a></h4>
 <p>It specifies output columns separated by <tt class="docutils literal"><span class="pre">,</span></tt>.</p>
 <p>Here is a simple <tt class="docutils literal"><span class="pre">output_columns</span></tt> usage example.</p>
 <p>Execution example:</p>
@@ -1692,7 +1692,7 @@ is equal to or more than <tt class="docutils literal"><span class="pre">10</span
 <p>The <tt class="docutils literal"><span class="pre">select</span></tt> command just outputs <tt class="docutils literal"><span class="pre">_id</span></tt> and <tt class="docutils literal"><span class="pre">_key</span></tt> column
 values.</p>
 <p><tt class="docutils literal"><span class="pre">*</span></tt> is a special value. It means that all columns that are not
-<a class="reference internal" href="../pseudo_column.html"><em>疑似カラム (pseudo_column)</em></a>.</p>
+<a class="reference internal" href="../columns/pseudo.html"><em>疑似カラム (pseudo_column)</em></a>.</p>
 <p>Here is a <tt class="docutils literal"><span class="pre">*</span></tt> usage example.</p>
 <p>Execution example:</p>
 <div class="highlight-none"><div class="highlight"><pre>select Entries --output_columns &#39;_key, *&#39; --limit 1
@@ -1738,7 +1738,7 @@ column value.</p>
 values except <tt class="docutils literal"><span class="pre">_score</span></tt> are outputted.</p>
 </div>
 <div class="section" id="sortby">
-<h4>8.3.24.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt><a class="headerlink" href="#sortby" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt><a class="headerlink" href="#sortby" title="Permalink to this headline">¶</a></h4>
 <p>It specifies sort keys separated by <tt class="docutils literal"><span class="pre">,</span></tt>. Each sort key is column
 name.</p>
 <p>Here is a simple <tt class="docutils literal"><span class="pre">sortby</span></tt> usage example.</p>
@@ -1926,7 +1926,7 @@ descending order and outputs record key and hit score.</p>
 it's just ignored but get a warning in log file.</p>
 </div>
 <div class="section" id="offset">
-<h4>8.3.24.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt><a class="headerlink" href="#offset" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt><a class="headerlink" href="#offset" title="Permalink to this headline">¶</a></h4>
 <p>It specifies offset to determine output records range. Offset is
 zero-origin. <tt class="docutils literal"><span class="pre">--offset</span> <span class="pre">1</span></tt> means output range is started from the 2nd
 record.</p>
@@ -2000,7 +2000,7 @@ number of records is <tt class="docutils literal"><span class="pre">5</span></tt
 <p>The default value is <tt class="docutils literal"><span class="pre">0</span></tt>.</p>
 </div>
 <div class="section" id="limit">
-<h4>8.3.24.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt><a class="headerlink" href="#limit" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt><a class="headerlink" href="#limit" title="Permalink to this headline">¶</a></h4>
 <p>It specifies the max number of output records. If the number of
 matched records is less than <tt class="docutils literal"><span class="pre">limit</span></tt>, all records are outputted.</p>
 <p>Here is a simple <tt class="docutils literal"><span class="pre">limit</span></tt> usage example.</p>
@@ -2112,44 +2112,44 @@ records. It's very useful value to show all records.</p>
 <p>The default value is <tt class="docutils literal"><span class="pre">10</span></tt>.</p>
 </div>
 <div class="section" id="scorer">
-<h4>8.3.24.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt><a class="headerlink" href="#scorer" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt><a class="headerlink" href="#scorer" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。</p>
 <p>scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。</p>
 </div>
 </div>
 <div class="section" id="facet-related-parameters">
-<h3>8.3.24.4.5. Facet related parameters<a class="headerlink" href="#facet-related-parameters" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.5. Facet related parameters<a class="headerlink" href="#facet-related-parameters" title="Permalink to this headline">¶</a></h3>
 <div class="section" id="drilldown">
-<h4>8.3.24.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt><a class="headerlink" href="#drilldown" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt><a class="headerlink" href="#drilldown" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>グループ化のキーとなるカラム名のリストをカンマ(',')区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。</p>
 </div>
 <div class="section" id="drilldown-sortby">
-<h4>8.3.24.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt><a class="headerlink" href="#drilldown-sortby" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt><a class="headerlink" href="#drilldown-sortby" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(',')区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。</p>
 </div>
 <div class="section" id="drilldown-output-columns">
-<h4>8.3.24.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt><a class="headerlink" href="#drilldown-output-columns" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt><a class="headerlink" href="#drilldown-output-columns" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(',')区切りで指定します。</p>
 </div>
 <div class="section" id="drilldown-offset">
-<h4>8.3.24.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt><a class="headerlink" href="#drilldown-offset" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt><a class="headerlink" href="#drilldown-offset" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。</p>
 </div>
 <div class="section" id="drilldown-limit">
-<h4>8.3.24.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt><a class="headerlink" href="#drilldown-limit" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt><a class="headerlink" href="#drilldown-limit" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。</p>
 </div>
 </div>
 <div class="section" id="cache-related-parameter">
-<h3>8.3.24.4.6. Cache related parameter<a class="headerlink" href="#cache-related-parameter" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.6. Cache related parameter<a class="headerlink" href="#cache-related-parameter" title="Permalink to this headline">¶</a></h3>
 <div class="section" id="cache">
-<h4>8.3.24.4.6.1. <tt class="docutils literal"><span class="pre">cache</span></tt><a class="headerlink" href="#cache" title="Permalink to this headline">¶</a></h4>
+<h4>8.3.25.4.6.1. <tt class="docutils literal"><span class="pre">cache</span></tt><a class="headerlink" href="#cache" title="Permalink to this headline">¶</a></h4>
 <p>TODO: write in English and add example.</p>
 <p>クエリキャッシュに関する動作を設定します。</p>
 <p><tt class="docutils literal"><span class="pre">no</span></tt></p>
@@ -2158,10 +2158,10 @@ records. It's very useful value to show all records.</p>
 </div>
 </div>
 <div class="section" id="score-related-parameters">
-<h3>8.3.24.4.7. Score related parameters<a class="headerlink" href="#score-related-parameters" title="Permalink to this headline">¶</a></h3>
+<h3>8.3.25.4.7. Score related parameters<a class="headerlink" href="#score-related-parameters" title="Permalink to this headline">¶</a></h3>
 <p>There is a score related parameter, <tt class="docutils literal"><span class="pre">adjuster</span></tt>.</p>
 <div class="section" id="adjuster">
-<span id="select-adjuster"></span><h4>8.3.24.4.7.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt><a class="headerlink" href="#adjuster" title="Permalink to this headline">¶</a></h4>
+<span id="select-adjuster"></span><h4>8.3.25.4.7.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt><a class="headerlink" href="#adjuster" title="Permalink to this headline">¶</a></h4>
 <p>It specifies one or more score adjust expressions. You need to use
 <tt class="docutils literal"><span class="pre">adjuster</span></tt> with <tt class="docutils literal"><span class="pre">query</span></tt> or <tt class="docutils literal"><span class="pre">filter</span></tt>. <tt class="docutils literal"><span class="pre">adjuster</span></tt> doesn't work
 with not searched request.</p>
@@ -2254,6 +2254,66 @@ record that has <tt class="docutils literal"><span class="pre">&quot;groonga&quo
 record that its key is <tt class="docutils literal"><span class="pre">&quot;Groonga&quot;</span></tt> has score 6 (<tt class="docutils literal"><span class="pre">=</span> <span class="pre">1</span> <span class="pre">+</span> <span class="pre">5</span></tt>).</p>
 <p>You can omit <tt class="docutils literal"><span class="pre">FACTOR</span></tt>. If you omit <tt class="docutils literal"><span class="pre">FACTOR</span></tt>, it is treated as 1.</p>
 <p>Here is a sample <tt class="docutils literal"><span class="pre">adjuster</span></tt> usage example that omits <tt class="docutils literal"><span class="pre">FACTOR</span></tt>:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Entries \
+  --filter true \
+  --adjuster &#39;content @ &quot;groonga&quot;&#39; \
+  --output_columns _key,content,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           &quot;_key&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;content&quot;,
+#           &quot;Text&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;The first post!&quot;,
+#         &quot;Welcome! This is my first post!&quot;,
+#         1
+#       ],
+#       [
+#         &quot;Groonga&quot;,
+#         &quot;I started to use groonga. It&#39;s very fast!&quot;,
+#         2
+#       ],
+#       [
+#         &quot;Mroonga&quot;,
+#         &quot;I also started to use mroonga. It&#39;s also very fast! Really fast!&quot;,
+#         1
+#       ],
+#       [
+#         &quot;Good-bye Senna&quot;,
+#         &quot;I migrated all Senna system!&quot;,
+#         1
+#       ],
+#       [
+#         &quot;Good-bye Tritonn&quot;,
+#         &quot;I also migrated all Tritonn system!&quot;,
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
 <p>The <tt class="docutils literal"><span class="pre">adjuster</span></tt> in the <tt class="docutils literal"><span class="pre">select</span></tt> command doesn't have <tt class="docutils literal"><span class="pre">FACTOR</span></tt>. So
 the factor is treated as 1. There is only one record that has
 <tt class="docutils literal"><span class="pre">&quot;groonga&quot;</span></tt> in <tt class="docutils literal"><span class="pre">Entries.content</span></tt> column. So the record that its
@@ -2340,7 +2400,7 @@ the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</spa
 </div>
 </div>
 <div class="section" id="id6">
-<h2>8.3.24.5. 返値<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
+<h2>8.3.25.5. 返値<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
 <p>TODO: write in English and add example.</p>
 <p>以下のようなjson形式で値が返却されます。</p>
 <div class="highlight-none"><div class="highlight"><pre>[[リターンコード, 処理開始時間, 処理時間], [検索結果, ドリルダウン結果]]
@@ -2396,7 +2456,7 @@ the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</spa
 </div></blockquote>
 </div>
 <div class="section" id="see-also">
-<h2>8.3.24.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
+<h2>8.3.25.6. See also<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
 <blockquote>
 <div><ul class="simple">
 <li><a class="reference internal" href="../grn_expr/query_syntax.html"><em>Query syntax</em></a></li>
@@ -2414,76 +2474,76 @@ the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</spa
         <div class="sphinxsidebarwrapper">
   <h3><a href="../../index.html">Table Of Contents</a></h3>
   <ul>
-<li><a class="reference internal" href="#">8.3.24. <tt class="docutils literal"><span class="pre">select</span></tt></a><ul>
-<li><a class="reference internal" href="#summary">8.3.24.1. Summary</a></li>
-<li><a class="reference internal" href="#syntax">8.3.24.2. Syntax</a></li>
-<li><a class="reference internal" href="#usage">8.3.24.3. Usage</a><ul>
-<li><a class="reference internal" href="#simple-usage">8.3.24.3.1. Simple usage</a></li>
-<li><a class="reference internal" href="#search-conditions">8.3.24.3.2. Search conditions</a><ul>
-<li><a class="reference internal" href="#search-condition-query">8.3.24.3.2.1. Search condition: <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
-<li><a class="reference internal" href="#search-condition-filter">8.3.24.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
+<li><a class="reference internal" href="#">8.3.25. <tt class="docutils literal"><span class="pre">select</span></tt></a><ul>
+<li><a class="reference internal" href="#summary">8.3.25.1. Summary</a></li>
+<li><a class="reference internal" href="#syntax">8.3.25.2. Syntax</a></li>
+<li><a class="reference internal" href="#usage">8.3.25.3. Usage</a><ul>
+<li><a class="reference internal" href="#simple-usage">8.3.25.3.1. Simple usage</a></li>
+<li><a class="reference internal" href="#search-conditions">8.3.25.3.2. Search conditions</a><ul>
+<li><a class="reference internal" href="#search-condition-query">8.3.25.3.2.1. Search condition: <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
+<li><a class="reference internal" href="#search-condition-filter">8.3.25.3.2.2. Search condition: <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#paging">8.3.24.3.3. Paging</a></li>
-<li><a class="reference internal" href="#the-total-number-of-records">8.3.24.3.4. The total number of records</a></li>
+<li><a class="reference internal" href="#paging">8.3.25.3.3. Paging</a></li>
+<li><a class="reference internal" href="#the-total-number-of-records">8.3.25.3.4. The total number of records</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#parameters">8.3.24.4. Parameters</a><ul>
-<li><a class="reference internal" href="#required-parameter">8.3.24.4.1. Required parameter</a><ul>
-<li><a class="reference internal" href="#table">8.3.24.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt></a></li>
+<li><a class="reference internal" href="#parameters">8.3.25.4. Parameters</a><ul>
+<li><a class="reference internal" href="#required-parameter">8.3.25.4.1. Required parameter</a><ul>
+<li><a class="reference internal" href="#table">8.3.25.4.1.1. <tt class="docutils literal"><span class="pre">table</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#search-related-parameters">8.3.24.4.2. Search related parameters</a><ul>
-<li><a class="reference internal" href="#match-columns">8.3.24.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt></a></li>
-<li><a class="reference internal" href="#query">8.3.24.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
-<li><a class="reference internal" href="#filter">8.3.24.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
+<li><a class="reference internal" href="#search-related-parameters">8.3.25.4.2. Search related parameters</a><ul>
+<li><a class="reference internal" href="#match-columns">8.3.25.4.2.1. <tt class="docutils literal"><span class="pre">match_columns</span></tt></a></li>
+<li><a class="reference internal" href="#query">8.3.25.4.2.2. <tt class="docutils literal"><span class="pre">query</span></tt></a></li>
+<li><a class="reference internal" href="#filter">8.3.25.4.2.3. <tt class="docutils literal"><span class="pre">filter</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#advanced-search-parameters">8.3.24.4.3. Advanced search parameters</a><ul>
-<li><a class="reference internal" href="#match-escalation-threshold">8.3.24.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt></a></li>
-<li><a class="reference internal" href="#query-expansion">8.3.24.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt></a></li>
-<li><a class="reference internal" href="#query-flags">8.3.24.4.3.3. <tt class="docutils literal"><span class="pre">query_flags</span></tt></a></li>
-<li><a class="reference internal" href="#query-expander">8.3.24.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt></a></li>
+<li><a class="reference internal" href="#advanced-search-parameters">8.3.25.4.3. Advanced search parameters</a><ul>
+<li><a class="reference internal" href="#match-escalation-threshold">8.3.25.4.3.1. <tt class="docutils literal"><span class="pre">match_escalation_threshold</span></tt></a></li>
+<li><a class="reference internal" href="#query-expansion">8.3.25.4.3.2. <tt class="docutils literal"><span class="pre">query_expansion</span></tt></a></li>
+<li><a class="reference internal" href="#query-flags">8.3.25.4.3.3. <tt class="docutils literal"><span class="pre">query_flags</span></tt></a></li>
+<li><a class="reference internal" href="#query-expander">8.3.25.4.3.4. <tt class="docutils literal"><span class="pre">query_expander</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#output-related-parameters">8.3.24.4.4. Output related parameters</a><ul>
-<li><a class="reference internal" href="#output-columns">8.3.24.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt></a></li>
-<li><a class="reference internal" href="#sortby">8.3.24.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt></a></li>
-<li><a class="reference internal" href="#offset">8.3.24.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt></a></li>
-<li><a class="reference internal" href="#limit">8.3.24.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt></a></li>
-<li><a class="reference internal" href="#scorer">8.3.24.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt></a></li>
+<li><a class="reference internal" href="#output-related-parameters">8.3.25.4.4. Output related parameters</a><ul>
+<li><a class="reference internal" href="#output-columns">8.3.25.4.4.1. <tt class="docutils literal"><span class="pre">output_columns</span></tt></a></li>
+<li><a class="reference internal" href="#sortby">8.3.25.4.4.2. <tt class="docutils literal"><span class="pre">sortby</span></tt></a></li>
+<li><a class="reference internal" href="#offset">8.3.25.4.4.3. <tt class="docutils literal"><span class="pre">offset</span></tt></a></li>
+<li><a class="reference internal" href="#limit">8.3.25.4.4.4. <tt class="docutils literal"><span class="pre">limit</span></tt></a></li>
+<li><a class="reference internal" href="#scorer">8.3.25.4.4.5. <tt class="docutils literal"><span class="pre">scorer</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#facet-related-parameters">8.3.24.4.5. Facet related parameters</a><ul>
-<li><a class="reference internal" href="#drilldown">8.3.24.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt></a></li>
-<li><a class="reference internal" href="#drilldown-sortby">8.3.24.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt></a></li>
-<li><a class="reference internal" href="#drilldown-output-columns">8.3.24.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt></a></li>
-<li><a class="reference internal" href="#drilldown-offset">8.3.24.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt></a></li>
-<li><a class="reference internal" href="#drilldown-limit">8.3.24.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt></a></li>
+<li><a class="reference internal" href="#facet-related-parameters">8.3.25.4.5. Facet related parameters</a><ul>
+<li><a class="reference internal" href="#drilldown">8.3.25.4.5.1. <tt class="docutils literal"><span class="pre">drilldown</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-sortby">8.3.25.4.5.2. <tt class="docutils literal"><span class="pre">drilldown_sortby</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-output-columns">8.3.25.4.5.3. <tt class="docutils literal"><span class="pre">drilldown_output_columns</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-offset">8.3.25.4.5.4. <tt class="docutils literal"><span class="pre">drilldown_offset</span></tt></a></li>
+<li><a class="reference internal" href="#drilldown-limit">8.3.25.4.5.5. <tt class="docutils literal"><span class="pre">drilldown_limit</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#cache-related-parameter">8.3.24.4.6. Cache related parameter</a><ul>
-<li><a class="reference internal" href="#cache">8.3.24.4.6.1. <tt class="docutils literal"><span class="pre">cache</span></tt></a></li>
+<li><a class="reference internal" href="#cache-related-parameter">8.3.25.4.6. Cache related parameter</a><ul>
+<li><a class="reference internal" href="#cache">8.3.25.4.6.1. <tt class="docutils literal"><span class="pre">cache</span></tt></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#score-related-parameters">8.3.24.4.7. Score related parameters</a><ul>
-<li><a class="reference internal" href="#adjuster">8.3.24.4.7.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt></a></li>
+<li><a class="reference internal" href="#score-related-parameters">8.3.25.4.7. Score related parameters</a><ul>
+<li><a class="reference internal" href="#adjuster">8.3.25.4.7.1. <tt class="docutils literal"><span class="pre">adjuster</span></tt></a></li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a class="reference internal" href="#id6">8.3.24.5. 返値</a></li>
-<li><a class="reference internal" href="#see-also">8.3.24.6. See also</a></li>
+<li><a class="reference internal" href="#id6">8.3.25.5. 返値</a></li>
+<li><a class="reference internal" href="#see-also">8.3.25.6. See also</a></li>
 </ul>
 </li>
 </ul>
   <h4>Previous topic</h4>
   <p class="topless"><a href="ruby_load.html"
-                        title="previous chapter">8.3.23. <tt class="docutils literal"><span class="pre">ruby_load</span></tt></a></p>
+                        title="previous chapter">8.3.24. <tt class="docutils literal"><span class="pre">ruby_load</span></tt></a></p>
   <h4>Next topic</h4>
   <p class="topless"><a href="shutdown.html"
-                        title="next chapter">8.3.25. shutdown</a></p>
+                        title="next chapter">8.3.26. shutdown</a></p>
   <div role="note" aria-label="source link">
     <h3>This Page</h3>
     <ul class="this-page-menu">
@@ -2515,12 +2575,12 @@ the same <tt class="docutils literal"><span class="pre">&quot;KEYWORD&quot;</spa
           <a href="../../genindex.html" title="General Index"
              >index</a></li>
         <li class="right" >
-          <a href="shutdown.html" title="8.3.25. shutdown"
+          <a href="shutdown.html" title="8.3.26. shutdown"
              >next</a> |</li>
         <li class="right" >
-          <a href="ruby_load.html" title="8.3.23. ruby_load"
+          <a href="ruby_load.html" title="8.3.24. ruby_load"
              >previous</a> |</li>
-        <li><a href="../../index.html">Groonga v4.0.1 documentation</a> &raquo;</li>
+        <li><a href="../../index.html">Groonga v4.0.1-127-g9422d50 documentation</a> &raquo;</li>
           <li><a href="../../reference.html" >8. Reference manual</a> &raquo;</li>
           <li><a href="../command.html" >8.3. Command</a> &raquo;</li>
       </ul>