Deprecate 'function' keyword about ags HOT 4 OPEN

I guess I'll go check the manual for old examples with function.

EDIT: There are are 147 references, of which most are event handlers.
Do we want to start steering users away from function right now? If so, I could start with references that aren't event handlers, since those are still created as function xxx() by the editor and writing them differently in the manual could be confusing, unless we're also planning to update 3.x soon to discourage the legacy keyword.

from ags.

About ags3 , check #1331 (comment)

I think void in ags3 is actually int for compatibility because some old games returned something in a void function and it was kept to avoid breaking old games.

from ags.

Yes, I thought so. That's part of why I think AGS 4.0 is a good opportunity to fix it.

from ags.

I think void in ags3 is actually int for compatibility because some old games returned something in a void function and it was kept to avoid breaking old games.

To clarify, today void is a valid keyword in compiler and not an int alias, but the engine "secretly" still returns a integer '0' from the functions of void type. This is done because old API was not declared as void but as function, even though it did not return anything meaningful, and unfortunately some users have used this return value by mistake.

from ags.