Add documentation for `node_movement`, rename: `textobj` -> `incremental_selection`

2 files changed, 35 insertions, 14 deletions

diff --git a/README.md b/README.md
index 3903ecb0b..67d90abbc 100644
--- a/README.md
+++ b/README.md
@@ -92,7 +92,7 @@ require'nvim-treesitter.configs'.setup {
         enable = true,                 -- false will disable the whole extension
         disable = { 'c', 'rust' },     -- list of language that will be disabled
     },
-    textobj = {                        -- this enables incremental selection
+    incremental_selection = {             -- this enables incremental selection
         enable = true,
         disable = { 'cpp', 'lua' },
         keymaps = {                       -- mappings for incremental selection (visual mappings)
@@ -100,6 +100,16 @@ require'nvim-treesitter.configs'.setup {
           scope_incremental = "<leader>f" -- "grc" by default
         }
     },
+    node_movement = {                           -- this cursor movement in node hierachy
+        enable = true,
+        disable = { 'cpp', 'rust' },
+        keymaps = {                       -- mappings for node movement (normal mappings)
+          move_up = "<a-k>",              -- default is to move with alt key hold
+          move_down = "<a-j>",
+          move_left = "<a-h>",
+          move_right = "<a-l>",
+        }
+    },
     ensure_installed = 'all' -- one of 'all', 'language', or a list of languages
 }
 EOF
@@ -124,6 +134,7 @@ Some of these features are :
   - [x] Incremental selection
   - [ ] Syntax based code folding
   - [x] Consistent syntax highlighting (the api is not quite stable yet)
+  - [x] Cursor movement in node hierachy
 
 You can find the roadmap [here](https://github.com/nvim-treesitter/nvim-treesitter/projects/1).
 The roadmap and all features of this plugin are open to change, and any suggestion will be highly appreciated!
diff --git a/doc/nvim-treesitter.txt b/doc/nvim-treesitter.txt
index 55ada1596..ceb834be1 100644
--- a/doc/nvim-treesitter.txt
+++ b/doc/nvim-treesitter.txt
@@ -30,19 +30,29 @@ By default, everything is disabled. To enable support for features, in your `ini
 >
   lua <<EOF
   require'nvim-treesitter.configs'.setup {
-      highlight = {
-          enable = true,             -- false will disable the whole extension
-          disable = { 'c', 'rust' }, -- list of language that will be disabled
-      },
-      textobj = {                        -- this enables incremental selection
-          enable = true,
-          disable = { 'cpp', 'lua' },
-          keymaps = {                       -- mappings for visual selection
-            node_incremental = "<leader>e",  -- "grn" by default,
-            scope_incremental = "<leader>f" -- "grc" by default
-          }
-      },
-      ensure_installed = 'all'  -- can be one of 'all', 'language' or {'language1', 'language2' ... }
+    highlight = {
+        enable = true,                 -- false will disable the whole extension
+        disable = { 'c', 'rust' },     -- list of language that will be disabled
+    },
+    incremental_selection = {             -- this enables incremental selection
+        enable = true,
+        disable = { 'cpp', 'lua' },
+        keymaps = {                       -- mappings for incremental selection (visual mappings)
+          node_incremental = "<leader>e", -- "grn" by default,
+          scope_incremental = "<leader>f" -- "grc" by default
+        }
+    },
+    node_movement = {                           -- this cursor movement in node hierachy
+        enable = true,
+        disable = { 'cpp', 'rust' },
+        keymaps = {                       -- mappings for node movement (normal mappings)
+          move_up = "<a-k>",              -- default is to move with alt key hold
+          move_down = "<a-j>",
+          move_left = "<a-h>",
+          move_right = "<a-l>",
+        }
+    },
+    ensure_installed = 'all' -- one of 'all', 'language', or a list of languages
   }
 <