Wrap function argument returns with parentheses

[TIMONz1535]

CHG return names and parentheses can be used in DocFunction

---@type fun():(x: number, y: number, ...: number)

for example, here
https://wiki.facepunch.com/gmod/sound.Generate
now its function param with number|table return value

---@param callbackOrData fun(sampleIndex: number): number|table

should become function|table param also with return value name

---@param callbackOrData fun(sampleIndex: number):(sampleValue: number)|table

https://wiki.facepunch.com/gmod/spawnmenu.GetContentType
duplicated second return from first return fun

---@return fun(container: Panel, data: table): Panel # The panel creation function.
--- ....
--- Function return value(s):
--- * Panel `pnl` - The created panel
---@return Panel # The created panel

[luttje]

@all-contributors please add @TIMONz1535 for ideas, bug

[allcontributors]

@luttje

I've put up a pull request to add @TIMONz1535! 🎉

[TIMONz1535]

I see a smol issue with a Player:AddPlayerOption
The other similar functions looks ok.

The parameter name is empty string on the wiki <ret name="" type="boolean">, but the wiki shows it as ret1 :<

glua-api-snippets/library/player.lua

Lines 209 to 215 in f010d98

	---@param vote_callback fun(voteNum: number):(boolean: boolean) The function to be run when the player presses 0-9 while a vote is active.
	---
	--- Function argument(s):
	--- * number `voteNum` - Which option the player pressed, 1-9 and 0 being the very last option.
	---
	--- Function return value(s):
	--- * boolean `` - Return true to remove this option from the vote.

there is (boolean: boolean) and --- * boolean `` (empty name)
maybe should be (ret1: boolean) and --- * boolean `ret1` as wiki shows
or we will write a warning that we can't do that, wtf

also last version tag is v0000 instead of v0009