docs: lsp, options, api

- revert bogus change to `_meta/builtin_types.lua` from 3a4a66017b

Co-authored-by: David Mejorado <david.mejorado@gmail.com>

runtime/lua/vim/_meta/api.gen.lua

@@ -2204,14 +2204,10 @@ function vim.api.nvim_set_current_win(window) end
 ---   ```
 function vim.api.nvim_set_decoration_provider(ns_id, opts) end
 
---- Sets a highlight group.
+--- Sets a highlight group. By default, replaces the entire definition (e.g. `nvim_set_hl(0, 'Visual', {})`
+--- will clear the "Visual" group), unless `update` is specified.
 ---
 --- Note:
---- Unlike the `:highlight` command which can update a highlight group,
---- this function completely replaces the definition. For example:
---- `nvim_set_hl(0, 'Visual', {})` will clear the highlight group
---- 'Visual'.
----
 --- The fg and bg keys also accept the string values `"fg"` or `"bg"`
 --- which act as aliases to the corresponding foreground and background
 --- values of the Normal group. If the Normal group has not been defined,
@@ -2240,16 +2236,16 @@ function vim.api.nvim_set_decoration_provider(ns_id, opts) end
 --- - ctermfg: Sets foreground of cterm color `ctermfg`
 --- - default: boolean Don't override existing definition `:hi-default`
 --- - dim: boolean
---- - fg: color name or "#RRGGBB", see note.
+--- - fg: Color name or "#RRGGBB", see note.
 --- - fg_indexed: boolean (default false) If true, fg is a terminal palette index (0-255).
---- - force: if true force update the highlight group when it exists.
+--- - force: boolean (default false) Update the highlight group even if it already exists.
 --- - italic: boolean
 --- - link: Name of highlight group to link to. `:hi-link`
---- - link_global: Like "link", but always resolved in the global (ns=0) namespace.
+--- - link_global: Like "link", but always resolved in the global namespace (ns=0).
 --- - nocombine: boolean
 --- - overline: boolean
 --- - reverse: boolean
---- - sp: color name or "#RRGGBB"
+--- - sp: Color name or "#RRGGBB"
 --- - standout: boolean
 --- - strikethrough: boolean
 --- - undercurl: boolean