platoon.lua annotation and warning fixes [lua/AI/aiutilities.lua]

[clyfordv]

Annotation and warning fixes for platoon.lua

files: aiutilities.lua

focus:

• annotation additions and fixes
• convert $type|boolean return values to $type|nil
• optional params

[relent0r]

What do the question marks mean in the annotations there @clyfordv?

[clyfordv]

Optional parameters. Most of those marked as optional here are done so implicitly (read as: I found another piece of code somewhere that calls it with a bunch of nil values).

[relent0r]

Optional parameters. Most of those marked as optional here are done so implicitly (read as: I found another piece of code somewhere that calls it with a bunch of nil values).

Ah cheers. I'll take a look at this PR once I get home from work.

[clyfordv]

Appreciate it. Happy to take any more questions or feedback, stylistic or mechanical.