IntenseFinance/neovim
3
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2025-02-25 18:55:25 -06:00
Code Issues Packages Projects Releases Wiki Activity

docs(api): improve section on nvim_set_hl (#17692)

Browse Source
This commit is contained in:
adrian5 2022-03-13 13:42:12 +01:00 committed by GitHub
parent c9b94188d5
commit 9e6bc228ec
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 27 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
runtime/doc/api.txt
View File

@ -1544,23 +1544,21 @@ nvim_set_current_win({window}) *nvim_set_current_win()*
{window} Window handle
nvim_set_hl({ns_id}, {name}, {*val}) *nvim_set_hl()*
Set a highlight group.
Sets a highlight group.
Parameters: ~
{ns_id} number of namespace for this highlight. Use value
0 to set a highlight group in the global (
`:highlight` ) namespace.
{name} highlight group name, like ErrorMsg
{val} highlight definition map, like
|nvim_get_hl_by_name|. in addition the following
keys are also recognized: `default` : don't
override existing definition, like `hi default`
`ctermfg` : sets foreground of cterm color
`ctermbg` : sets background of cterm color
`cterm` : cterm attribute map. sets attributed
for cterm colors. similer to `hi cterm` Note: by
default cterm attributes are same as attributes
of gui color
{ns_id} Namespace id for this highlight |nvim_create_namespace()|.
Use 0 to set a highlight group globally |:highlight|.
{name} Highlight group name, e.g. "ErrorMsg"
{val} Highlight definition map, like |synIDattr()|. In
addition, the following keys are recognized:
• default: Don't override existing definition |:hi-default|
• ctermfg: Sets foreground of cterm color |highlight-ctermfg|
• ctermbg: Sets background of cterm color |highlight-ctermbg|
• cterm: cterm attribute map, like
|highlight-args|.
Note: Attributes default to those set for `gui`
if not set.
nvim_set_keymap({mode}, {lhs}, {rhs}, {*opts}) *nvim_set_keymap()*
Sets a global |mapping| for the given mode.

30
src/nvim/api/vim.c
View File

@ -123,26 +123,24 @@ Dictionary nvim__get_hl_defs(Integer ns_id, Error *err)
abort();
}
/// Set a highlight group.
/// Sets a highlight group.
///
/// Note: unlike the `:highlight` command which can update a highlight group,
/// 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'.
///
/// @param ns_id number of namespace for this highlight. Use value 0
/// to set a highlight group in the global (`:highlight`)
/// namespace.
/// @param name highlight group name, like ErrorMsg
/// @param val highlight definition map, like |nvim_get_hl_by_name|.
/// in addition the following keys are also recognized:
/// `default`: don't override existing definition,
/// like `hi default`
/// `ctermfg`: sets foreground of cterm color
/// `ctermbg`: sets background of cterm color
/// `cterm` : cterm attribute map. sets attributed for
/// cterm colors. similer to `hi cterm`
/// Note: by default cterm attributes are
/// same as attributes of gui color
/// @param ns_id Namespace id for this highlight |nvim_create_namespace()|.
/// Use 0 to set a highlight group globally |:highlight|.
/// @param name Highlight group name, e.g. "ErrorMsg"
/// @param val Highlight definition map, like |synIDattr()|. In
/// addition, the following keys are recognized:
/// - default: Don't override existing definition |:hi-default|
/// - ctermfg: Sets foreground of cterm color |highlight-ctermfg|
/// - ctermbg: Sets background of cterm color |highlight-ctermbg|
/// - cterm: cterm attribute map, like
/// |highlight-args|.
/// Note: Attributes default to those set for `gui`
/// if not set.
/// @param[out] err Error details, if any
///
// TODO(bfredl): val should take update vs reset flag