AI: improved combat support:

* added support to attack battle permanents (#10246);
* fixed that AI was able to attack multiple targets by single creature (#7434);
* added docs;
* added todos with another bugs or possible problems with AI combat;

Mage/src/main/java/mage/abilities/effects/RequirementEffect.java

@@ -58,6 +58,7 @@ public abstract class RequirementEffect extends ContinuousEffectImpl {
 
     /**
      * Defines the defender a attacker has to attack
+     * TODO: WTF, it bugged, usage code need only players to attack, but effects return controller, source id, other broken data!!!
      *
      * @param source
      * @param game