From 8f20ea1093ae5bb98f540081b37773fe3c6ed515 Mon Sep 17 00:00:00 2001 From: "Joseph T. Lyons" Date: Mon, 22 Jul 2024 15:10:02 -0400 Subject: [PATCH] Add a section about navigating within multibuffers (#14979) Release Notes: - N/A --- docs/src/multibuffers.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/src/multibuffers.md b/docs/src/multibuffers.md index 65a3a43b05717b..46bfb1d93f7e41 100644 --- a/docs/src/multibuffers.md +++ b/docs/src/multibuffers.md @@ -19,6 +19,12 @@ When in a multibuffer, it is often useful to use multiple cursors to edit every When you want to edit all matches you can select them by running the `editor: Select All Matches` command (`cmd-shift-l` on macOS, `ctrl-shift-l` on Windows/Linux, or `g a` in Vim mode). +## Navigating to the Source File + +While you can easily edit files in a multibuffer, navigating directly to the source file is often beneficial. You can accomplish this by clicking on any of the divider lines between excerpts or by placing your cursor in an excerpt and executing the `editor: open excerpts` command. It’s key to note that if multiple cursors are being used, the command will open the source file positioned under each cursor within the multibuffer. + +Additionally, if you prefer to use the mouse and would like to double-click on an excerpt to open it, you can enable this functionality with the setting: `"double_click_in_multibuffer": "open"`. + ## Project search To start a search run the `pane: Toggle Search` command (`cmd-shift-f` on macOS, `ctrl-shift-f` on Windows/Linux, or `g/` in Vim mode). After the search has completed, the results will be shown in a new multibuffer. There will be one excerpt for each matching line across the whole project.