chore(docs): auto generate docs

Author: cbochs

doc/grapple.nvim.txt

@@ -163,18 +163,20 @@ A **project scope** is determined by means of a
 - `global`: tags are scoped to a global namespace
 - `static`: tags are scoped to neovim’s initial working directory
 - `directory`: tags are scoped to the current working directory
-- `git`: tags are scoped to the current git repository, **fallback**: `static`
 - `lsp`: tags are scoped using the `root_dir` of the current buffer’s attached LSP server, **fallback**: `static`
+- `git`: tags are scoped to the current git repository, **fallback**: `static`
+- `git_branch`: tags are scoped to the current git repository and branch, **fallback**: `static`
 
 
-There are two additional scope resolvers which should be preferred when
+There are three additional scope resolvers which should be preferred when
 creating a **|grapple.nvim-fallback-scope-resolver|**. These resolvers act
 identically to their similarly named counterparts, but do not have default
 fallbacks.
 
 
-- `git_fallback`: the same as `git`, but without a fallback
 - `lsp_fallback`: the same as `lsp`, but without a fallback
+- `git_fallback`: the same as `git`, but without a fallback
+- `git_branch_suffix`: resolves suffix (branch) for `git_branch`
 
 
 It is also possible to create your own **custom scope resolver**. For the
@@ -187,7 +189,7 @@ available scope resolver types, please see the Scope API in
 >
     -- Setup using a builtin scope resolver
     require("grapple").setup({
-        scope = require("grapple").resolvers.static
+        scope = require("grapple").resolvers.git
     })
     
     -- Setup using a custom scope resolver
@@ -498,7 +500,8 @@ Scope API
 
 **`returns`**: |grapple.nvim-`grapple.scoperesolver`|
 
-**`scope_callback`**: |grapple.nvim-`grapple.scopefunction`|
+**`scope_callback`**: |grapple.nvim-`grapple.scopefunction`| |
+|grapple.nvim-`grapple.scopejob`|
 
 **`opts?`**: |grapple.nvim-`grapple.scopeoptions`|
 
@@ -515,6 +518,17 @@ Scope API
     require("grapple.scope").resolver(function()
         return vim.fn.getcwd()
     end, { cache = "DirChanged" })
+    
+    -- Create an scope resolver that asynchronously runs the "echo"
+    -- shell command and uses its output as the resolved scope
+    require("grapple.scope").resolver({
+        command = "echo",
+        args = [ "hello_world" ],
+        cwd = vim.fn.getcwd(),
+        on_exit = function(job, return_value)
+            return job:result()[1]
+        end
+    })
 <