From ffcc2221d63aa89665e468be1dd8cd8e40e5f581 Mon Sep 17 00:00:00 2001 From: Simon Hauser Date: Sun, 12 Jun 2022 16:02:21 +0200 Subject: docs: clarify docs around `search_dirs` and `map_entries` --- doc/telescope.txt | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) (limited to 'doc') diff --git a/doc/telescope.txt b/doc/telescope.txt index 7fc66e2..ce171f1 100644 --- a/doc/telescope.txt +++ b/doc/telescope.txt @@ -827,8 +827,8 @@ builtin.live_grep({opts}) *telescope.builtin.live_grep()* {grep_open_files} (boolean) if true, restrict search to open files only, mutually exclusive with `search_dirs` - {search_dirs} (table) directory/directories to search in, - mutually exclusive with + {search_dirs} (table) directory/directories/files to + search, mutually exclusive with `grep_open_files` {glob_pattern} (string) argument to be used with `--glob`, e.g. "*.toml", can use the opposite @@ -855,7 +855,8 @@ builtin.grep_string({opts}) *telescope.builtin.grep_string()* cwd, use utils.buffer_dir() to search relative to open buffer) {search} (string) the query to search - {search_dirs} (table) directory/directories to search in + {search_dirs} (table) directory/directories/files to + search {use_regex} (boolean) if true, special characters won't be escaped, allows for using regex (default: false) @@ -894,8 +895,8 @@ builtin.find_files({opts}) *telescope.builtin.find_files()* {no_ignore_parent} (boolean) show files ignored by .gitignore, .ignore, etc. in parent dirs. (default: false) - {search_dirs} (table) directory/directories to search - in + {search_dirs} (table) directory/directories/files to + search builtin.fd() *telescope.builtin.fd()* @@ -2830,7 +2831,8 @@ Generally used from within other |telescope.actions| utils.map_entries({prompt_bufnr}, {f}) *telescope.actions.utils.map_entries()* Apply `f` to the entries of the current picker. - Notes: - - Mapped entries may include results not visible in the results popup. + - Mapped entries include all currently filtered results, not just the + visible onces. - Indices are 1-indexed, whereas rows are 0-indexed. - Warning: `map_entries` has no return value. - The below example showcases how to collect results -- cgit v1.2.3