docs: luaref cleanup #24541

- drop "luaref-" prefix in favor of "lua-" or nothing, where possible.
- remove redundant "luaref--lang…" and "luaref-api…" tags.

runtime/lua/vim/_meta/regex.lua

@@ -18,9 +18,9 @@ function vim.regex(re) end
 local regex = {} -- luacheck: no unused
 
 --- Match the string against the regex. If the string should match the regex
---- precisely, surround the regex with `^` and `$`. If the was a match, the
---- byte indices for the beginning and end of the match is returned. When
---- there is no match, `nil` is returned. As any integer is truth-y,
+--- precisely, surround the regex with `^` and `$`. If there was a match, the
+--- byte indices for the beginning and end of the match are returned. When
+--- there is no match, `nil` is returned. Because any integer is "truthy",
 --- `regex:match()` can be directly used as a condition in an if-statement.
 --- @param str string
 function regex:match_str(str) end

runtime/lua/vim/shared.lua

@@ -80,7 +80,7 @@ end
 ---
 --- @see |string.gmatch()|
 --- @see |vim.split()|
---- @see |luaref-patterns|
+--- @see |lua-patterns|
 --- @see https://www.lua.org/pil/20.2.html
 --- @see http://lua-users.org/wiki/StringLibraryTutorial
 ---
@@ -660,7 +660,7 @@ end
 
 --- Trim whitespace (Lua pattern "%s") from both sides of a string.
 ---
----@see |luaref-patterns|
+---@see |lua-patterns|
 ---@see https://www.lua.org/pil/20.2.html
 ---@param s string String to trim
 ---@return string String with whitespace removed from its beginning and end