@@ -10,6 +10,8 @@ Optional dependencies ........................ |fzf-lua-optional-dependencies|
1010Windows Notes ........................................ | fzf-lua-windows-notes |
1111Usage ........................................................ | fzf-lua-usage |
1212Resume ...................................................... | fzf-lua-resume |
13+ Combining Pickers ................................ | fzf-lua-combining-pickers |
14+ Global Picker ........................................ | fzf-lua-global-picker |
1315Commands .................................................. | fzf-lua-commands |
1416Buffers and Files ................................ | fzf-lua-buffers-and-files |
1517Search ...................................................... | fzf-lua-search |
@@ -205,6 +207,41 @@ Alternatively, resuming work on a specific picker:
205207 > })
206208<
207209
210+
211+
212+ COMBINING PICKERS *fzf-lua-combining-pickers*
213+
214+ Fzf-Lua can combine any of the available pickers into a single display using
215+ the `combine` method, for example file history (oldfiles) and git-files:
216+
217+ >lua
218+ :lua FzfLua.combine({ pickers = "oldfiles;git_files" })
219+ -- or using the `FzfLua` vim command:
220+ :FzfLua combine pickers=oldfiles;git_files
221+ <
222+ [!NOTE] The first picker options determine the options used by the combined
223+ picker, that includes formatters, previewer, path_shorten, etc. To avoid
224+ errors combine only pickers of the same entry types (i.e files)
225+
226+
227+
228+ GLOBAL PICKER *fzf-lua-global-picker*
229+
230+ Fzf-Lua conveniently comes with a VS-Code like picker by default
231+ (customizable) combining files, buffers and LSP symbols:
232+
233+ | Prefix | Behavior |
234+ | ----------- | -----------------------------------|
235+ | `no prefix` | Files |
236+ | `$` | Buffers |
237+ | `@` | LSP Symbols (current buffer) |
238+ | `#` | LSP Symbols (workspace/project) |
239+
240+ >lua
241+ :lua FzfLua.global()
242+ -- or using the `FzfLua` vim command:
243+ :FzfLua global
244+ <
208245**LIST OF AVAILABLE COMMANDS BELOW** 👇
209246
210247
@@ -312,32 +349,34 @@ LSP/DIAGNOSTICS *fzf-lua-lsp/diagnostics*
312349
313350MISC *fzf-lua-misc*
314351
315- | Command | List |
316- | ---------------------- | ------------------------------ |
317- | `resume` | resume last command/query |
318- | `builtin` | fzf-lua builtin commands |
319- | `profiles` | fzf-lua configuration profiles |
320- | `helptags` | help tags |
321- | `manpages` | man pages |
322- | `colorschemes` | color schemes |
323- | `awesome_colorschemes` | Awesome Neovim color schemes |
324- | `highlights` | highlight groups |
325- | `commands` | neovim commands |
326- | `command_history` | command history |
327- | `search_history` | search history |
328- | `marks` | :marks |
329- | `jumps` | :jumps |
330- | `changes` | :changes |
331- | `registers` | :registers |
332- | `tagstack` | :tags |
333- | `autocmds` | :autocmd |
334- | `nvim_options` | neovim options |
335- | `keymaps` | key mappings |
336- | `filetypes` | filetypes |
337- | `menus` | menus |
338- | `spellcheck` | misspelled words in buffer |
339- | `spell_suggest` | spelling suggestions |
340- | `packadd` | :packadd <package> |
352+ | Command | List |
353+ | ---------------------- | --------------------------------------------- |
354+ | `resume` | resume last command/query |
355+ | `builtin` | fzf-lua builtin commands |
356+ | `combine` | combine different fzf-kua pickers |
357+ | `global` | global picker for files,buffers and symbols |
358+ | `profiles` | fzf-lua configuration profiles |
359+ | `helptags` | help tags |
360+ | `manpages` | man pages |
361+ | `colorschemes` | color schemes |
362+ | `awesome_colorschemes` | Awesome Neovim color schemes |
363+ | `highlights` | highlight groups |
364+ | `commands` | neovim commands |
365+ | `command_history` | command history |
366+ | `search_history` | search history |
367+ | `marks` | :marks |
368+ | `jumps` | :jumps |
369+ | `changes` | :changes |
370+ | `registers` | :registers |
371+ | `tagstack` | :tags |
372+ | `autocmds` | :autocmd |
373+ | `nvim_options` | neovim options |
374+ | `keymaps` | key mappings |
375+ | `filetypes` | filetypes |
376+ | `menus` | menus |
377+ | `spellcheck` | misspelled words in buffer |
378+ | `spell_suggest` | spelling suggestions |
379+ | `packadd` | :packadd <package> |
341380
342381
343382
0 commit comments