run docgen.sh

doc/nvim-lua-guide.txt

@@ -871,6 +871,9 @@ Lua, so autoload functions have to be called with this syntax:
     vim.fn['my#autoload#function']()
 <
 
+The functionality of `vim.fn` is identical to `vim.call`, but allows a
+more Lua-like syntax.
+
 See also:
 - |vim.fn|
 
@@ -880,6 +883,10 @@ Neovim has an extensive library of powerful built-in functions that are
 very useful for plugins. See `:help vim-function` for an alphabetical
 list and `:help function-list` for a list of functions grouped by topic.
 
+Neovim API functions should be used directly through
+`vim.api.{..}`. For example, use `vim.api.nvim_list_uis()` instead of
+`vim.fn.nvim_list_uis`. See `:help api` for information.
+
 Caveats~
 
 Some Vim functions that should return a boolean return `1` or `0`