Implement support for LuaJIT's table.new and table.clear #1118

[C3pa]

I used the technical descriptions from LuaJIT's official documentation.

Summary of changes:

• Added the annotations to the meta/template/table.lua
• Added the descriptions to all the locale files. All of them are in English though, so I left -- TODO: need translate! comments.
• Removed those annotations from the OpenResty library annotations.

[C3pa]

This addresses the issue #1118

[flrgh]

I have a question. So, in OpenResty libraries, it's very common to see code that does this:

-- require the `table.new` function and stash it in a local  local new_table = require "table.new" -- ...now use the local function to create a table  local my_table = new_table(0, 5)

Examples:

• lua-resty-core
• lua-resty-websocket
• lua-resty-healthcheck

Whether or not this is common elsewhere, in OpenResty it's considered idiomatic, largely because one is not relying on the side effect of modifying _G.table. This is why I originally created table.new/table.clear as standalone modules that return a function.

So my question is: with this change, will the type of new_table in the code snippet above still be detected correctly? Ideally I'd like this use-case to not be broken.

[C3pa]

Yes, the described behavior is what I had in mind. Unfortunately, I don't have the build system set up to try this.

[sumneko]

Please open a separate issue, I have no time to deal with this recently.

[sumneko]

Thank you!