Added overload and rest arguments section

[MrcSnm]

Added function overload
Added function rest arguments

[Geokureli]

Everyone in the haxe discords is losing their shit because no one knew these were possible. Why was this not documented?

[RealyUniqueName]

Rest arguments section needs a link to or at least a mention of haxe.Rest API

[MrcSnm]

Rest arguments section needs a link to or at least a mention of haxe.Rest API

I added that and a notice that it is also possible to use spread operator too.

[RealyUniqueName]

@Simn is that enough for overloading?

[Simn]

No, this needs a more elaborate introduction to clarify that we don't support full overloads and such things. The documentation for this has to be approached differently, so I suggest that we split up the PR accordingly.

[MrcSnm]

No, this needs a more elaborate introduction to clarify that we don't support full overloads and such things. The documentation for this has to be approached differently, so I suggest that we split up the PR accordingly.

I would split that PR if it is accepted for the rest arguments.

That apart, I think having to extern inline overload ( and that has bits of explanation about what each keyword is doing ) pretty surely means that overload is not fully supported.