had tip about searching deeper with ctrl-s in doc

1 files changed, 13 insertions, 0 deletions

diff --git a/website/docs/tricks.md b/website/docs/tricks.md
index b4e001f..2cf585c 100644
--- a/website/docs/tricks.md
+++ b/website/docs/tricks.md
@@ -12,6 +12,19 @@ This function supports most broot arguments:
 
 ![tree with args](img/20201219-tree-with-args.png)
 
+# Search deeper
+
+The search normally stops after some time, or when it found enough matches (that is a few times what can be displayed, in order to only show the ones with the best ranking).
+
+Sometimes, you want a more exhaustive search:
+
+- you want to see **all** matches
+- you want the search to go deeper to find better ranked matches, even if it's slower
+
+Then, you can hit <kbd>ctrl</kbd><kbd>s</kbd>, which does a `:total_search` and ensures the whole tree is searched and all matches are displayed.
+
+The downside is it takes time and the most relevant matches may be hard to find among hundred of less relevant ones which wouldn't be shown otherwise.
+
 # A generic fuzzy finder
 
 The goal here is to have a function you can use in shell to give you a path.