From 8f61afe81524044e7da0fd1286e692dc772e7e26 Mon Sep 17 00:00:00 2001 From: "\"Jean-Francois Dockes ext:(%22)" Date: Tue, 13 Mar 2012 15:50:38 +0100 Subject: [PATCH] Doc: described the split adv search dialog --- src/doc/user/usermanual.sgml | 131 ++++++++++++++++++++++------------- 1 file changed, 83 insertions(+), 48 deletions(-) diff --git a/src/doc/user/usermanual.sgml b/src/doc/user/usermanual.sgml index 2d1a2271..20cb648c 100644 --- a/src/doc/user/usermanual.sgml +++ b/src/doc/user/usermanual.sgml @@ -1050,12 +1050,35 @@ fvwm through the Tools menu or through the main toolbar. - The dialog has four sections: - + The dialog has two tabs: - The top section allows constructing a query by - combining multiple clauses of different types. - Each entry field is configurable for the following modes: + + The first tab lets you specify terms to search + for, and permits specifying multiple clauses which are combined + to build the search. + + + The second tab lets filter the results according + to file size, date of modification, mime type, or + location. + + + + + Click on the Start Search button in + the advanced search dialog, or type Enter in + any text field to start the search. The button in + the main window always performs a simple search. + + Click on the Show query details link at + the top of the result page to see the query expansion. + + + Avanced search: the "find" tab + + 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: All terms. @@ -1086,43 +1109,6 @@ fvwm a mix of single words and phrases enclosed in double quotes. Stemming and wildcard expansion will be performed as for simple search. - - - The next section allows filtering the results by - file size. There are two entries for minimum and maximum - size. Enter decimal numbers. You can use suffix multipliers: - k/K, m/M, - g/G, t/T for 1E3, 1E6, - 1E9, 1E12 respectively. - - - - The next section allows filtering the results by their mime - types, or mime categories (ie: media/text/message/etc.). - You can transfer the types between two boxes, to define - which will be included or excluded by the search. - The state of the file type selection can be saved as - the default (the file type filter will not be activated at - program start-up, but the lists will be in the restored - state). - - - - The bottom section allows restricting the search results to a - sub-tree of the indexed area. You can use the - Invert checkbox to search for files not in - the sub-tree instead. If you use directory filtering often and on - big subsets of the file system, you may think of setting up - multiple indexes instead, as the performance may be - better. - You can use relative/partial paths for filtering. Ie, - entering dirA/dirB would match either - /dir1/dirA/dirB/myfile1 or - /dir2/dirA/dirB/someother/myfile2. - - - - Phrases and Proximity searches These two clauses work in similar ways, with the @@ -1141,12 +1127,61 @@ fvwm latter, and also a fox is a cunning and quick animal. - Click on the Start Search button in - the advanced search dialog, or type Enter in - any text field to start the search. The button in - the main window always performs a simple search. - Click on the Show query details link at - the top of the result page to see the query expansion. + + + + Avanced search: the "filter" tab + + This part of the dialog has several sections which allow + filtering the results of a search according to a number of + criteria + + + + + 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. + + + + The next section allows filtering the results by + file size. There are two entries for minimum and maximum + size. Enter decimal numbers. You can use suffix multipliers: + k/K, m/M, + g/G, t/T for 1E3, 1E6, + 1E9, 1E12 respectively. + + + + The next section allows filtering the results by their mime + types, or mime categories (ie: media/text/message/etc.). + You can transfer the types between two boxes, to define + which will be included or excluded by the search. + The state of the file type selection can be saved as + the default (the file type filter will not be activated at + program start-up, but the lists will be in the restored + state). + + + + The bottom section allows restricting the search results to a + sub-tree of the indexed area. You can use the + Invert checkbox to search for files not in + the sub-tree instead. If you use directory filtering often and on + big subsets of the file system, you may think of setting up + multiple indexes instead, as the performance may be + better. + You can use relative/partial paths for filtering. Ie, + entering dirA/dirB would match either + /dir1/dirA/dirB/myfile1 or + /dir2/dirA/dirB/someother/myfile2. + + + + +