chore: add doc in vim doc, rename toggle_all_off -> disable_all

Author: kyazdani42

doc/nvim-tree-lua.txt

@@ -774,4 +774,35 @@ on_folder_removed({handler})
                     {handler}    (function) Handler function, with the
                                  signature `function(payload)`.
 
+==============================================================================
+MARKS                                                 *nvim-tree-marks*
+
+|nvim-tree.marks|                                     *nvim-tree.marks*
+
+You can toggle marks on file/folders to batch a function on multiple
+nodes with the `marks` module.
+
+>
+  local nvim_tree_marks = require "nvim-tree.marks"
+  local marks = nvim_tree_marks.get_marks()
+<
+
+toggle_mark()                                         *nvim-tree.marks.toggle_mark()*
+
+Toggle a mark on a file or folder under the cursor.
+Mapped to `m` by default.
+
+get_marks()                                           *nvim-tree.marks.get_marks()*
+
+Get the list of current marked files/folders.
+Returns a list of nodes.
+
+disable_all()                                         *nvim-tree.marks.disable_all()*
+
+Remove all marks currently enabled.
+Mapped to `M` by default.
+
+You can highlight |NvimTreeMarkedFile| to override the default highlight
+for files and folders with marks.
+
  vim:tw=78:ts=8:noet:ft=help:norl:

lua/nvim-tree/marks.lua

@@ -42,7 +42,7 @@ local function iterate_toggle_off(node)
   end
 end
 
-function M.toggle_all_off()
+function M.disable_all()
   iterate_toggle_off(lib.Tree)
   if view.win_open() then
     renderer.draw(lib.Tree, true)

lua/nvim-tree/view.lua

@@ -77,7 +77,7 @@ M.View = {
     { key = "q",                            cb = M.nvim_tree_callback("close") },
     { key = "g?",                           cb = M.nvim_tree_callback("toggle_help") },
     { key = 'm',                            cb = ":lua require'nvim-tree.marks'.toggle_mark()<cr>" },
-    { key = 'M',                            cb = ":lua require'nvim-tree.marks'.toggle_all_off()<cr>" },
+    { key = 'M',                            cb = ":lua require'nvim-tree.marks'.disable_all()<cr>" },
   }
 }