--- a/src/doc/user/usermanual.sgml
+++ b/src/doc/user/usermanual.sgml
@@ -24,7 +24,7 @@
Dockes</holder>
</copyright>
- <releaseinfo>$Id: usermanual.sgml,v 1.70 2008-12-02 13:16:29 dockes Exp $</releaseinfo>
+ <releaseinfo>$Id: usermanual.sgml,v 1.71 2008-12-15 09:33:49 dockes Exp $</releaseinfo>
<abstract>
<para>This document introduces full text search notions
@@ -1123,6 +1123,7 @@
<sect1 id="rcl.search.wildcards">
<title>More about wildcards</title>
+
<para>All words entered in &RCL; search fields will be processed
for wildcard expansion before the request is finally
executed.</para>
@@ -1270,6 +1271,9 @@
<sect1 id="rcl.search.tips">
<title>Search tips, shortcuts</title>
+ <sect2 id="rcl.search.tips.terms">
+ <title>Terms and search expansion</title>
+
<formalpara><title>Term completion</title>
<para>Typing <keycap>Esc</keycap> <keycap>Space</keycap> in
the simple search entry field while entering a word will
@@ -1282,6 +1286,13 @@
text</title>
<para>Double-clicking on a word in the result list or in a
preview window will copy it to the simple search entry field.</para>
+ </formalpara>
+
+ <formalpara><title>Wildcards</title>
+ <para>Wildcards can be used inside search terms in all forms
+ of searches. <link linkend="rcl.search.wildcards">
+ More about wildcards</link>.
+ </para>
</formalpara>
<formalpara><title>Disabling stem expansion</title>
@@ -1295,7 +1306,32 @@
stemming language in the preferences.</para>
</formalpara>
- <formalpara><title>Phrases</title>
+ <formalpara><title>Finding related documents</title>
+ <para>Selecting the <guilabel>Find similar documents</guilabel> entry
+ in the result list paragraph right-click menu will select a
+ set of "interesting" terms from the current result, and insert
+ them into the simple search entry field. You can then possibly
+ edit the list and start a search to find documents which may
+ be apparented to the current result.</para>
+ </formalpara>
+
+ <formalpara><title>File names</title>
+ <para>File names are added as terms during indexing, and you can
+ specify them as ordinary terms in normal search fields (&RCL; used
+ to index all directories in the file path as terms. This has been
+ abandoned as it did not seem really useful). Alternatively, you
+ can use the specific file name search which will
+ <emphasis>only</emphasis> look for file names, and may be
+ faster than the generic search especially when using wildcards.</para>
+ </formalpara>
+
+ </sect2>
+
+
+ <sect2 id="rcl.search.tips.phrases">
+ <title>Working with phrases and proximity</title>
+
+ <formalpara><title>Phrases and Proximity searches</title>
<para>A phrase can be looked for by enclosing it in double
quotes. Example: <literal>"user manual"</literal> will look
only for occurrences of <literal>user</literal> immediately
@@ -1306,22 +1342,7 @@
(except <guilabel>This exact phrase</guilabel>).</para>
</formalpara>
- <formalpara><title>Browsing the result list inside a preview
- window (1.5)</title>
- <para>Entering <keycap>Shift-Down</keycap> or <keycap>Shift-Up</keycap>
- (<keycap>Shift</keycap> + an arrow key) in a preview window will
- display the next or the previous document from the result
- list. Any secondary search currently active will be executed on
- the new document.</para>
- </formalpara>
-
- <formalpara><title>Forced opening of a preview window (1.6)</title>
- <para>You can use <keycap>Shift</keycap>+Click on a result list
- <literal>Preview</literal> link to force the creation of a
- preview window instead of a new tab in the existing one.</para>
- </formalpara>
-
- <formalpara><title>AutoPhrases (1.5)</title>
+ <formalpara><title>AutoPhrases</title>
<para>This option can be set in the preferences dialog. If it is
set, a phrase will be automatically built and added to simple
searches when looking for <literal>Any terms</literal>. This
@@ -1333,29 +1354,41 @@
both appear, but those which contain <literal>virtual
reality</literal> should appear sooner in the list.</para>
- <formalpara><title>Finding related documents</title>
- <para>Selecting the <guilabel>Find similar documents</guilabel> entry
- in the result list paragraph right-click menu will select a
- set of "interesting" terms from the current result, and insert
- them into the simple search entry field. You can then possibly
- edit the list and start a search to find documents which may
- be apparented to the current result.</para>
- </formalpara>
-
- <formalpara><title>File names</title>
- <para>File names are added as terms during indexing, and you can
- specify them as ordinary terms in normal search fields (&RCL; used
- to index all directories in the file path as terms. This has been
- abandoned as it did not seem really useful). Alternatively, you
- can use the specific file name search which will
- <emphasis>only</emphasis> look for file names and can use wildcard
- expansion.</para>
+ </sect2>
+
+ <sect2 id="rcl.search.tips.misc">
+ <title>Others</title>
+
+
+ <formalpara><title>Using fields</title>
+ <para>You can use the <link linkend="rcl.search.lang">query
+ language </link> and field specifications
+ to only search certain parts of documents. This can be
+ especially helpful with email, for example only searching
+ emails from a specific originator:
+ <literal>search tips from:helpfulgui</literal>
+ </para>
</formalpara>
<formalpara><title>Query explanation</title>
<para>You can get an exact description of what the query
looked for, including stem expansion, and Boolean operators
used, by clicking on the result list header.</para>
+ </formalpara>
+
+ <formalpara><title>Browsing the result list inside a preview
+ window</title>
+ <para>Entering <keycap>Shift-Down</keycap> or <keycap>Shift-Up</keycap>
+ (<keycap>Shift</keycap> + an arrow key) in a preview window will
+ display the next or the previous document from the result
+ list. Any secondary search currently active will be executed on
+ the new document.</para>
+ </formalpara>
+
+ <formalpara><title>Forced opening of a preview window</title>
+ <para>You can use <keycap>Shift</keycap>+Click on a result list
+ <literal>Preview</literal> link to force the creation of a
+ preview window instead of a new tab in the existing one.</para>
</formalpara>
<formalpara><title>Closing previews</title>
@@ -1369,7 +1402,7 @@
<para>Entering <keycap>^Q</keycap> almost anywhere will
close the application.</para>
</formalpara>
-
+ </sect2>
</sect1>
<sect1 id="rcl.search.custom">