diff --git a/includes/form.inc b/includes/form.inc
index c0e2ec7c1556098585935ecb579fd0dc203d6d73..8f2ee2632eaa8c47797229a31f51afd58e18679d 100644
--- a/includes/form.inc
+++ b/includes/form.inc
@@ -4074,6 +4074,8 @@ function _form_set_class(&$element, $class = array()) {
  * Sample 'finished' callback:
  * @code
  * function batch_test_finished($success, $results, $operations) {
+ *   // The 'success' parameter means no fatal PHP errors were detected. All
+ *   // other error management should be handled using 'results'.
  *   if ($success) {
  *     $message = format_plural(count($results), 'One post processed.', '@count posts processed.');
  *   }