Merge pull request #26791 from wookayin/gendoc

refactor(gen_vimdoc): general refactoring on vimdoc generation

runtime/lua/vim/_meta/api.lua

@@ -73,6 +73,9 @@ function vim.api.nvim__id_dictionary(dct) end
 function vim.api.nvim__id_float(flt) end
 
 --- @private
+--- NB: if your UI doesn't use hlstate, this will not return hlstate first
+--- time.
+---
 --- @param grid integer
 --- @param row integer
 --- @param col integer