From a851ae74f49e00775014386c5406e7d8f6d113ac Mon Sep 17 00:00:00 2001
From: Ryan Roden-Corrent <ryan@rcorre.net>
Date: Wed, 1 May 2024 13:48:48 -0400
Subject: [PATCH 1/2] Add completion/signature bindings to keymap.md

PR #9974 added alt-p/alt-n keybindings to scroll through signatures.
This wasn't very discoverable, as it's not in the docs or the command palette.

This also removes a broken link for "comment mode" in the table of contents.
---
 book/src/keymap.md | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/book/src/keymap.md b/book/src/keymap.md
index 65a223efb08f..64de86275686 100644
--- a/book/src/keymap.md
+++ b/book/src/keymap.md
@@ -12,8 +12,9 @@
     - [Match mode](#match-mode)
     - [Window mode](#window-mode)
     - [Space mode](#space-mode)
-      - [Comment mode](#comment-mode)
       - [Popup](#popup)
+      - [Completion Popup](#completion-popup)
+      - [Signature Popup](#signature-popup)
     - [Unimpaired](#unimpaired)
 - [Insert mode](#insert-mode)
 - [Select / extend mode](#select--extend-mode)
@@ -309,13 +310,31 @@ This layer is a kludge of mappings, mostly pickers.
 
 ##### Popup
 
-Displays documentation for item under cursor.
+Displays documentation for item under cursor. Remapping currently not supported.
 
 | Key      | Description |
 | ----     | ----------- |
 | `Ctrl-u` | Scroll up   |
 | `Ctrl-d` | Scroll down |
 
+##### Completion Popup
+
+Displays documentation for the selected completion item. Remapping currently not supported.
+
+| Key                         | Description    |
+| ----                        | -----------    |
+| `Shift-Tab`, `Ctrl-p`, `Up` | Previous entry |
+| `Tab`, `Ctrl-n`, `Down`     | Next entry     |
+
+##### Signature Popup
+
+Displays the signature of the selected completion item. Remapping currently not supported.
+
+| Key     | Description        |
+| ----    | -----------        |
+| `Alt-p` | Previous signature |
+| `Alt-n` | Next signature     |
+
 #### Unimpaired
 
 These mappings are in the style of [vim-unimpaired](https://github.com/tpope/vim-unimpaired).

From 587ed18ccedafa5f6e905feef97779c992b9fae5 Mon Sep 17 00:00:00 2001
From: Ryan Roden-Corrent <ryan@rcorre.net>
Date: Wed, 1 May 2024 20:40:23 -0400
Subject: [PATCH 2/2] Update keymap.md

---
 book/src/keymap.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/book/src/keymap.md b/book/src/keymap.md
index 64de86275686..55b467a0e691 100644
--- a/book/src/keymap.md
+++ b/book/src/keymap.md
@@ -13,8 +13,8 @@
     - [Window mode](#window-mode)
     - [Space mode](#space-mode)
       - [Popup](#popup)
-      - [Completion Popup](#completion-popup)
-      - [Signature Popup](#signature-popup)
+      - [Completion Menu](#completion-menu)
+      - [Signature-help Popup](#signature-help-popup)
     - [Unimpaired](#unimpaired)
 - [Insert mode](#insert-mode)
 - [Select / extend mode](#select--extend-mode)
@@ -317,7 +317,7 @@ Displays documentation for item under cursor. Remapping currently not supported.
 | `Ctrl-u` | Scroll up   |
 | `Ctrl-d` | Scroll down |
 
-##### Completion Popup
+##### Completion Menu
 
 Displays documentation for the selected completion item. Remapping currently not supported.
 
@@ -326,7 +326,7 @@ Displays documentation for the selected completion item. Remapping currently not
 | `Shift-Tab`, `Ctrl-p`, `Up` | Previous entry |
 | `Tab`, `Ctrl-n`, `Down`     | Next entry     |
 
-##### Signature Popup
+##### Signature-help Popup
 
 Displays the signature of the selected completion item. Remapping currently not supported.