From 3991d2ce771d2171b6d46fc84add53bde8328135 Mon Sep 17 00:00:00 2001 From: "Itai Y. Efrat" Date: Sun, 22 Aug 2021 16:46:14 +0300 Subject: [PATCH] docs(vertico): explain how shadow paths work --- modules/completion/vertico/README.org | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/modules/completion/vertico/README.org b/modules/completion/vertico/README.org index 441ff2a56..32621e9ef 100644 --- a/modules/completion/vertico/README.org +++ b/modules/completion/vertico/README.org @@ -18,6 +18,7 @@ - [[#general][General]] - [[#jump-to-files-buffers-or-projects][Jump to files, buffers or projects]] - [[#search][Search]] + - [[#file-path-completion][File Path Completion]] - [[#consult][Consult]] - [[#multiple-candidate-search][Multiple candidate search]] - [[#async-search-commands][Async search commands]] @@ -192,6 +193,14 @@ or the last workspace by typing =0 SPC=. | =SPC s P= | Search another project | | =SPC s s= | Search the current buffer (incrementally) | +*** File Path Completion +Note that Emacs allows you to switch directories with shadow paths, for example +starting at =/foo/bar/baz=, typing =/foo/bar/baz/~/= will switch the searched +path to the home directory. For more information see ~substitute-in-file-name~ +and ~file-name-shadow-mode~. This module will erase the "shadowed" portion of +the path from the minibuffer, so in the previous example the path will be reset +to =~/=. + ** Consult *** Multiple candidate search This module modifies the default keybindings used in