diff --git a/layers/+tools/lsp/README.org b/layers/+tools/lsp/README.org index 78263f053..4affbe004 100644 --- a/layers/+tools/lsp/README.org +++ b/layers/+tools/lsp/README.org @@ -168,18 +168,19 @@ available in all language layers based on the lsp layer. ** Key binding prefixes The key bindings are grouped under the following prefixes: -| prefix | name | functional area | -|-----------+---------------+----------------------------------------------------------------------------| -| ~SPC m a~ | action | Code actions | -| ~SPC m =~ | format | Source formatting | -| ~SPC m g~ | goto | Source navigation | -| ~SPC m G~ | peek | Source navigation (lsp-ui-peek overlay) | -| ~SPC m F~ | folder | Add/remove folders from workspace | -| ~SPC m h~ | help | Help | -| ~SPC m b~ | lsp/backend | Catchall. Restart LSP backend, other implementation-specific functionality | -| ~SPC m r~ | refactor | What it says on the tin | -| ~SPC m T~ | toggle | Toggle LSP backend features (documentation / symbol info overlays etc.) | -| ~SPC m x~ | text (source) | Text (source) document related bindings | +| prefix | name | functional area | +|-------------+---------------+----------------------------------------------------------------------------| +| ~SPC m a~ | action | Code actions | +| ~SPC m =~ | format | Source formatting | +| ~SPC m g~ | goto | Source navigation | +| ~SPC m G~ | peek | Source navigation (lsp-ui-peek overlay) | +| ~SPC m F~ | folder | Add/remove folders from workspace | +| ~SPC m h~ | help | Help | +| ~SPC m b~ | lsp/backend | Catchall. Restart LSP backend, other implementation-specific functionality | +| ~SPC m r~ | refactor | What it says on the tin | +| ~SPC m T~ | toggle | Toggle mode specific features | +| ~SPC m T l~ | lsp | Toggle LSP backend features (documentation / symbol info overlays etc.) | +| ~SPC m x~ | text (source) | Text (source) document related bindings | Some navigation key bindings (i.e. ~SPC m g~ / ~SPC m G~) use an additional level of grouping: @@ -191,66 +192,66 @@ Some navigation key bindings (i.e. ~SPC m g~ / ~SPC m G~) use an additional leve ** Core key bindings The lsp minor mode bindings are: -| binding | function | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m = b~ | format buffer (=lsp-mode=) | -| ~SPC m = r~ | format region (=lsp-mode=) | -| ~SPC m = o~ | format (organise) imports | -|-------------+----------------------------------------------------------------------------------| -| Note | /The ~f~, ~r~ and ~s~ actions are placeholders for imminent =lsp-mode= features/ | -| ~SPC m a a~ | Execute code action | -| ~SPC m a f~ | Execute fix action | -| ~SPC m a r~ | Execute refactor action | -| ~SPC m a s~ | Execute source action | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m g t~ | goto type-definition (=lsp-mode=) | -| ~SPC m g k~ | goto viewport word (=avy=) (See Note 1) | -| ~SPC m g K~ | goto viewport symbol (=avy=) (See Note 1) | -| ~SPC m g e~ | browse flycheck errors (=lsp-treemacs=) | -| ~SPC m g M~ | browse file symbols (=lsp-ui-imenu=) | -|-------------+----------------------------------------------------------------------------------| -| Note | /Replaced by the lsp-ui-peek equivalents when ~lsp-navigation~ is ~'peek~ / | -| ~SPC m g i~ | find implementations (=lsp-mode=) | -| ~SPC m g d~ | find definitions (=xref= / =lsp-mode=) | -| ~SPC m g r~ | find references (=xref= / =lsp=) | -| ~SPC m g s~ | find symbol in project (=helm-lsp=) | -| ~SPC m g S~ | find symbol in all projects (=helm-lsp=) | -| ~SPC m g p~ | goto previous (~xref-pop-marker-stack~) | -|-------------+----------------------------------------------------------------------------------| -| Note | /Omitted when ~lsp-navigation~ is ~'peek~ or ~'simple~ / | -| | /Bound under ~SPC m g~ rather than ~SPC m G~ when ~lsp-navigation~ == ='peek=/ | -| ~SPC m G i~ | find implementation (=lsp-ui-peek=) | -| ~SPC m G d~ | find definitions (=lsp-ui-peek=) | -| ~SPC m G r~ | find references (=lsp-ui-peek=) | -| ~SPC m G s~ | find workspace symbol (=lsp-ui-peek=) | -| ~SPC m G S~ | goto workspace symbol (~lsp-treemacs-symbols~) | -| ~SPC m G p~ | goto previous (=lsp-ui-peek= stack - see Note 2) | -| ~SPC m G n~ | goto next (=lsp-ui-peek stack= - see Note 2) | -| ~SPC m G E~ | browse flycheck errors (=lsp-ui=) | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m h h~ | describe thing at point | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m b s~ | ~lsp-workspace-shutdown~ | -| ~SPC m b r~ | ~lsp-workspace-restart~ | -| ~SPC m b d~ | ~lsp-describe-session~ | -| ~SPC m b v~ | ~lsp-version~ | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m r r~ | rename | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m T d~ | toggle documentation overlay | -| ~SPC m T F~ | toggle documentation overlay function signature | -| ~SPC m T s~ | toggle symbol info overlay | -| ~SPC m T S~ | toggle symbol info overlay symbol name | -| ~SPC m T I~ | toggle symbol info overlay duplicates | -| ~SPC m T l~ | toggle lenses | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m F r~ | Remove workspace folder | -| ~SPC m F a~ | Add workspace folder | -| ~SPC m F s~ | Switch workspace folder | -|-------------+----------------------------------------------------------------------------------| -| ~SPC m x h~ | Highlight all instances of symbol under point | -| ~SPC m x l~ | Show code lenses | -| ~SPC m x L~ | Hide code lenses | +| binding | function | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m = b~ | format buffer (=lsp-mode=) | +| ~SPC m = r~ | format region (=lsp-mode=) | +| ~SPC m = o~ | format (organise) imports | +|---------------+----------------------------------------------------------------------------------| +| Note | /The ~f~, ~r~ and ~s~ actions are placeholders for imminent =lsp-mode= features/ | +| ~SPC m a a~ | Execute code action | +| ~SPC m a f~ | Execute fix action | +| ~SPC m a r~ | Execute refactor action | +| ~SPC m a s~ | Execute source action | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m g t~ | goto type-definition (=lsp-mode=) | +| ~SPC m g k~ | goto viewport word (=avy=) (See Note 1) | +| ~SPC m g K~ | goto viewport symbol (=avy=) (See Note 1) | +| ~SPC m g e~ | browse flycheck errors (=lsp-treemacs=) | +| ~SPC m g M~ | browse file symbols (=lsp-ui-imenu=) | +|---------------+----------------------------------------------------------------------------------| +| Note | /Replaced by the lsp-ui-peek equivalents when ~lsp-navigation~ is ~'peek~ / | +| ~SPC m g i~ | find implementations (=lsp-mode=) | +| ~SPC m g d~ | find definitions (=xref= / =lsp-mode=) | +| ~SPC m g r~ | find references (=xref= / =lsp=) | +| ~SPC m g s~ | find symbol in project (=helm-lsp=) | +| ~SPC m g S~ | find symbol in all projects (=helm-lsp=) | +| ~SPC m g p~ | goto previous (~xref-pop-marker-stack~) | +|---------------+----------------------------------------------------------------------------------| +| Note | /Omitted when ~lsp-navigation~ is ~'peek~ or ~'simple~ / | +| | /Bound under ~SPC m g~ rather than ~SPC m G~ when ~lsp-navigation~ == ='peek=/ | +| ~SPC m G i~ | find implementation (=lsp-ui-peek=) | +| ~SPC m G d~ | find definitions (=lsp-ui-peek=) | +| ~SPC m G r~ | find references (=lsp-ui-peek=) | +| ~SPC m G s~ | find workspace symbol (=lsp-ui-peek=) | +| ~SPC m G S~ | goto workspace symbol (~lsp-treemacs-symbols~) | +| ~SPC m G p~ | goto previous (=lsp-ui-peek= stack - see Note 2) | +| ~SPC m G n~ | goto next (=lsp-ui-peek stack= - see Note 2) | +| ~SPC m G E~ | browse flycheck errors (=lsp-ui=) | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m h h~ | describe thing at point | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m b s~ | ~lsp-workspace-shutdown~ | +| ~SPC m b r~ | ~lsp-workspace-restart~ | +| ~SPC m b d~ | ~lsp-describe-session~ | +| ~SPC m b v~ | ~lsp-version~ | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m r r~ | rename | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m T l d~ | toggle documentation overlay | +| ~SPC m T l F~ | toggle documentation overlay function signature | +| ~SPC m T l s~ | toggle symbol info overlay | +| ~SPC m T l S~ | toggle symbol info overlay symbol name | +| ~SPC m T l I~ | toggle symbol info overlay duplicates | +| ~SPC m T l l~ | toggle lenses | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m F r~ | Remove workspace folder | +| ~SPC m F a~ | Add workspace folder | +| ~SPC m F s~ | Switch workspace folder | +|---------------+----------------------------------------------------------------------------------| +| ~SPC m x h~ | Highlight all instances of symbol under point | +| ~SPC m x l~ | Show code lenses | +| ~SPC m x L~ | Hide code lenses | Note 1: Your language server may not distinguish between the word and symbol variants of this binding. Note 2: There is a window local jump list dedicated to cross references. diff --git a/layers/+tools/lsp/funcs.el b/layers/+tools/lsp/funcs.el index 6b3d5390a..a61abcc80 100644 --- a/layers/+tools/lsp/funcs.el +++ b/layers/+tools/lsp/funcs.el @@ -11,7 +11,7 @@ (defun spacemacs//setup-lsp-jump-handler () "Set jump handler for LSP with the given MODE." - (add-to-list 'spacemacs-jump-handlers '(lsp-ui-peek-find-definitions :async t))) + (add-to-list 'spacemacs-jump-handlers '(lsp-ui-peek-find-definitions :async t))) ;; Key bindings @@ -68,12 +68,13 @@ "rr" #'lsp-rename ;; toggles "T" "toggle" - "Td" #'lsp-ui-doc-mode - "Ts" #'lsp-ui-sideline-mode - "TF" #'spacemacs/lsp-ui-doc-func - "TS" #'spacemacs/lsp-ui-sideline-symb - "TI" #'spacemacs/lsp-ui-sideline-ignore-duplicate - "Tl" #'lsp-lens-mode + "Tl" "lsp" + "Tld" #'lsp-ui-doc-mode + "Tls" #'lsp-ui-sideline-mode + "TlF" #'spacemacs/lsp-ui-doc-func + "TlS" #'spacemacs/lsp-ui-sideline-symb + "TlI" #'spacemacs/lsp-ui-sideline-ignore-duplicate + "Tll" #'lsp-lens-mode ;; folders "F" "folder" "Fs" #'lsp-workspace-folders-switch