diff --git a/scripts/ai/API b/scripts/ai/API
index 787e107..04e8fe5 100644
--- a/scripts/ai/API
+++ b/scripts/ai/API
@@ -53,7 +53,7 @@ minbrakedist()
   -- Returns the minimum required braking distance assuming all goes well.
     -- return number distance needed to brake.
 
-armor()
+armor([number pilot])
   -- Returns the total amount of armor left.
 
 shield()
@@ -61,9 +61,11 @@ shield()
 
 parmor()
   -- Returns the percentage of armor remaining.
+    -- pilot - Optional pilot id, if not the current pilot is used.
 
 pshield()
   -- Returns the percentage of shield remaining.
+    -- pilot - Optional pilot id, if not the current pilot is used.
 
 // ================
 // BOOLEAN!