From 658a21d5ad0f809bbccc4be2f5ae5a0e6e04302c Mon Sep 17 00:00:00 2001
From: dockes <none@none>
Date: Tue, 8 Dec 2009 07:43:25 +0000
Subject: [PATCH] clarify stemming options

---
 src/doc/man/recollindex.1 | 45 +++++++++++++++++++++------------------
 src/doc/man/recollq.1     |  9 ++++++++
 2 files changed, 33 insertions(+), 21 deletions(-)

diff --git a/src/doc/man/recollindex.1 b/src/doc/man/recollindex.1
index 703e5204..1b08c006 100644
--- a/src/doc/man/recollindex.1
+++ b/src/doc/man/recollindex.1
@@ -125,41 +125,44 @@ databases will not be updated.
 will build the stem expansion database for a given language, which may or
 may not be part of the list in the configuration file. If the language is
 not part of the configuration, the stem expansion database will be deleted
-during the next normal run. You can get the list of stemmer names from the
-.B recollindex -m
-command. At the time of this writbng, the following languages
-(abbreviations) are recognized (out of Xapian's stem.h):
-.RS
+at the end of the next normal indexing run. You can get the list of stemmer
+names from the 
+.B recollindex -l
+command. Note that this is mostly for experimental use, the normal way to
+add a stemming language is to set it in the configuration, either by
+editing "recoll.conf" or by using the GUI indexing configuration dialog.
+.br
+At the time of this writing, the following languages
+are recognized (out of Xapian's stem.h):
 .IP \(bu
-danish (da)
+danish
 .IP \(bu
-dutch (nl)
+dutch
 .IP \(bu
-english (en) Martin Porter's 2002 revision of his stemmer
+english Martin Porter's 2002 revision of his stemmer
 .IP \(bu
-english_lovins (lovins) Lovin's stemmer
+english_lovins Lovin's stemmer
 .IP \(bu
-english_porter (porter) Porter's stemmer as described in his 1980 paper
+english_porter Porter's stemmer as described in his 1980 paper
 .IP \(bu
-finnish (fi)
+finnish 
 .IP \(bu
-french (fr)
+french 
 .IP \(bu
-german (de)
+german 
 .IP \(bu
-italian (it)
+italian
 .IP \(bu
-norwegian (no)
+norwegian
 .IP \(bu
-portuguese (pt)
+portuguese
 .IP \(bu
-russian (ru)
+russian
 .IP \(bu
-spanish (es)
+spanish
 .IP \(bu
-swedish (sv)
-.RE
-
+swedish
+.PP
 .B recollindex -S
 will rebuild the phonetic/orthographic index. This feature uses the 
 .B aspell
diff --git a/src/doc/man/recollq.1 b/src/doc/man/recollq.1
index 6a124bd8..5ca5ee9c 100644
--- a/src/doc/man/recollq.1
+++ b/src/doc/man/recollq.1
@@ -27,6 +27,10 @@ recollq \- command line / standard output Recoll query command.
 |
 .B -a
 ]
+[
+.B -s
+<stemming language>
+]
 <query string>
 
 .SH DESCRIPTION
@@ -66,6 +70,11 @@ can be used to set the maximum number of results that should be printed.
 If 
 .B -d
 is set, the text for the result files contents will be dumped to stdout.
+.B -s
+<language>
+selects the word stemming language. The value should match an existing
+stemming database (as set in the configuration or added with recollindex -s).
+
 .SH SEE ALSO
 .PP 
 recollindex(1) recollq(1) recoll.conf(5)