release#16 - Tweak docblocks to be clear about need for explicit version declarations

CRM/Upgrade/Incremental/php/FiveThirtySeven.php

@@ -16,8 +16,8 @@ class CRM_Upgrade_Incremental_php_FiveThirtySeven extends CRM_Upgrade_Incrementa
   /**
    * Compute any messages which should be displayed beforeupgrade.
    *
-   * Note: This function is called iteratively for each upcoming
-   * revision to the database.
+   * Note: This function is called iteratively for each incremental upgrade step.
+   * There must be a concrete step (eg 'X.Y.Z.mysql.tpl' or 'upgrade_X_Y_Z()').
    *
    * @param string $preUpgradeMessage
    * @param string $rev
@@ -34,6 +34,9 @@ class CRM_Upgrade_Incremental_php_FiveThirtySeven extends CRM_Upgrade_Incrementa
   /**
    * Compute any messages which should be displayed after upgrade.
    *
+   * Note: This function is called iteratively for each incremental upgrade step.
+   * There must be a concrete step (eg 'X.Y.Z.mysql.tpl' or 'upgrade_X_Y_Z()').
+   *
    * @param string $postUpgradeMessage
    *   alterable.
    * @param string $rev

CRM/Upgrade/Incremental/php/Template.php

@@ -22,8 +22,8 @@ class CRM_Upgrade_Incremental_php_<?php echo $camelNumber; ?> extends CRM_Upgrad
   /**
    * Compute any messages which should be displayed beforeupgrade.
    *
-   * Note: This function is called iteratively for each upcoming
-   * revision to the database.
+   * Note: This function is called iteratively for each incremental upgrade step.
+   * There must be a concrete step (eg 'X.Y.Z.mysql.tpl' or 'upgrade_X_Y_Z()').
    *
    * @param string $preUpgradeMessage
    * @param string $rev
@@ -40,6 +40,9 @@ class CRM_Upgrade_Incremental_php_<?php echo $camelNumber; ?> extends CRM_Upgrad
   /**
    * Compute any messages which should be displayed after upgrade.
    *
+   * Note: This function is called iteratively for each incremental upgrade step.
+   * There must be a concrete step (eg 'X.Y.Z.mysql.tpl' or 'upgrade_X_Y_Z()').
+   *
    * @param string $postUpgradeMessage
    *   alterable.
    * @param string $rev