docs: handle nio.create wrapped functions

doc/neotest.txt

@@ -456,8 +456,7 @@ Debug the current file with nvim-dap
   lua require("neotest").run.run({vim.fn.expand("%"), strategy = "dap"})
 <
 Parameters~
-{args} `(string|neotest.run.RunArgs?)` Position ID to run or args. If args
-then args[1] should be the position ID.
+{args} `(string|neotest.run.RunArgs?)` Position ID to run or args.
 
                                                         *neotest.run.run_last()*
 `run_last`({args})
@@ -521,7 +520,9 @@ Return~
 
 Get last test position ID and args
 Return~
-`(string|nil,neotest.run.RunArgs|nil)` Position id and last args table
+`(string|nil)` position_id
+Return~
+`(neotest.run.RunArgs|nil)` args
 
 
 ==============================================================================
@@ -811,7 +812,7 @@ Return~
 
                                                 *neotest.client.GetPositionArgs*
 Fields~
-{adapter} `(string)` Adapter ID
+{adapter?} `(string)` Adapter ID
 
                                                  *neotest.Client:get_position()*
 `Client:get_position`({position_id}, {args})
@@ -851,7 +852,9 @@ Return~
 Parameters~
 {file_path} `(string)`
 Return~
-`(string,neotest.Adapter)`
+`(string?)`
+Return~
+`(neotest.Adapter?)`
 
 
 ==============================================================================

doc/nio.txt

@@ -52,6 +52,22 @@ argument must be the callback.
 Return~
 `(function)` Returns an async function
 
+                                                                  *nio.create()*
+`create`({func}, {argc})
+
+Takes an async function and returns a function that can run in both async
+and non async contexts. When running in an async context, the function can
+return values, but when run in a non-async context, a Task object is
+returned and an extra callback argument can be supplied to receive the
+result, with the same signature as the callback for `nio.run`.
+
+This is useful for APIs where users don't want to create async
+contexts but which are still used in async contexts internally.
+Parameters~
+{func} `(async fun(...))`
+{argc?} `(integer)` The number of arguments of func. Must be included if there
+are arguments.
+
                                                                   *nio.gather()*
 `gather`({functions})
 
@@ -193,6 +209,7 @@ Fields~
 by the client
 {notify} `(nio.lsp.NotifyClient)` Interface to all notifications that can be
 sent by the client
+{server_capabilities} `(nio.lsp.types.ServerCapabilities)`
 
                                                               *nio.lsp.client()*
 `client`({client_id})

scripts/gendocs.lua

@@ -14,6 +14,7 @@ H.pattern_sets = {
     '^function%s+(%S-)(%b())',             -- Regular definition
     '^local%s+function%s+(%S-)(%b())',     -- Local definition
     '^(%S+)%s*=%s*function(%b())',         -- Regular assignment
+    '^(%S+)%s*=%s*nio.create%(function(%b())',         -- Regular assignment
     '^local%s+(%S+)%s*=%s*function(%b())', -- Local assignment
   },
   -- Determine if line is a general assignment
@@ -678,6 +679,10 @@ end
 local function create_config(module, header)
   return {
     hooks = vim.tbl_extend("force", minidoc.default_hooks, {
+      block_pre = function(b)
+        -- Infer metadata based on afterlines
+        if b:has_lines() and #b.info.afterlines > 0 then H.infer_header(b) end
+      end,
       section_post = function(section)
         for i, line in ipairs(section) do
           if type(line) == "string" then