fix: Update documentation about setting custom maps for a picker

1 files changed, 18 insertions, 2 deletions

diff --git a/README.md b/README.md
index 4a3580d..45a505d 100644
--- a/README.md
+++ b/README.md
@@ -184,8 +184,6 @@ To see the full list of mappings, check out `lua/telescope/mappings.lua` and the
 
 To override ALL of the default mappings, you can use the `default_mappings` key in the `setup` table.
 
-To override only SOME of the default mappings, you can use the `mappings` key in the `setup` table.
-
 ```
  To disable a keymap, put [map] = false
 
@@ -226,6 +224,24 @@ require('telescope').setup {
 }
 ```
 
+To override only SOME of the default mappings, you can use the `attach_mappings` key in the `setup` table. For example:
+
+```lua
+function my_custom_picker(results)
+  pickers.new(opts, {
+    prompt_title = 'Custom Picker',
+    finder = finders.new_table(results),
+    sorter = sorters.fuzzy_with_index_bias(),
+    attach_mappings = function(_, map)
+      -- Map "<CR>" in insert mode to the funciton, actions.set_command_line
+      map('i', '<CR>', actions.set_command_line)
+
+      return true
+    end,
+  }):find()
+end
+```
+
 Additionally, the prompt's filetype will be `TelescopePrompt`. You can customize the filetype as you would normally.
 
 ## Status (Unstable API)