aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThomas Vigouroux <39092278+vigoux@users.noreply.github.com>2020-04-28 14:57:00 +0200
committerGitHub <noreply@github.com>2020-04-28 14:57:00 +0200
commit55320191228b3a440b0d068ea04694faf667dcbc (patch)
tree80d5ecfc1f4fb881d67ca4af4fb7689d86c58f83
parentMerge pull request #32 from kyazdani42/feat/readme-infos (diff)
parentadd vim documentation (diff)
downloadnvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.tar
nvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.tar.gz
nvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.tar.bz2
nvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.tar.lz
nvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.tar.xz
nvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.tar.zst
nvim-treesitter-55320191228b3a440b0d068ea04694faf667dcbc.zip
Merge pull request #33 from kyazdani42/doc/add-documentation
Doc/add documentation
-rw-r--r--doc/nvim-treesitter.txt90
-rw-r--r--doc/tags11
2 files changed, 101 insertions, 0 deletions
diff --git a/doc/nvim-treesitter.txt b/doc/nvim-treesitter.txt
new file mode 100644
index 000000000..798c5bfc1
--- /dev/null
+++ b/doc/nvim-treesitter.txt
@@ -0,0 +1,90 @@
+*nvim-treesitter*
+
+Minimum version of neovim: nightly
+
+Authors: Yazdani Kiyan <yazdani.kiyan@protonmail.com>, Vigouroux Thomas <tomvig38@gmail.com>
+
+==============================================================================
+INTRODUCTION *nvim-treesitter-intro*
+
+nvim-treesitter wraps the neovim treesitter api to provide functionnalities such
+as highlighting and incremental selection, and a command to easily install parsers.
+
+==============================================================================
+QUICK START *nvim-treesitter-quickstart*
+
+Install the parser for your language
+
+>
+ :TSInstall {language}
+<
+
+To get a list of supported languages
+
+>
+ :TSInstallInfo
+<
+
+By default, everything is disabled. To enable support for features, in your `init.vim`:
+
+>
+ 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
+ }
+ }
+ }
+<
+
+==============================================================================
+COMMANDS *nvim-treesitter-commands*
+
+|:TSInstall| {language} *:TSInstall*
+
+Download, compile and install a parser for {language}
+
+|:TSInstallInfo| *:TSInstallInfo*
+
+List informations about currently installed parsers
+
+|:TSBufEnable| {module} *:TSBufEnable*
+
+Enable {module} on the current buffer.
+A list of modules can be found at |:TSModuleInfo|
+
+|:TSBufDisable| {module} *:TSBufDisable*
+
+Disable {module} on the current buffer
+A list of modules can be found at |:TSModuleInfo|
+
+|:TSBufEnableAll| {module} [{language}] *:TSBufEnableAll*
+
+Enable {module} for the session
+if {language} is specified, enable module for the session only for this
+particular language.
+A list of modules can be found at |:TSModuleInfo|
+A list of languages can be found at |:TSInstallInfo|
+
+|:TSBufDisableAll| {module} [{language}] *:TSBufDisableAll*
+
+Disable {module} for the session
+if {language} is specified, disable module for the session only for this
+particular language.
+A list of modules can be found at |:TSModuleInfo|
+A list of languages can be found at |:TSInstallInfo|
+
+|:TSModuleInfo| [{module}] *:TSModuleInfo*
+
+List modules state for the current session.
+
+ vim:tw=78:ts=8:noet:ft=help:norl:
+
diff --git a/doc/tags b/doc/tags
new file mode 100644
index 000000000..7d69206e3
--- /dev/null
+++ b/doc/tags
@@ -0,0 +1,11 @@
+:TSBufDisable nvim-treesitter.txt /*:TSBufDisable*
+:TSBufDisableAll nvim-treesitter.txt /*:TSBufDisableAll*
+:TSBufEnable nvim-treesitter.txt /*:TSBufEnable*
+:TSBufEnableAll nvim-treesitter.txt /*:TSBufEnableAll*
+:TSInstall nvim-treesitter.txt /*:TSInstall*
+:TSInstallInfo nvim-treesitter.txt /*:TSInstallInfo*
+:TSModuleInfo nvim-treesitter.txt /*:TSModuleInfo*
+nvim-treesitter nvim-treesitter.txt /*nvim-treesitter*
+nvim-treesitter-commands nvim-treesitter.txt /*nvim-treesitter-commands*
+nvim-treesitter-intro nvim-treesitter.txt /*nvim-treesitter-intro*
+nvim-treesitter-quickstart nvim-treesitter.txt /*nvim-treesitter-quickstart*