feat(setup)!: remove ensure_install field

Instead, call `require('nvim-treesitter').install( { ... } )` manually.

This gives users full control over how they want to install parsers
(sync, from grammar, limited concurrency) and obviates the need for
calling `setup` for most users.

1 files changed, 10 insertions, 20 deletions

diff --git a/doc/nvim-treesitter.txt b/doc/nvim-treesitter.txt
index b5028768d..f0abcc779 100644
--- a/doc/nvim-treesitter.txt
+++ b/doc/nvim-treesitter.txt
@@ -22,34 +22,24 @@ WARNING: This is work in progress and requires the latest commit on Neovim
 ==============================================================================
 QUICK START                                       *nvim-treesitter-quickstart*
 
-Install the parser for your language
-
->vim
-  :TSInstall {language}
-<
-
-To get a list of supported languages
-
->vim
-  :TSInstall <tab>
-<
-
-To install supported parsers and queries, put this in your `init.lua` file:
-
+To configure `nvim-treesitter`, put this in your `init.lua` file:
 >lua
-  require'nvim-treesitter.config'.setup {
+  require'nvim-treesitter'.setup {
     -- A directory to install the parsers and queries to.
     -- Defaults to the `stdpath('data')/site` dir.
     install_dir = "/some/path/to/store/parsers",
-
-    -- A list of parser names, or "stable", "unstable", "unmaintained", "unsupported"
-    ensure_install = { "stable", "rust" },
-
     -- List of parsers to ignore installing (for "stable" etc.)
-    ignore_install = { "javascript" },
+    ignore_install = { "some_parser" },
   }
 
+NOTE: You do not need to call `setup` to use this plugin with the default
+settings!
+
+Parsers and queries can then be installed with >lua
+    require'nvim-treesitter'.install { 'rust', 'javascript', 'zig' }
 <
+(This is a no-op if the parsers are already installed.)
+
 To check installed parsers and queries, use `:checkhealth nvim-treesitter`.
 
 ==============================================================================