doc(#2934): use injected gen_vimdoc.lua from nvim source, move decorators to main help

Author: alex-courtis

doc/decorator.txt

@@ -45,6 +45,7 @@ CONTENTS                                                           *nvim-tree*
   6.8  API Config                               |nvim-tree-api.config|
   6.9  API Commands                             |nvim-tree-api.commands|
   6.10 API Diagnostics                          |nvim-tree-api.diagnostics|
+  6.11 API Decorator                            |nvim-tree-api.decorator|
   7. Mappings                                 |nvim-tree-mappings|
   7.1  Mappings: Default                        |nvim-tree-mappings-default|
   8. Highlight                                |nvim-tree-highlight|
@@ -949,6 +950,7 @@ Whether to show the destination of the symlink.
 Highlighting and icons for the nodes, in increasing order of precedence.
 Uses strings to specify builtin decorators otherwise specify your
 `nvim_tree.api.decorator.UserDecorator` class.
+See |nvim-tree-decorators|, |nvim-tree-api.decorator|
   Type: `nvim_tree.api.decorator.Name[]`, Default: >lua
     {
       "Git",
@@ -2955,13 +2957,13 @@ Decorators may:
 - Set highlight group for the name or icons
 - Override node icon
 
+See |nvim-tree-api.decorator|
+
 Create a `nvim_tree.api.decorator.UserDecorator` class and register it with
 precedence via |nvim-tree.renderer.decorators|
 
 See |nvim-tree-decorator-example|
 
-See `nvim-tree/_meta/api_decorator.lua` for full class documentation.
-
 ==============================================================================
  11.1. DECORATOR EXAMPLE                         *nvim-tree-decorator-example*
 
@@ -3444,5 +3446,65 @@ highlight group is not, hard linking as follows: >
 |nvim-tree-api.tree.winid()|
 
 ==============================================================================
+ 6.11 API DECORATOR                                  *nvim-tree-api.decorator*
+
+*nvim_tree.api.decorator.UserDecorator*
+    Custom decorator, see :help nvim-tree-decorators
+
+    Fields: ~
+      • {enabled}          (`boolean`)
+      • {highlight_range}  (`nvim_tree.api.decorator.HighlightRange`)
+      • {icon_placement}   (`nvim_tree.api.decorator.IconPlacement`)
+      • {extend}           (`fun(self: nvim_tree.api.decorator.UserDecorator)`)
+                           See |UserDecorator:extend()|.
+      • {new}              (`fun(self: nvim_tree.api.decorator.UserDecorator)`)
+                           See |UserDecorator:new()|.
+      • {icon_node}        (`fun(self: nvim_tree.api.decorator.UserDecorator, node: nvim_tree.api.Node): nvim_tree.api.HighlightedString?`)
+                           See |UserDecorator:icon_node()|.
+      • {icons}            (`fun(self: nvim_tree.api.decorator.UserDecorator, node: nvim_tree.api.Node): nvim_tree.api.HighlightedString[]?`)
+                           See |UserDecorator:icons()|.
+      • {highlight_group}  (`fun(self: nvim_tree.api.decorator.UserDecorator, node: nvim_tree.api.Node): string?`)
+                           See |UserDecorator:highlight_group()|.
+
+
+UserDecorator:extend()        *nvim_tree.api.decorator.UserDecorator:extend()*
+    Create your decorator class
+
+                     *nvim_tree.api.decorator.UserDecorator:highlight_group()*
+UserDecorator:highlight_group({node})
+    Abstract: optionally implement to provide one highlight group to apply to
+    your highlight_range.
+
+    Parameters: ~
+      • {node}  (`nvim_tree.api.Node`)
+
+    Return: ~
+        (`string?`) highlight_group
+
+                           *nvim_tree.api.decorator.UserDecorator:icon_node()*
+UserDecorator:icon_node({node})
+    Abstract: optionally implement to set the node's icon
+
+    Parameters: ~
+      • {node}  (`nvim_tree.api.Node`)
+
+    Return: ~
+        (`nvim_tree.api.HighlightedString?`) icon_node
+
+                               *nvim_tree.api.decorator.UserDecorator:icons()*
+UserDecorator:icons({node})
+    Abstract: optionally implement to provide icons and the highlight groups
+    for your icon_placement.
+
+    Parameters: ~
+      • {node}  (`nvim_tree.api.Node`)
+
+    Return: ~
+        (`nvim_tree.api.HighlightedString[]?`) icons
+
+UserDecorator:new()              *nvim_tree.api.decorator.UserDecorator:new()*
+    Abstract: no-args constructor must be implemented and will be called once
+    per tree render. Must set all fields.
+
 
- vim:tw=78:ts=4:sw=4:et:ft=help:norl:
+ vim:tw=78:ts=8:sw=4:sts=4:et:ft=help:norl: