fix: Fix builtin module doc's invalid syntax

These are kind of pseudo code, but there doesn't seem to be any reason
to use bogus Lua syntax either.

ldoc/builtin/debug.lua

@@ -43,18 +43,18 @@ function debug.gethook(thread) end
 -- with a name for the current function, if a reasonable name can be found,
 -- and the expression `debug.getinfo(print)` returns a table with all available
 -- information about the `print` function.
-function debug.getinfo(thread, function , what) end
+function debug.getinfo(thread, func , what) end
 
 ---
 -- This function returns the name and the value of the local variable with
--- index `local` of the function at level `level` of the stack. (The first
+-- index `loc` of the function at level `level` of the stack. (The first
 -- parameter or local variable has index 1, and so on, until the last active
 -- local variable.) The function returns nil if there is no local variable
 -- with the given index, and raises an error when called with a `level` out
 -- of range. (You can call `debug.getinfo` to check whether the level is valid.)
 -- Variable names starting with '`(`' (open parentheses) represent internal
 -- variables (loop control variables, temporaries, and C function locals).
-function debug.getlocal(thread, level, local) end
+function debug.getlocal(thread, level, loc) end
 
 ---
 -- Returns the metatable of the given `object` or nil if it does not have
@@ -103,12 +103,12 @@ function debug.sethook(thread, hook, mask , count) end
 
 ---
 -- This function assigns the value `value` to the local variable with
--- index `local` of the function at level `level` of the stack. The function
+-- index `loc` of the function at level `level` of the stack. The function
 -- returns nil if there is no local variable with the given index, and raises
 -- an error when called with a `level` out of range. (You can call `getinfo`
 -- to check whether the level is valid.) Otherwise, it returns the name of
 -- the local variable.
-function debug.setlocal(thread, level, local, value) end
+function debug.setlocal(thread, level, loc, value) end
 
 ---
 -- Sets the metatable for the given `object` to the given `table` (which

ldoc/builtin/global.lua

@@ -85,12 +85,12 @@ function ipairs(t) end
 -- The string `mode` controls whether the chunk can be text or binary (that is, a precompiled chunk).
 -- It may be the string "b" (only binary chunks), "t" (only text chunks), or "bt" (both binary and text).
 -- The default is "bt"
-function load (ld [, source [, mode [, env]]]) end
+function load (ld , source , mode , env) end
 
 ---
 -- Similar to `load`, but gets the chunk from file `filename`. Or from the
 -- standard input, if no file name is given.
-function loadfile (filename [, mode [, env]]]) end
+function loadfile (filename , mode , env) end
 
 ---
 -- Allows a program to traverse all fields of a table. Its first argument is
@@ -180,7 +180,7 @@ function setmetatable(table, metatable) end
 -- 11, and so forth, with '`Z`' representing 35. In base 10 (the default),
 -- the number can have a decimal part, as well as an optional exponent part
 -- (see 2.1). In other bases, only unsigned integers are accepted.
-function tonumber(e [, base]) end
+function tonumber(e , base) end
 
 ---
 -- Converts any value to a string in a reasonable format.

ldoc/builtin/io.lua

@@ -3,6 +3,9 @@
 
 local io = {}
 
+-- luacheck: ignore 241
+local file = {}
+
 ---
 -- Equivalent to `file:close()`. Without a `file`, closes the default
 -- output file.

ldoc/builtin/string.lua

@@ -21,7 +21,7 @@ function string.char(...) end
 -- Returns a string containing a binary representation of the given
 -- function, so that a later `loadstring` on this string returns a copy of
 -- the function. `function` must be a Lua function without upvalues.
-function string.dump(function) end
+function string.dump(func) end
 
 ---
 -- Looks for the first match of `pattern` in the string `s`. If it finds a
@@ -174,7 +174,7 @@ function string.upper(s) end
 ---
 -- (5.3) Returns a binary string containing the values v1, v2, etc. packed (that is, serialized in binary form)
 --- according to the format string fmt (see 6.4.2).
-function string.pack (fmt, v1, v2, ···) end
+function string.pack (fmt, v1, v2, ...) end
 
 ---
 -- (5.3) Returns the size of a string resulting from string.pack with the given format.
@@ -185,7 +185,7 @@ function string.packsize (fmt) end
 -- (5.3) Returns the values packed in string s (see string.pack) according to the format string fmt (see 6.4.2).
 -- An optional pos marks where to start reading in s (default is 1)
 -- After the read values, this function also returns the index of the first unread byte in s.
-function string.unpack (fmt, s [, pos]) end
+function string.unpack (fmt, s , pos) end
 
 return string
 

ldoc/builtin/table.lua

@@ -29,7 +29,7 @@ function table.remove(table , pos) end
 ---
 -- Returns a new table with all parameters stored into keys 1, 2, etc. and with a field "n" with
 -- the total number of parameters. Note that the resulting table may not be a sequence.
-function table.pack (···) end
+function table.pack (...) end
 ---
 -- Sorts table elements in a given order,
 -- *in-place*, from `table[1]` to `table[n]`, where `n` is the length of the

ldoc/builtin/utf8.lua

@@ -25,13 +25,13 @@ function utf8.codes (s) end
 ---
 -- Returns the codepoints (as integers) from all characters in s that start between byte position i and j (both included).
 -- The default for i is 1 and for j is i. It raises an error if it meets any invalid byte sequence.
-function utf8.codepoint (s [, i [, j]]) end
+function utf8.codepoint (s , i , j) end
 
 ---
 -- Returns the number of UTF-8 characters in string s that start between positions i and j (both inclusive).
 -- The default for i is 1 and for j is -1. If it finds any invalid byte sequence, returns a false value plus
 -- the position of the first invalid byte.
-function utf8.len (s [, i [, j]]) end
+function utf8.len (s , i , j) end
 
 ---
 -- Returns the position (in bytes) where the encoding of the n-th character of s (counting from position i) starts.
@@ -43,4 +43,6 @@ function utf8.len (s [, i [, j]]) end
 -- As a special case, when n is 0 the function returns the start of the encoding of the character that contains the i-th byte of s.
 --
 -- This function assumes that s is a valid UTF-8 string.
-function utf8.offset (s, n [, i]) end
+function utf8.offset (s, n , i) end
+
+return utf8