diff --git a/src/nvim/api/vim.c b/src/nvim/api/vim.c
index ce6e36c6f4..7a99ade579 100644
--- a/src/nvim/api/vim.c
+++ b/src/nvim/api/vim.c
@@ -1358,7 +1358,7 @@ void nvim_set_current_tabpage(Tabpage tabpage, Error *err)
   }
 }
 
-/// Creates a new *namespace*, or gets an existing one.
+/// Creates a new \*namespace\*, or gets an existing one.
 ///
 /// Namespaces are used for buffer highlights and virtual text, see
 /// |nvim_buf_add_highlight()| and |nvim_buf_set_extmark()|.
diff --git a/src/nvim/lua/vim.lua b/src/nvim/lua/vim.lua
index 7a209f2d79..5ca4cc82a5 100644
--- a/src/nvim/lua/vim.lua
+++ b/src/nvim/lua/vim.lua
@@ -433,6 +433,7 @@ function vim.notify(msg, log_level, _opts)
 end
 
 
+---@private
 function vim.register_keystroke_callback()
   error('vim.register_keystroke_callback is deprecated, instead use: vim.on_key')
 end