diff --git a/README.md b/README.md
index 018edc4..502e166 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,5 @@
# telescope.nvim
+
[](https://gitter.im/nvim-telescope/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
Gaze deeply into unknown regions using the power of the moon.
@@ -6,12 +7,13 @@ Gaze deeply into unknown regions using the power of the moon.
## What Is Telescope?
`telescope.nvim` is a highly extendable fuzzy finder over lists. Built on the latest
-awesome features from `neovim` core. Telescope is centered around
-modularity, allowing for easy customization.
+awesome features from `neovim` core. Telescope is centered around modularity,
+allowing for easy customization.
Community driven built-in [pickers](#pickers), [sorters](#sorters) and [previewers](#previewers).
### Built-in Support:
+
- [Vim](#vim-pickers)
- [Files](#file-pickers)
- [Git](#git-pickers)
@@ -21,11 +23,11 @@ Community driven built-in [pickers](#pickers), [sorters](#sorters) and [previewe

For more showcases of Telescope, please visit the [Showcase section](https://github.com/nvim-telescope/telescope.nvim/wiki/Showcase) in the Telescope Wiki
-
## Telescope Table of Contents
+
- [Getting Started](#getting-started)
- [Usage](#usage)
- [Customization](#customization)
@@ -44,12 +46,13 @@ Community driven built-in [pickers](#pickers), [sorters](#sorters) and [previewe
## Getting Started
-This section should guide to run your first built-in pickers :smile:.
+This section should guide you to run your first built-in pickers :smile:.
[Neovim (v0.5)](https://github.com/neovim/neovim/releases/tag/v0.5.0) or newer
is required for `telescope.nvim` to work.
-### Optional dependences
+### Optional dependencies
+
- [sharkdp/bat](https://github.com/sharkdp/bat) (preview)
- [sharkdp/fd](https://github.com/sharkdp/fd) (finder)
- [BurntSushi/ripgrep](https://github.com/BurntSushi/ripgrep) (finder)
@@ -96,35 +99,32 @@ nnoremap fg Telescope live_grep
nnoremap fb Telescope buffers
nnoremap fh Telescope help_tags
-" Using lua functions
+" Using Lua functions
nnoremap ff lua require('telescope.builtin').find_files()
nnoremap fg lua require('telescope.builtin').live_grep()
nnoremap fb lua require('telescope.builtin').buffers()
nnoremap fh lua require('telescope.builtin').help_tags()
```
-See [built-in pickers](#pickers) for the list of all built-in
-functions.
-
+See [built-in pickers](#pickers) for a list of all built-in functions.
## Customization
This section should help you explore available options to configure and
customize your `telescope.nvim`.
-Unlike most vim plugins, `telescope.nvim` can be customized either by applying
-customizations globally or individual per picker.
+Unlike most vim plugins, `telescope.nvim` can be customized by either applying
+customizations globally, or individually per picker.
- **Global Customization** affecting all pickers can be done through the
main `setup()` method (see defaults below)
-- **Individual Customization** affecting a single picker through passing `opts`
+- **Individual Customization** affecting a single picker by passing `opts`
built-in pickers (e.g. `builtin.fd(opts)`) see [Configuration recipes](https://github.com/nvim-telescope/telescope.nvim/wiki/Configuration-Recipes) wiki page for ideas.
-
### Telescope Defaults
As an example of using the `setup()` method, the following code configures
-`telescope.nvim` to its default settings.
+`telescope.nvim` to its default settings:
```lua
require('telescope').setup{
@@ -189,45 +189,46 @@ EOF
### Options affecting Presentation
-| Keys | Description | Options |
-|------------------------|-------------------------------------------------------|----------------------------|
-| `prompt_prefix` | What should the prompt prefix be. | string |
-| `selection_caret` | What should the selection caret be. | string |
-| `entry_prefix` | What should be shown in front of every entry. (current selection excluded) | string|
-| `initial_mode` | The initial mode when a prompt is opened. | insert/normal |
+| Keys | Description | Options |
+|------------------------|-------------------------------------------------------|-----------------------------|
+| `prompt_prefix` | What should the prompt prefix be. | string |
+| `selection_caret` | What should the selection caret be. | string |
+| `entry_prefix` | What should be shown in front of every entry. (current selection excluded) | string |
+| `initial_mode` | The initial mode when a prompt is opened. | insert/normal |
| `layout_strategy` | How the telescope is drawn. | [supported layouts](https://github.com/nvim-telescope/telescope.nvim/wiki/Layouts) |
| `layout_config` | Extra settings for fine-tuning how your layout looks | [supported settings](https://github.com/nvim-telescope/telescope.nvim/wiki/Layouts#layout-defaults) |
-| `sorting_strategy` | Where first selection should be located. | descending/ascending |
-| `scroll_strategy` | How to behave when the when there are no more item next/prev | cycle, nil |
-| `winblend` | How transparent is the telescope window should be. | number |
-| `borderchars` | The border chars, it gives border telescope window | dict |
-| `color_devicons` | Whether to color devicons or not | boolean |
-| `use_less` | Whether to use less with bat or less/cat if bat not installed | boolean |
-| `set_env` | Set environment variables for previewer | dict |
+| `sorting_strategy` | Where first selection should be located. | descending/ascending |
+| `scroll_strategy` | How to behave when the when there are no more item next/prev | cycle, nil |
+| `winblend` | How transparent is the telescope window should be. | number |
+| `borderchars` | The border chars, it gives border telescope window | dict |
+| `color_devicons` | Whether to color devicons or not | boolean |
+| `use_less` | Whether to use less with bat or less/cat if bat not installed | boolean |
+| `set_env` | Set environment variables for previewer | dict |
| `path_display` | How file paths are displayed | [supported settings](https://github.com/nvim-telescope/telescope.nvim/wiki/Path-Display-Configuration) |
-| `file_previewer` | What telescope previewer to use for files. | [Previewers](#previewers) |
-| `grep_previewer` | What telescope previewer to use for grep and similar | [Previewers](#previewers) |
-| `qflist_previewer` | What telescope previewer to use for qflist | [Previewers](#previewers) |
+| `file_previewer` | What telescope previewer to use for files. | [Previewers](#previewers) |
+| `grep_previewer` | What telescope previewer to use for grep and similar | [Previewers](#previewers) |
+| `qflist_previewer` | What telescope previewer to use for qflist | [Previewers](#previewers) |
### Options for extension developers
-| Keys | Description | Options |
-|------------------------|-------------------------------------------------------|----------------------------|
-| `buffer_previewer_maker` | How a file gets loaded and which highlighter will be used. Extensions will change it | function |
+
+| Keys | Description | Options |
+|--------------------------|-------------------------------------------------------|----------------------------|
+| `buffer_previewer_maker` | How a file gets loaded and which highlighter will be used. Extensions will change it | function |
### Options affecting Sorting
-| Keys | Description | Options |
-|------------------------|-------------------------------------------------------|----------------------------|
-| `file_sorter` | The sorter for file lists. | [Sorters](#sorters) |
-| `generic_sorter` | The sorter for everything else. | [Sorters](#sorters) |
-| `vimgrep_arguments` | The command line argument for grep search ... TODO. | dict |
-| `selection_strategy` | What happens to the selection if the list changes. | follow/reset/row/closest |
-| `file_ignore_patterns` | Pattern to be ignored `{ "scratch/.*", "%.env" }` | dict |
+| Keys | Description | Options |
+|------------------------|-------------------------------------------------------|--------------------------|
+| `file_sorter` | The sorter for file lists. | [Sorters](#sorters) |
+| `generic_sorter` | The sorter for everything else. | [Sorters](#sorters) |
+| `vimgrep_arguments` | The command-line argument for grep search ... TODO. | dict |
+| `selection_strategy` | What happens to the selection if the list changes. | follow/reset/row/closest |
+| `file_ignore_patterns` | Pattern to be ignored `{ "scratch/.*", "%.env" }` | dict |
### Customize Default Builtin behavior
-You can customize each default builtin behavior by adding the prefered options
+You can customize each default builtin behavior by adding the preferred options
into the table that is passed into `require("telescope").setup()`.
Example:
@@ -246,7 +247,7 @@ require("telescope").setup {
mappings = {
i = {
[""] = require("telescope.actions").delete_buffer,
- -- or right hand side can also be a the name of the action as string
+ -- Right hand side can also be the name of the action as a string
[""] = "delete_buffer",
},
n = {
@@ -259,7 +260,7 @@ require("telescope").setup {
}
},
extensions = {
- -- your extension config goes in here
+ -- Your extension config goes in here
}
}
```
@@ -288,7 +289,9 @@ the `default_mappings` table.
Much like [built-in pickers](#pickers), there are a number of
-[actions](https://github.com/nvim-telescope/telescope.nvim/blob/master/lua/telescope/actions/init.lua) you can pick from to remap your telescope buffer mappings or create a new custom action:
+[actions](https://github.com/nvim-telescope/telescope.nvim/blob/master/lua/telescope/actions/init.lua)
+you can pick from to remap your telescope buffer mappings, or create a new custom action:
+
```lua
-- Built-in actions
@@ -336,7 +339,7 @@ require('telescope').setup{
```
For a [picker](#pickers) specific remapping, it can be done by setting
-its `attach_mappings` key to a function, like this
+its `attach_mappings` key to a function, like so:
```lua
local actions = require('telescope.actions')
@@ -353,7 +356,7 @@ require('telescope.builtin').fd({ -- or new custom picker's attach_mappings fiel
-- Code here
end)
- -- You can also enhance an action with pre and post action which will run before of after an action
+ -- You can also enhance an action with pre and post action, which will run before of after an action
action_set.select:enhance({
pre = function()
-- Will run before actions.select_default
@@ -376,7 +379,7 @@ require('telescope.builtin').fd({ -- or new custom picker's attach_mappings fiel
require'telescope.builtin'.git_branches({ attach_mappings = function(_, map)
map('i', '', actions.git_delete_branch) -- this action already exist
map('n', '', actions.git_delete_branch) -- this action already exist
- -- for more actions look at lua/telescope/actions/init.lua
+ -- For more actions look at lua/telescope/actions/init.lua
return true
end})
```
@@ -405,10 +408,10 @@ Built-in functions. Ready to be bound to any key you like. :smile:
#### Options for builtin.live_grep
-| Keys | Description | Options |
-|------------------------|------------------------------------------------------------------------------------|--------------|
-| `grep_open_files` | Restrict live_grep to currently open files, mutually exclusive with `search_dirs` | boolean |
-| `search_dirs` | List of directories to search in, mutually exclusive with `grep_open_files` | list |
+| Keys | Description | Options |
+|------------------------|------------------------------------------------------------------------------------|---------|
+| `grep_open_files` | Restrict live_grep to currently open files, mutually exclusive with `search_dirs` | boolean |
+| `search_dirs` | List of directories to search in, mutually exclusive with `grep_open_files` | list |
### Vim Pickers
@@ -416,20 +419,20 @@ Built-in functions. Ready to be bound to any key you like. :smile:
|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `builtin.buffers` | Lists open buffers in current neovim instance |
| `builtin.oldfiles` | Lists previously open files |
-| `builtin.commands` | Lists available plugin/user commands and runs them on `` |
+| `builtin.commands` | Lists available plugin/user commands and runs them on `` |
| `builtin.tags` | Lists tags in current directory with tag location file preview (users are required to run ctags -R to generate tags or update when introducing new changes) |
-| `builtin.command_history` | Lists commands that were executed recently, and reruns them on `` |
-| `builtin.search_history` | Lists searches that were executed recently, and reruns them on `` |
-| `builtin.help_tags` | Lists available help tags and opens a new window with the relevant help info on `` |
-| `builtin.man_pages` | Lists manpage entries, opens them in a help window on `` |
+| `builtin.command_history` | Lists commands that were executed recently, and reruns them on `` |
+| `builtin.search_history` | Lists searches that were executed recently, and reruns them on `` |
+| `builtin.help_tags` | Lists available help tags and opens a new window with the relevant help info on `` |
+| `builtin.man_pages` | Lists manpage entries, opens them in a help window on `` |
| `builtin.marks` | Lists vim marks and their value |
-| `builtin.colorscheme` | Lists available colorschemes and applies them on `` |
+| `builtin.colorscheme` | Lists available colorschemes and applies them on `` |
| `builtin.quickfix` | Lists items in the quickfix list |
| `builtin.loclist` | Lists items from the current window's location list |
-| `builtin.vim_options` | Lists vim options, allows you to edit the current value on `` |
-| `builtin.registers` | Lists vim registers, pastes the contents of the register on `` |
-| `builtin.autocommands` | Lists vim autocommands and goes to their declaration on `` |
-| `builtin.spell_suggest` | Lists spelling suggestions for the current word under the cursor, replaces word with selected suggestion on `` |
+| `builtin.vim_options` | Lists vim options, allows you to edit the current value on `` |
+| `builtin.registers` | Lists vim registers, pastes the contents of the register on `` |
+| `builtin.autocommands` | Lists vim autocommands and goes to their declaration on `` |
+| `builtin.spell_suggest` | Lists spelling suggestions for the current word under the cursor, replaces word with selected suggestion on `` |
| `builtin.keymaps` | Lists normal mode keymappings |
| `builtin.filetypes` | Lists all available filetypes |
| `builtin.highlights` | Lists all available highlights |
@@ -444,8 +447,8 @@ Built-in functions. Ready to be bound to any key you like. :smile:
| `builtin.lsp_document_symbols` | Lists LSP document symbols in the current buffer |
| `builtin.lsp_workspace_symbols` | Lists LSP document symbols in the current workspace |
| `builtin.lsp_dynamic_workspace_symbols` | Dynamically Lists LSP for all workspace symbols |
-| `builtin.lsp_code_actions` | Lists any LSP actions for the word under the cursor, that can be triggered with `` |
-| `builtin.lsp_range_code_actions` | Lists any LSP actions for a given range, that can be triggered with `` |
+| `builtin.lsp_code_actions` | Lists any LSP actions for the word under the cursor, that can be triggered with `` |
+| `builtin.lsp_range_code_actions` | Lists any LSP actions for a given range, that can be triggered with `` |
| `builtin.lsp_document_diagnostics` | Lists LSP diagnostics for the current buffer |
| `builtin.lsp_workspace_diagnostics` | Lists LSP diagnostics for the current workspace if supported, otherwise searches in all open buffers |
| `builtin.lsp_implementations` | Goto the implementation of the word under the cursor if there's only one, otherwise show all options in Telescope |
@@ -457,32 +460,32 @@ For the `*_symbols` and `*_diagnostics` LSP pickers, there is a special filterin
search. When in insert mode while the picker is open, type `:` and then press `` to get an autocomplete menu
filled with all of the possible filters you can use.
-i.e. while using the `lsp_document_symbols` picker, adding `:methods:` to your query filters out any document
-document symbols that are not recognized as methods by treesitter.
+I.e. while using the `lsp_document_symbols` picker, adding `:methods:` to your query filters out any
+document symbols not recognized as methods by treesitter.
### Git Pickers
-| Functions | Description |
-|-------------------------------------|---------------------------------------------------------------------------------------------------------------|
-| `builtin.git_commits` | Lists git commits with diff preview and on enter checkout the commit. |
-| `builtin.git_bcommits` | Lists buffer's git commits with diff preview and checkouts it out on enter. |
-| `builtin.git_branches` | Lists all branches with log preview, checkout action ``, track action `` and rebase action`` |
-| `builtin.git_status` | Lists current changes per file with diff preview and add action. (Multi-selection still WIP) |
-| `builtin.git_stash` | Lists stash items in current repository with ability to apply them on `` |
+| Functions | Description |
+|-------------------------------------|------------------------------------------------------------------------------------------------------------|
+| `builtin.git_commits` | Lists git commits with diff preview and checks them out on `` |
+| `builtin.git_bcommits` | Lists buffer's git commits with diff preview and checks them out on `` |
+| `builtin.git_branches` | Lists all branches with log preview, checkout action ``, track action `` and rebase action`` |
+| `builtin.git_status` | Lists current changes per file with diff preview and add action. (Multi-selection still WIP) |
+| `builtin.git_stash` | Lists stash items in current repository with ability to apply them on `` |
### Treesitter Picker
-| Functions | Description |
-|-------------------------------------|---------------------------------------------------------------------------------------------|
-| `builtin.treesitter` | Lists Function names, variables, from Treesitter! |
+| Functions | Description |
+|-------------------------------------|---------------------------------------------------|
+| `builtin.treesitter` | Lists Function names, variables, from Treesitter! |
### Lists Picker
| Functions | Description |
|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `builtin.planets` | Use the telescope... |
-| `builtin.builtin` | Lists Built-in pickers and run them on enter. |
-| `builtin.reloader` | Lists lua modules and reload them on enter. |
+| `builtin.builtin` | Lists Built-in pickers and run them on ``. |
+| `builtin.reloader` | Lists Lua modules and reload them on ``. |
| `builtin.symbols` | Lists symbols inside a file `data/telescope-sources/*.json` found in your rtp. More info and symbol sources can be found [here](https://github.com/nvim-telescope/telescope-symbols.nvim) |
## Previewers
@@ -498,14 +501,15 @@ document symbols that are not recognized as methods by treesitter.
The default previewers are from now on `vim_buffer_` previewers. They use vim buffers for displaying files
and use tree-sitter or regex for file highlighting.
-These previewers are guessing the filetype of the selected file, so there might be cases where it misses,
-thus leading to wrong highlights. This is because we can't determine the filetype in the traditional way
-(we don't do `bufload`. We read the file async with `vim.loop.fs_` and attach only a highlighter), because we can't
-execute autocommands, otherwise the speed of the previewer would slow down considerably.
-If you want to configure more filetypes take a look at
+These previewers are guessing the filetype of the selected file, so there might be cases where they miss,
+leading to wrong highlights. This is because we can't determine the filetype in the traditional way:
+We don't do `bufload` and instead read the file asynchronously with `vim.loop.fs_` and attach only a
+highlighter; otherwise the speed of the previewer would slow down considerably.
+If you want to configure more filetypes, take a look at
[plenary wiki](https://github.com/nvim-lua/plenary.nvim#plenaryfiletype).
-If you want to configure the `vim_buffer_` previewer, e.g. you want the line to wrap do this:
+If you want to configure the `vim_buffer_` previewer (e.g. you want the line to wrap), do this:
+
```vim
autocmd User TelescopePreviewerLoaded setlocal wrap
```
@@ -537,25 +541,27 @@ We have some built in themes but are looking for more cool options.

-| Themes | Description |
-|--------------------------|-----------------------------------------------------------------------|
-| `themes.get_dropdown` | A list like centered list. [dropdown](https://i.imgur.com/SorAcXv.png)|
-| `themes.get_ivy` | Bottom panel overlay. [Ivy #771](https://github.com/nvim-telescope/telescope.nvim/pull/771)|
-
+| Themes | Description |
+|--------------------------|---------------------------------------------------------------------------------------------|
+| `themes.get_dropdown` | A list like centered list. [dropdown](https://i.imgur.com/SorAcXv.png) |
+| `themes.get_ivy` | Bottom panel overlay. [Ivy #771](https://github.com/nvim-telescope/telescope.nvim/pull/771) |
To use a theme, simply append it to a built-in function:
+
```vim
nnoremap f :lua require'telescope.builtin'.find_files(require('telescope.themes').get_dropdown({}))
" Change an option
nnoremap f :lua require'telescope.builtin'.find_files(require('telescope.themes').get_dropdown({ winblend = 10 }))
```
-or use with command:
+
+Or use with a command:
+
```vim
Telescope find_files theme=get_dropdown
```
-Themes should work with every `telescope.builtin` function. If you wish to
-make a theme, check out `lua/telescope/themes.lua`.
+Themes should work with every `telescope.builtin` function. If you wish to make a theme,
+check out `lua/telescope/themes.lua`.
## Autocmds
@@ -566,34 +572,38 @@ Telescope user autocmds:
| `User TelescopeFindPre` | Do it before Telescope creates all the floating windows |
| `User TelescopePreviewerLoaded` | Do it after Telescope previewer window is created |
-
## Extensions
-Telescope provides the capabilities to create & register extensions, which improve telescope in a variety of ways.
+Telescope provides the capabilities to create & register extensions, which improve telescope in a
+variety of ways.
-Some extensions provide integration with external tools, outside of the scope of `builtins`. Others provide performance
-enhancements by using compiled C and interfacing directly with Lua.
+Some extensions provide integration with external tools, outside of the scope of `builtins`.
+Others provide performance enhancements by using compiled C and interfacing directly with Lua.
### Loading extensions
To load an extension, use the `load_extension` function as shown in the example below:
+
```lua
-- This will load fzy_native and have it override the default file sorter
require('telescope').load_extension('fzy_native')
```
-You may skip explicitly loading extensions (they will then be lazy-loaded), but tab completions will not be available right away.
+You may skip explicitly loading extensions (they will then be lazy-loaded), but tab completions will
+not be available right away.
### Accessing pickers from extensions
Pickers from extensions are added to the `:Telescope` command under their respective name.
For example:
+
```viml
" Run the `configurations` picker from nvim-dap
:Telescope dap configurations
```
-They can also be called directly from lua:
+They can also be called directly from Lua:
+
```lua
-- Run the `configurations` picker from nvim-dap
require('telescope').extensions.dap.configurations()
@@ -601,7 +611,7 @@ require('telescope').extensions.dap.configurations()
### Community Extensions
-For a list of community extensions, please consult the wiki: [Extensions](https://github.com/nvim-telescope/telescope.nvim/wiki/Extensions)
+For a list of community extensions, please consult the Wiki: [Extensions](https://github.com/nvim-telescope/telescope.nvim/wiki/Extensions)
## API
@@ -621,8 +631,7 @@ Finder:new{
### Picker
-This section is an overview of how custom pickers can be created any configured.
-
+This section is an overview of how custom pickers can be created and configured.
```lua
-- lua/telescope/pickers.lua
@@ -672,7 +681,8 @@ For more details on available strategies and configuration options,
see `:help telescope.layout`.
Some options for configuring sizes in layouts are "resolvable".
-This means that they can take different forms, and will be interpreted differently according to which form they take.
+This means that they can take different forms, and will be interpreted differently according
+to which form they take.
For example, if we wanted to set the `width` of a picker using the `vertical`
layout strategy to 50% of the screen width, we would specify that width
as `0.5`, but if we wanted to specify the `width` to be exactly 80
@@ -681,11 +691,14 @@ For more details on resolving sizes, see `:help telescope.resolve`.
As an example, if we wanted to specify the layout strategy and width,
but only for this instance, we could do something like:
+
```
:lua require('telescope.builtin').find_files({layout_strategy='vertical',layout_config={width=0.5}})
```
-or if we wanted to change the width for every time we use the `vertical`
+
+If we wanted to change the width for every time we use the `vertical`
layout strategy, we could add the following to our `setup()` call:
+
```
require('telescope').setup({
defaults = {
@@ -701,8 +714,8 @@ require('telescope').setup({
## Vim Commands
-All `telescope.nvim` functions are wrapped in `vim` commands for easy access, its
-supports tab completions and settings options.
+All `telescope.nvim` functions are wrapped in `vim` commands for easy access,
+tab completions and setting options.
```viml
" Show all builtin pickers
@@ -715,8 +728,8 @@ supports tab completions and settings options.
" Setting options
:Telescope find_files prompt_prefix=🔍
-" If option is table type in lua code ,you can use `,` connect each command string eg:
-" find_command,vimgrep_arguments they are both table type. so config it in commandline like
+" If option is table type in Lua code, you can use `,` to connect each command string, e.g.:
+" find_command,vimgrep_arguments are both table type. So configure it on command-line like so:
:Telescope find_files find_command=rg,--ignore,--hidden,--files prompt_prefix=🔍
```
@@ -736,7 +749,7 @@ and some other functions can be easily changed in custom pickers or built-in fun
```lua
--- Disable preview for find files
+-- Disable preview for find_files
nnoremap ff :lua require('telescope.builtin').find_files({previewer = false})
-- Change change prompt prefix for find_files builtin function:
@@ -749,31 +762,30 @@ nnoremap fg :Telescope live_grep prompt_prefix=🔍
There are 10 highlight groups you can play around with in order to meet your needs:
```viml
-highlight TelescopeSelection guifg=#D79921 gui=bold " selected item
-highlight TelescopeSelectionCaret guifg=#CC241D " selection caret
-highlight TelescopeMultiSelection guifg=#928374 " multisections
-highlight TelescopeNormal guibg=#00000 " floating windows created by telescope.
+highlight TelescopeSelection guifg=#D79921 gui=bold " Selected item
+highlight TelescopeSelectionCaret guifg=#CC241D " Selection caret
+highlight TelescopeMultiSelection guifg=#928374 " Multisections
+highlight TelescopeNormal guibg=#00000 " Floating windows created by telescope
-" Border highlight groups.
+" Border highlight groups
highlight TelescopeBorder guifg=#ffffff
highlight TelescopePromptBorder guifg=#ffffff
highlight TelescopeResultsBorder guifg=#ffffff
highlight TelescopePreviewBorder guifg=#ffffff
-" Used for highlighting characters that you match.
+" Highlight characters your input matches
highlight TelescopeMatching guifg=blue
-" Used for the prompt prefix
+" Color the prompt prefix
highlight TelescopePromptPrefix guifg=red
```
-To checkout the default values of the highlight groups, checkout `plugin/telescope.vim`
+To checkout the default values of the highlight groups, check out `plugin/telescope.vim`
### How to add autocmds to telescope prompt ?
`TelescopePrompt` is the prompt Filetype. You can customize the Filetype as you would normally.
-
## Contributing
All contributions are welcome! Just open a pull request.