diff options
| author | Justin M. Keyes <justinkz@gmail.com> | 2024-12-06 10:08:20 -0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-12-06 10:08:20 -0800 |
| commit | ba7370a902abc1ca533f8ebf70f708e16a2a64c2 (patch) | |
| tree | d9f08c1fdb16d8fbbf035ff507b9218309b0d4ba /runtime/doc | |
| parent | e8e3b443f8040329bd833fcc945d5dbf3adb832c (diff) | |
| parent | f0ea38a4bcb37aa6c68d498864c3c83f2867c4ad (diff) | |
| download | rneovim-ba7370a902abc1ca533f8ebf70f708e16a2a64c2.tar.gz rneovim-ba7370a902abc1ca533f8ebf70f708e16a2a64c2.tar.bz2 rneovim-ba7370a902abc1ca533f8ebf70f708e16a2a64c2.zip | |
Merge #30085 #trim! all whitespace
Diffstat (limited to 'runtime/doc')
| -rw-r--r-- | runtime/doc/news.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/treesitter.txt | 27 |
2 files changed, 24 insertions, 5 deletions
diff --git a/runtime/doc/news.txt b/runtime/doc/news.txt index 858a44e62b..8b4b396a26 100644 --- a/runtime/doc/news.txt +++ b/runtime/doc/news.txt @@ -280,6 +280,8 @@ TREESITTER • |LanguageTree:node_for_range()| gets anonymous and named nodes for a range • |vim.treesitter.get_node()| now takes an option `include_anonymous`, default false, which allows it to return anonymous nodes as well as named nodes. +• |treesitter-directive-trim!| can trim all whitespace (not just empty lines) + from both sides of a node. TUI diff --git a/runtime/doc/treesitter.txt b/runtime/doc/treesitter.txt index 5fc6429f7a..877d90a3b7 100644 --- a/runtime/doc/treesitter.txt +++ b/runtime/doc/treesitter.txt @@ -245,15 +245,32 @@ The following directives are built in: (#gsub! @_node ".*%.(.*)" "%1") < `trim!` *treesitter-directive-trim!* - Trim blank lines from the end of the node. This will set a new - `metadata[capture_id].range`. + Trims whitespace from the node. Sets a new + `metadata[capture_id].range`. Takes a capture ID and, optionally, four + integers to customize trimming behavior (`1` meaning trim, `0` meaning + don't trim). When only given a capture ID, trims blank lines (lines + that contain only whitespace, or are empty) from the end of the node + (for backwards compatibility). Can trim all whitespace from both sides + of the node if parameters are given. + Examples: >query + ; only trim blank lines from the end of the node + ; (equivalent to (#trim! @fold 0 0 1 0)) + (#trim! @fold) + + ; trim blank lines from both sides of the node + (#trim! @fold 1 0 1 0) + + ; trim all whitespace around the node + (#trim! @fold 1 1 1 1) +< Parameters: ~ {capture_id} + {trim_start_linewise} + {trim_start_charwise} + {trim_end_linewise} (default `1` if only given {capture_id}) + {trim_end_charwise} - Example: >query - (#trim! @fold) -< Further directives can be added via |vim.treesitter.query.add_directive()|. Use |vim.treesitter.query.list_directives()| to list all available directives. |