diff --git a/book/src/keymap.md b/book/src/keymap.md
index 2eddf3b0..705c4ab1 100644
--- a/book/src/keymap.md
+++ b/book/src/keymap.md
@@ -38,7 +38,8 @@
 
 | Key | Description |
 |-----|-----------|
-| r   | replace (single character change) |
+| r   | replace with a character |
+| R   | replace with yanked text |
 | i   | Insert before selection |
 | a   | Insert after selection (append) |
 | I   | Insert at the start of the line | 
diff --git a/helix-term/src/keymap.rs b/helix-term/src/keymap.rs
index 0324fd04..a6417cfd 100644
--- a/helix-term/src/keymap.rs
+++ b/helix-term/src/keymap.rs
@@ -11,7 +11,8 @@ use std::collections::HashMap;
 //          W = next WORD
 //          e = end of word
 //          E = end of WORD
-//          r =
+//          r = replace
+//          R = replace with yanked
 //          t = 'till char
 //          y = yank
 //          u = undo