File object `file_class` and `File` inconsistent

[luttje]

According to the wiki file.Open returns a file_class

On the file_class page the type name is specified as File:

<ambig page="file">You might be looking for the "file" Library, which has the same name as this class.</ambig>

<type name="File" category="classfunc" is="class">
	<summary>This is the file object. It used used primarily to read or write binary data from files.  
The default endianness is little-endian. To use big-endian you will need to provide your own functions to read and write shorts and longs.

		The object is returned by <page>file.Open</page>.
	</summary>
</type>

This causes neither type to be correct when using file.Open:

The generated library and class annotations for reference: https://github.com/luttje/glua-api-snippets/blob/lua-language-server-addon/library/file.lua

I guess this is done on the wiki because of case insensitivity, so there can't be File and file page for the class and library respectively.

Possible Solutions

What I can think of right now:

• Changing the wiki in some way (seems cumbersome)
• Adding a way to transform scraped data according to a list of exceptions/rules, in this case: replacing file_class with File
• Using the name attribute instead of the type attribute from the file.Open function wiki (not sure if that would be correct everywhere):

  <ret name="File" type="file_class">The opened file object, or `nil` if it failed to open due to it not existing or being used by another process.</ret>

[TIMONz1535]

https://wiki.facepunch.com/gmod/file.Open
https://wiki.facepunch.com/gmod/steamworks.DownloadUGC

I think you can just add an alias

---@class File
local File = {}

---@alias file_class File

so the class name corresponds to other C++ objects (in my opinion, this is better)

---

In the opposite way, you can simply change the class name, and maybe add an alias for backward compatibility (or not)

---@class file_class
local File = {}

-- optional
---@alias File file_class

and this will correspond to the wiki's argument type name and page url.

---

Entity class probably has a +- similar case with a "class change", I would like to add a parent, but perhaps these are unrelated things.

---@class Entity: Custom_Entity_Fields