Doc: described the split adv search dialog

This commit is contained in:
"Jean-Francois Dockes ext:(%22) 2012-03-13 15:50:38 +01:00
parent e405dca7b5
commit 8f61afe815

View File

@ -1050,12 +1050,35 @@ fvwm
through the <guilabel>Tools</guilabel> menu or through the main through the <guilabel>Tools</guilabel> menu or through the main
toolbar.</para> toolbar.</para>
<para>The dialog has four sections:</para> <para>The dialog has two tabs:</para>
<orderedlist> <orderedlist>
<listitem><para>The top section allows constructing a query by
combining multiple clauses of different types. <listitem><para>The first tab lets you specify terms to search
Each entry field is configurable for the following modes:</para> for, and permits specifying multiple clauses which are combined
to build the search.</para>
</listitem>
<listitem><para>The second tab lets filter the results according
to file size, date of modification, mime type, or
location.</para>
</listitem>
</orderedlist>
<para>Click on the <guilabel>Start Search</guilabel> button in
the advanced search dialog, or type <keycap>Enter</keycap> in
any text field to start the search. The button in
the main window always performs a simple search.</para>
<para>Click on the <literal>Show query details</literal> link at
the top of the result page to see the query expansion.</para>
<sect3 id="rcl.search.complex.terms">
<title>Avanced search: the "find" tab</title>
<para>This part of the dialog lets you constructc a query by
combining multiple clauses of different types. Each entry
field is configurable for the following modes:</para>
<itemizedlist> <itemizedlist>
<listitem><para>All terms.</para> <listitem><para>All terms.</para>
@ -1086,9 +1109,44 @@ fvwm
a mix of single words and phrases enclosed in double quotes. a mix of single words and phrases enclosed in double quotes.
Stemming and wildcard expansion will be performed as for simple Stemming and wildcard expansion will be performed as for simple
search. </para> search. </para>
<formalpara><title>Phrases and Proximity searches</title>
<para>These two clauses work in similar ways, with the
difference that proximity searches do not impose an order on the
words. In both cases, an adjustable number (slack) of non-matched words
may be accepted between the searched ones (use the counter on
the left to adjust this count). For phrases, the default count
is zero (exact match). For proximity it is ten (meaning that two search
terms, would be matched if found within a window of twelve
words). Examples: a phrase search for <literal>quick
fox</literal> with a slack of 0 will match <literal>quick
fox</literal> but not <literal>quick brown fox</literal>. With
a slack of 1 it will match the latter, but not <literal>fox
quick</literal>. A proximity search for <literal>quick
fox</literal> with the default slack will match the
latter, and also <literal>a fox is a cunning and quick animal</literal>.
</formalpara>
</sect3>
<sect3 id="rcl.search.complex.filter">
<title>Avanced search: the "filter" tab</title>
<para>This part of the dialog has several sections which allow
filtering the results of a search according to a number of
criteria</para>
<itemizedlist>
<listitem>
<para>The first section allows filtering by dates of last
modification. You can specify both a minimum and a maximum date. The
initial values are set according to the oldest and newest documents
found in the index.</para>
</listitem> </listitem>
<listitem><para>The next section allows filtering the results by <listitem>
<para>The next section allows filtering the results by
file size. There are two entries for minimum and maximum file size. There are two entries for minimum and maximum
size. Enter decimal numbers. You can use suffix multipliers: size. Enter decimal numbers. You can use suffix multipliers:
<literal>k/K</literal>, <literal>m/M</literal>, <literal>k/K</literal>, <literal>m/M</literal>,
@ -1121,32 +1179,9 @@ fvwm
<filename>/dir2/dirA/dirB/someother/myfile2</filename>.</para> <filename>/dir2/dirA/dirB/someother/myfile2</filename>.</para>
</listitem> </listitem>
</orderedlist> </itemizedlist>
</sect3>
<formalpara><title>Phrases and Proximity searches</title>
<para>These two clauses work in similar ways, with the
difference that proximity searches do not impose an order on the
words. In both cases, an adjustable number (slack) of non-matched words
may be accepted between the searched ones (use the counter on
the left to adjust this count). For phrases, the default count
is zero (exact match). For proximity it is ten (meaning that two search
terms, would be matched if found within a window of twelve
words). Examples: a phrase search for <literal>quick
fox</literal> with a slack of 0 will match <literal>quick
fox</literal> but not <literal>quick brown fox</literal>. With
a slack of 1 it will match the latter, but not <literal>fox
quick</literal>. A proximity search for <literal>quick
fox</literal> with the default slack will match the
latter, and also <literal>a fox is a cunning and quick animal</literal>.
</formalpara>
<para>Click on the <guilabel>Start Search</guilabel> button in
the advanced search dialog, or type <keycap>Enter</keycap> in
any text field to start the search. The button in
the main window always performs a simple search.</para>
<para>Click on the <literal>Show query details</literal> link at
the top of the result page to see the query expansion.</para>
</sect2> </sect2>