Unfortunately clearing all waypoints from AI is not as simple as deleting them all with `deleteWaypoint`.

You have to kill their pre-planned movement (based on old waypoints) by having them complete at least one waypoint.

One solution is to move all of their old waypoints to their position before deleting them, however if waypoint statements are being used this could have adverse effects.

So this function creates a fresh waypoint for the purpose of killing their movement. It is also self-deleting (through its completion statement) to avoid any possible issues with timing.

- Retain open building positions to make groups defending overlapping areas respect one another.
- Use new A3 scripting commands to optimise and enhance the function.
- Makes the function a lot more readable with comments and more spacing.
- Capitalize commands and function names appropriately.
- Any existing waypoints are cleared before defending begins.

- The `cycle` waypoint is placed back at the start of the loop instead of randomly within the radius.
- Any existing waypoints are cleared before the patrol loop is created.
- `_this` is now correctly private.

- Any existing waypoints are now cleared before the searching begins.
- The recursive argument check is now more explicit.

- Now callable (by including the spawn within the function).
- Accounts for units being killed while searching and dispatches all available units to search simultaneously.
- Doesn't permanently change behaviour of the group if the function aborts due to building distance.
- Optimized with new A3 commands and made more readable with comments and spacing.

Commented out the part that isn't easily regex replaced so that it can be uncommented in future.

In actuality this is something of a compromise.

Having the leader enter the building was not an intentional change I made. However it makes sense to do things that way when the group is small and so for any group with 2 or less units (includes the leader) the leader will now search the building too.

Accounts for cases where the leader enters the building.

- The group leader (and any spare units) will now wait at his current position for the search to be complete before moving on.
- Waiting between orders instead of between rounds of orders should prevent congestion and decrease time gaps in the search.
- Embedding the post-search code into the waypoint condition and completion removes the need to `waitUntil` while also providing built in group unit list `thisList`.

If a waypoint was created at index 0 before the group complete the waypoint used to reset their path, then the wrong waypoint would be deleted upon its completion.