From e419962abcab3acd162616dd92724afce583d73c Mon Sep 17 00:00:00 2001
From: shenleban tongying <shenlebantongying@gmail.com>
Date: Sat, 1 Jul 2023 11:39:23 -0400
Subject: [PATCH] doc: update fts related strings

---
 src/fulltextsearch.cc             |  2 +-
 src/fulltextsearch.hh             |  2 +-
 src/ui/preferences.ui             |  4 ++--
 website/docs/ui_fulltextsearch.md | 14 ++++++--------
 4 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/src/fulltextsearch.cc b/src/fulltextsearch.cc
index 68766ef2..a2bf68aa 100644
--- a/src/fulltextsearch.cc
+++ b/src/fulltextsearch.cc
@@ -227,7 +227,7 @@ FullTextSearchDialog::FullTextSearchDialog( QWidget * parent,
            this,
            &FullTextSearchDialog::setNewIndexingName );
 
-  ui.searchMode->addItem( tr( "Whole words" ), WholeWords );
+  ui.searchMode->addItem( tr( "Default" ), WholeWords );
   ui.searchMode->addItem( tr( "Plain text"), PlainText );
   ui.searchMode->addItem( tr( "Wildcards" ), Wildcards );
 
diff --git a/src/fulltextsearch.hh b/src/fulltextsearch.hh
index 385c905d..58faaefd 100644
--- a/src/fulltextsearch.hh
+++ b/src/fulltextsearch.hh
@@ -40,7 +40,7 @@ enum {
 
 enum SearchMode
 {
-  WholeWords = 0,
+  WholeWords = 0, // aka Default search using Xapian query syntax
   PlainText,
   Wildcards,
   RegExp
diff --git a/src/ui/preferences.ui b/src/ui/preferences.ui
index 9bfe88c8..883a5cc1 100644
--- a/src/ui/preferences.ui
+++ b/src/ui/preferences.ui
@@ -1299,10 +1299,10 @@ download page.</string>
           <item row="7" column="0">
            <widget class="QCheckBox" name="enablePosition">
             <property name="toolTip">
-             <string>Applies only to new incoming dictionaries.</string>
+             <string>Positional information is required to use Xapian's phrase searching and NEAR operator, but the database size will be much bigger. Applies only to new incoming dictionaries.</string>
             </property>
             <property name="text">
-             <string>Enable positional information in the fulltext</string>
+             <string>Enable index with positional information</string>
             </property>
            </widget>
           </item>
diff --git a/website/docs/ui_fulltextsearch.md b/website/docs/ui_fulltextsearch.md
index ccdbe8e4..a59878e5 100644
--- a/website/docs/ui_fulltextsearch.md
+++ b/website/docs/ui_fulltextsearch.md
@@ -2,21 +2,19 @@ The full-text search dialog can be opened via menu "Search" or "Ctrl+Shift+F".
 
 Full-text search allow to search words or sentences not in dictionary headwords but in articles text of dictionaries from current dictionaries group.
 
-!!! note
-    The dictionary will index for full-text search in background and started immediately after program start, name of the currently indexing dictionary is displayed in the status line. This process can take a long time and require many computing resources.You may turn off indexing for huge dictionaries like Wikipedias or Wiktionaries in preferences. To find dictionary which can't be indexed check GoldenDict with `--log-to-file` or check `stdout`.
-
-
 ![full text serach](img/fulltext.png){ width="450" }
 
 Type the desired word in "Search line" to search.
 
 Search modes
 
-* "Whole words" - This follow the xapian search syntax . check   [query syntax](https://xapian.org/docs/queryparser.html).
+* "Default" — This follows the [xapian search syntax](https://xapian.org/docs/queryparser.html). Note that phrase searching and NEAR operator needs `Enable index with positional information` enabled at settings.
 * "Plain text" - mode like "Whole words" but every word in search line can be treated as word fragment.
-* "Wildcards" - the search line contains a Unix-like template. Such template can contain wildcard symbols `?` (matches any one character), `*` (matches any characters number) or ranges of characters `[...]` To find characters `?`, `*`, `[` and `]` it should be escaped by backslash like `\?`, `\*`, `\[`, `\]`.
+* "Wildcards" - the search line contains a Unix-like template. Such template can contain wildcard symbols `?` (matches any one character), `*` (matches any character number) or ranges of characters `[...]` To find characters `?`, `*`, `[` and `]` it should be escaped by backslash like `\?`, `\*`, `\[`, `\]`.
 
+"Available dictionaries in group" - here you can view how many dictionaries in the current group are suitable for full-text search, how many dictionaries already indexed and how many dictionaries wait for indexing.
 
-"Available dictionaries in group" - here you can view how many dictionaries in current group are suitable for full-text search, how many dictionaries already indexed and how many dictionaries wait for indexing.
+When you place mouse cursor over headword in results list, the tooltip with dictionary list contains such articles matched the search conditions will be shown.
 
-When you place mouse cursor over headword in results list the tooltip with dictionaries list contains such articles matched the search conditions will be shown.
\ No newline at end of file
+!!! note
+    The dictionary will index for full-text search in background and started immediately after program start, name of the currently indexing dictionary is displayed in the status line. This process can take a long time and require many computing resources.You may turn off indexing for huge dictionaries like Wikipedias or Wiktionaries in preferences. To find dictionary which can't be indexed check GoldenDict with `--log-to-file` or check `stdout`.