docs: fix help tags for custom commands and mappings (#1061)

Co-authored-by: Chris Seickel <cseickel@gmail.com>

Author: tradiff

README.md

@@ -193,7 +193,7 @@ use {
         },
         -- A list of functions, each representing a global custom command
         -- that will be available in all sources (if not overridden in `opts[source_name].commands`)
-        -- see `:h neo-tree-global-custom-commands`
+        -- see `:h neo-tree-custom-commands-global`
         commands = {},
         window = {
           position = "left",

doc/neo-tree.txt

@@ -9,7 +9,8 @@ Mappings .................... |neo-tree-mappings|
   View Changes .............. |neo-tree-view-changes|
   File Actions .............. |neo-tree-file-actions|
   Filter .................... |neo-tree-filter|
-  Global custom commands .... |neo-tree-custom-commands-global|
+  Custom Mappings ........... |neo-tree-custom-mappings|
+  Custom Commands ........... |neo-tree-custom-commands|
 Configuration ............... |neo-tree-configuration|
   Setup ..................... |neo-tree-setup|
   Source Selector ........... |neo-tree-source-selector|
@@ -427,96 +428,7 @@ section in the default config instead of at the root level, that means it is
 specific to that source and will not work for others.
 
 
-CUSTOM COMMANDS                                       *neo-tree-custom-commands*
-
-If you want to define your own command, you have two options:
-  1. You can define (or override) a command in the `commands` section of the
-  config for each source, then reference that by name in a mapping.
-  2. You can map directly to a function and skip defining a command.
-
-You probably want #2:
->lua
-   require("neo-tree").setup({
-     filesystem = {
-       window = {
-         mappings = {
-           ["?"] = function(state)
-             local node = state.tree:get_node()
-             print(node.name)
-           end
-         }
-       }
-     }
-   })
-<
-..or
->lua
-   local print_me = function(state)
-     local node = state.tree:get_node()
-     print(node.name)
-   end
-
-   require("neo-tree").setup({
-     filesystem = {
-       window = {
-         mappings = {
-           ["?"] = print_me
-         }
-       }
-     }
-   })
-<
-...but if you want #1, here is how that works:
-
->lua
-   require("neo-tree").setup({
-     filesystem = {
-       commands = {
-         print_me = function(state)
-           local node = state.tree:get_node()
-           print(node.name)
-         end
-       },
-       mappings = {
-         ["?"] = "print_me"
-       }
-     }
-   })
-<
-
-GLOBAL CUSTOM COMMANDS                       *neo-tree-custom-commands-global*
-
-You can also have global custom commands that will be added to all available
-sources. If you need it you can then override it in a specific source.
->lua
-   require("neo-tree").setup({
-     commands = {
-       hello = function()            -- define a global "hello world" function
-         print("Hello world")
-       end
-     },
-
-     window = {
-       mappings = {
-         ["<C-c>"] = "hello"
-                    -- define a global mapping to call 'hello' in every source
-       }
-     },
-
-     filesystem = {
-       commands = {
-         -- override implementation of the 'hello' action in filesystem source
-         hello = function()
-           print("Hello inside filesystem")
-         end
-       }
-     }
-   })
-<
-Now when pressing `<C-c>` in 'buffers' or 'git_status' it will print "Hello world",
-but in 'filesystem' it will print "Hello inside filesystem".
-
-CUSTOM MAPPINGS WITH VISUAL MODE
+CUSTOM MAPPINGS WITH VISUAL MODE               *neo-tree-custom-mappings-visual*
 
 If you want to create a mapping that supports visual mode, the way to do that
 is to add a second command where the name is the same as the normal mode
@@ -544,7 +456,7 @@ For example, this is how the built-in `delete` command is defined:
     end
 <
 
-CUSTOM MAPPINGS WITH ARGUMENTS
+CUSTOM MAPPINGS WITH ARGUMENTS               *neo-tree-custom-mappings-args*
 
 If you want to include options for your mappings, such as `nowait`, you can
 set this for all mappings using the `mapping_options` key, or on individual
@@ -594,7 +506,7 @@ assigning it to the `command` key:
 See |:map-arguments| for possible values to include. "buffer" and "nnoremap"
 are enabled by default.
 
-CUSTOM MAPPINGS WITH CONFIG
+CUSTOM MAPPINGS WITH CONFIG               *neo-tree-custom-mappings-config*
 
 Some mappings may accept an optional `config` table to control it's behavior.
 When that is the case, the command is specified using the table syntax, and
@@ -624,6 +536,96 @@ passed to the command function:
       ...
 <
 
+CUSTOM COMMANDS                                       *neo-tree-custom-commands*
+
+If you want to define your own command, you have two options:
+  1. You can define (or override) a command in the `commands` section of the
+  config for each source, then reference that by name in a mapping.
+  2. You can map directly to a function and skip defining a command.
+
+You probably want #2:
+>lua
+   require("neo-tree").setup({
+     filesystem = {
+       window = {
+         mappings = {
+           ["?"] = function(state)
+             local node = state.tree:get_node()
+             print(node.name)
+           end
+         }
+       }
+     }
+   })
+<
+..or
+>lua
+   local print_me = function(state)
+     local node = state.tree:get_node()
+     print(node.name)
+   end
+
+   require("neo-tree").setup({
+     filesystem = {
+       window = {
+         mappings = {
+           ["?"] = print_me
+         }
+       }
+     }
+   })
+<
+...but if you want #1, here is how that works:
+
+>lua
+   require("neo-tree").setup({
+     filesystem = {
+       commands = {
+         print_me = function(state)
+           local node = state.tree:get_node()
+           print(node.name)
+         end
+       },
+       mappings = {
+         ["?"] = "print_me"
+       }
+     }
+   })
+<
+
+GLOBAL CUSTOM COMMANDS                       *neo-tree-custom-commands-global*
+
+You can also have global custom commands that will be added to all available
+sources. If you need it you can then override it in a specific source.
+>lua
+   require("neo-tree").setup({
+     commands = {
+       hello = function()            -- define a global "hello world" function
+         print("Hello world")
+       end
+     },
+
+     window = {
+       mappings = {
+         ["<C-c>"] = "hello"
+                    -- define a global mapping to call 'hello' in every source
+       }
+     },
+
+     filesystem = {
+       commands = {
+         -- override implementation of the 'hello' action in filesystem source
+         hello = function()
+           print("Hello inside filesystem")
+         end
+       }
+     }
+   })
+<
+Now when pressing `<C-c>` in 'buffers' or 'git_status' it will print "Hello world",
+but in 'filesystem' it will print "Hello inside filesystem".
+
+
 ================================================================================
 CONFIGURATION                                                                  ~
 ================================================================================

lua/neo-tree/defaults.lua

@@ -302,7 +302,7 @@ local config = {
   --   end                     |    }                      |        print("Hello world in filesystem")
   -- }                         |  }                        |      end
   --
-  -- see `:h neo-tree-global-custom-commands`
+  -- see `:h neo-tree-custom-commands-global`
   commands = {}, -- A list of functions
 
   window = { -- see https://github.com/MunifTanjim/nui.nvim/tree/main/lua/nui/popup for