AI macros: update comments for display on wiki reference page

This is for the auto-generated page at
http://www.wesnoth.org/macro-reference.html