doc

src/doc/user/usermanual.html

@@ -5241,42 +5241,48 @@ fs.inotify.max_user_watches=32768
         target="_top">man page</a>. The Usage string follows:</p>
         <pre class="programlisting">
 recollq: usage:
- -P: Show the date span for all the documents present in the index
+ -P: Show the date span for all the documents present in the index.
  [-o|-a|-f] [-q] &lt;query string&gt;
  Runs a recoll query and displays result lines. 
-  Default: will interpret the argument(s) as a xesam query string
+  Default: will interpret the argument(s) as a xesam query string.
   Query elements: 
    * Implicit AND, exclusion, field spec:  t1 -t2 title:t3
    * OR has priority: t1 OR t2 t3 OR t4 means (t1 OR t2) AND (t3 OR t4)
    * Phrase: "t1 t2" (needs additional quoting on cmd line)
- -o Emulate the GUI simple search in ANY TERM mode
- -a Emulate the GUI simple search in ALL TERMS mode
- -f Emulate the GUI simple search in filename mode
- -q is just ignored (compatibility with the recoll GUI command line)
+ -o Emulate the GUI simple search in ANY TERM mode.
+ -a Emulate the GUI simple search in ALL TERMS mode.
+ -f Emulate the GUI simple search in filename mode.
+ -q is just ignored (compatibility with the recoll GUI command line).
 Common options:
- -c &lt;configdir&gt; : specify config directory, overriding $RECOLL_CONFDIR
- -d also dump file contents
+ -c &lt;configdir&gt; : specify config directory, overriding $RECOLL_CONFDIR.
+ -C : collapse duplicates
+ -d also dump file contents.
  -n [first-]&lt;cnt&gt; define the result slice. The default value for [first]
     is 0. Without the option, the default max count is 2000.
-    Use n=0 for no limit
- -b : basic. Just output urls, no mime types or titles
- -Q : no result lines, just the processed query and result count
- -m : dump the whole document meta[] array for each result
- -A : output the document abstracts
- -S fld : sort by field &lt;fld&gt;
-   -D : sort descending
- -s stemlang : set stemming language to use (must exist in index...)
-    Use -s "" to turn off stem expansion
- -T &lt;synonyms file&gt;: use the parameter (Thesaurus) for word expansion 
- -i &lt;dbdir&gt; : additional index, several can be given
- -e use url encoding (%xx) for urls
+    Use n=0 for no limit.
+ -b : basic. Just output urls, no mime types or titles.
+ -Q : no result lines, just the processed query and result count.
+ -m : dump the whole document meta[] array for each result.
+ -A : output the document abstracts.
+    -p &lt;cnt&gt; : show &lt;cnt&gt; snippets, with page numbers instead of the concatenated abstract.
+    -g &lt;cnt&gt; : show &lt;cnt&gt; snippets, with line numbers instead of the concatenated abstract.
+ -S fld : sort by field &lt;fld&gt;.
+   -D : sort descending.
+ -s stemlang : set stemming language to use (must exist in index...).
+    Use -s "" to turn off stem expansion.
+ -T &lt;synonyms file&gt;: use the parameter (Thesaurus) for word expansion.
+ -i &lt;dbdir&gt; : additional index, several can be given.
+ -e use url encoding (%xx) for urls.
+ -E use exact result count instead of lower bound estimate.
  -F &lt;field name list&gt; : output exactly these fields for each result.
     The field values are encoded in base64, output in one line and 
     separated by one space character. This is the recommended format 
     for use by other programs. Use a normal query with option -m to 
     see the field names. Use -F '' to output all fields, but you probably
-    also want option -N in this case
-  -N : with -F, print the (plain text) field names before the field values
+    also want option -N in this case.
+   -N : with -F, print the (plain text) field names before the field values.
+ --extract_to &lt;filepath&gt; : extract the first result to filepath, which must not exist.
+      Use a -n option with an offset to select the appropriate result.
       </pre>
         <p>Sample execution:</p>
         <pre class="programlisting">